awslabs / aidlc-workflows
- суббота, 9 мая 2026 г. в 00:00:04
AI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents
Important
Generative AI can make mistakes. You should consider reviewing all output and costs generated by your chosen AI model and agentic coding assistant. See AWS Responsible AI Policy.
AI-DLC is an intelligent software development workflow that adapts to your needs, maintains quality standards, and keeps you in control of the process. For learning more about AI-DLC Methodology, read this blog and the Method Definition Paper referred in it.
ai-dlc-rules-v<release-number>.zip from the Releases page to a folder outside your project directory (e.g., ~/Downloads).aidlc-rules/ folder with two subdirectories:
aws-aidlc-rules/ — the core AI-DLC workflow rulesaws-aidlc-rule-details/ — detailed rules conditionally referenced by the core rulesAI-DLC uses Kiro Steering Files within your project workspace.
The commands below assume you extracted the zip to your Downloads folder. If you used a different location, replace Downloads with your actual folder path.
On macOS/Linux:
mkdir -p .kiro/steering
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rules .kiro/steering/
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details .kiro/On Windows (PowerShell):
New-Item -ItemType Directory -Force -Path ".kiro\steering"
Copy-Item -Recurse "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules" ".kiro\steering\"
Copy-Item -Recurse "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details" ".kiro\"On Windows (CMD):
mkdir .kiro\steering
xcopy %USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules .kiro\steering\aws-aidlc-rules\ /E /I
xcopy %USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details .kiro\aws-aidlc-rule-details\ /E /IYour project should look like:
<project-root>/
├── .kiro/
│ ├── steering/
│ │ ├── aws-aidlc-rules/
│ ├── aws-aidlc-rule-details/
To verify the rules are loaded:
Open the steering files panel and confirm you see an entry for core-workflow under Workspace as shown in the screenshot below.
We use Kiro IDE in Vibe mode to run the AI-DLC workflow. This ensures that AI-DLC workflow guides the development workflow in Kiro. At times, Kiro may nudge you to switch to spec mode. Select No to such prompts to stay in Vibe mode.
Run kiro-cli, then /context show, and confirm entries for .kiro/steering/aws-aidlc-rules.
AI-DLC uses Amazon Q Rules within your project workspace.
The commands below assume you extracted the zip to your Downloads folder. If you used a different location, replace Downloads with your actual folder path.
On macOS/Linux:
mkdir -p .amazonq/rules
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rules .amazonq/rules/
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details .amazonq/On Windows (PowerShell):
New-Item -ItemType Directory -Force -Path ".amazonq\rules"
Copy-Item -Recurse "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules" ".amazonq\rules\"
Copy-Item -Recurse "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details" ".amazonq\"On Windows (CMD):
mkdir .amazonq\rules
xcopy %USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules .amazonq\rules\aws-aidlc-rules\ /E /I
xcopy %USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details .amazonq\aws-aidlc-rule-details\ /E /IYour project should look like:
<project-root>/
├── .amazonq/
│ ├── rules/
│ │ ├── aws-aidlc-rules/
│ ├── aws-aidlc-rule-details/
To verify the rules are loaded:
Rules button in the lower right corner..amazonq/rules/aws-aidlc-rules.AI-DLC uses Cursor Rules to implement its intelligent workflow.
The commands below assume you extracted the zip to your Downloads folder. If you used a different location, replace Downloads with your actual folder path.
Unix/Linux/macOS:
mkdir -p .cursor/rules
cat > .cursor/rules/ai-dlc-workflow.mdc << 'EOF'
---
description: "AI-DLC (AI-Driven Development Life Cycle) adaptive workflow for software development"
alwaysApply: true
---
EOF
cat ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md >> .cursor/rules/ai-dlc-workflow.mdc
mkdir -p .aidlc-rule-details
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/Windows PowerShell:
New-Item -ItemType Directory -Force -Path ".cursor\rules"
$frontmatter = @"
---
description: "AI-DLC (AI-Driven Development Life Cycle) adaptive workflow for software development"
alwaysApply: true
---
"@
$frontmatter | Out-File -FilePath ".cursor\rules\ai-dlc-workflow.mdc" -Encoding utf8
Get-Content "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" | Add-Content ".cursor\rules\ai-dlc-workflow.mdc"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -RecurseWindows CMD:
mkdir .cursor\rules
(
echo ---
echo description: "AI-DLC (AI-Driven Development Life Cycle) adaptive workflow for software development"
echo alwaysApply: true
echo ---
echo.
) > .cursor\rules\ai-dlc-workflow.mdc
type "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" >> .cursor\rules\ai-dlc-workflow.mdc
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /IUnix/Linux/macOS:
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md ./AGENTS.md
mkdir -p .aidlc-rule-details
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/Windows PowerShell:
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -RecurseWindows CMD:
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md"
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /IVerify Setup:
ai-dlc-workflow listedAGENTS.md, it will be automatically detected and appliedDirectory Structure (Option 1):
<my-project>/
├── .cursor/
│ └── rules/
│ └── ai-dlc-workflow.mdc
└── .aidlc-rule-details/
├── common/
├── inception/
├── construction/
├── extensions/
└── operations/
AI-DLC uses Cline Rules to implement its intelligent workflow.
The commands below assume you extracted the zip to your Downloads folder. If you used a different location, replace Downloads with your actual folder path.
Unix/Linux/macOS:
mkdir -p .clinerules
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md .clinerules/
mkdir -p .aidlc-rule-details
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/Windows PowerShell:
New-Item -ItemType Directory -Force -Path ".clinerules"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".clinerules\"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -RecurseWindows CMD:
mkdir .clinerules
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".clinerules\"
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /IUnix/Linux/macOS:
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md ./AGENTS.md
mkdir -p .aidlc-rule-details
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/Windows PowerShell:
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -RecurseWindows CMD:
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md"
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /IVerify Setup:
core-workflow.md is listed and activeDirectory Structure (Option 1):
<my-project>/
├── .clinerules/
│ └── core-workflow.md
└── .aidlc-rule-details/
├── common/
├── inception/
├── construction/
├── extensions/
└── operations/
AI-DLC uses Claude Code's project memory file (CLAUDE.md) to implement its intelligent workflow.
The commands below assume you extracted the zip to your Downloads folder. If you used a different location, replace Downloads with your actual folder path.
Unix/Linux/macOS:
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md ./CLAUDE.md
mkdir -p .aidlc-rule-details
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/Windows PowerShell:
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\CLAUDE.md"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -RecurseWindows CMD:
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\CLAUDE.md"
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /IUnix/Linux/macOS:
mkdir -p .claude
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md .claude/CLAUDE.md
mkdir -p .aidlc-rule-details
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/Windows PowerShell:
New-Item -ItemType Directory -Force -Path ".claude"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".claude\CLAUDE.md"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -RecurseWindows CMD:
mkdir .claude
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".claude\CLAUDE.md"
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /IVerify Setup:
claude or VS Code extension)/config command to view current configurationDirectory Structure (Option 1):
<my-project>/
├── CLAUDE.md
└── .aidlc-rule-details/
├── common/
├── inception/
├── construction/
├── extensions/
└── operations/
AI-DLC uses GitHub Copilot custom instructions to implement its intelligent workflow. The .github/copilot-instructions.md file is automatically detected and applied to all chat requests in the workspace.
The commands below assume you extracted the zip to your Downloads folder. If you used a different location, replace Downloads with your actual folder path.
Unix/Linux/macOS:
mkdir -p .github
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md .github/copilot-instructions.md
mkdir -p .aidlc-rule-details
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/Windows PowerShell:
New-Item -ItemType Directory -Force -Path ".github"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".github\copilot-instructions.md"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -RecurseWindows CMD:
mkdir .github
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".github\copilot-instructions.md"
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /IVerify Setup:
copilot-instructions is listed/instructions in the chat input to view active instructionsDirectory Structure:
<my-project>/
├── .github/
│ └── copilot-instructions.md
└── .aidlc-rule-details/
├── common/
├── inception/
├── construction/
├── extensions/
└── operations/
AI-DLC supports OpenAI Codex as a supported coding agent, using the Codex AGENTS.md convention to deliver its intelligent workflow. Codex automatically discovers and loads AGENTS.md from your project root when you start a session.
The commands below assume you extracted the zip to your Downloads folder. If you used a different location, replace Downloads with your actual folder path.
Unix/Linux/macOS:
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md ./AGENTS.md
mkdir -p .aidlc-rule-details
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/Windows PowerShell:
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -RecurseWindows CMD:
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md"
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /IVerify Setup:
Note
The AGENTS.md file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting project_doc_max_bytes in your config.toml file):
project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your projectDirectory Structure:
<my-project>/
├── AGENTS.md
└── .aidlc-rule-details/
├── common/
├── inception/
├── construction/
├── extensions/
└── operations/
AI-DLC works with any coding agent that supports project-level rules or steering files. The general approach:
aws-aidlc-rules/ wherever your agent reads project rules from (consult your agent's documentation).aws-aidlc-rule-details/ at a sibling level so the rules can reference it.If your agent has no convention for rules files, place both folders at your project root and point the agent to aws-aidlc-rules/ as its rules directory.
aidlc-docs/ directoryAI-DLC follows a structured three-phase approach that adapts to your project's complexity:
Determines WHAT to build and WHY
Determines HOW to build it
Deployment and monitoring (future)
| Feature | Description |
|---|---|
| Adaptive Intelligence | Only executes stages that add value to your specific request |
| Context-Aware | Analyzes existing codebase and complexity requirements |
| Risk-Based | Complex changes get comprehensive treatment, simple changes stay efficient |
| Question-Driven | Structured multiple-choice questions in files, not chat |
| Always in Control | Review execution plans and approve each phase |
| Extensible | Layer custom rules e.g. security, compliance, and organization-specific rules on top of the core workflow |
AI-DLC supports an extension system that lets you layer additional rules on top of the core workflow. Extensions are markdown files organized under aws-aidlc-rule-details/extensions/ and grouped by category (e.g., security/, testing/).
Each extension consists of two files placed in the same directory:
security-baseline.md) containing the extension's rules.security-baseline.opt-in.md) containing a structured multiple-choice question presented to the user during Requirements Analysis.At workflow start, AI-DLC scans the extensions/ directory and loads only *.opt-in.md files. During Requirements Analysis, it presents each opt-in prompt to the user. When the user opts in, the corresponding rules file is loaded (derived by naming convention: strip .opt-in.md, append .md). When the user opts out, the rules file is never loaded. Extensions without a matching *.opt-in.md file are always enforced.
Once enabled, extension rules are blocking constraints — at each stage, the model verifies compliance before allowing the stage to proceed.
The extensions/ directory ships with the following (new extensions may be added over time):
aws-aidlc-rule-details/
└── extensions/
├── security/ # Extension category
│ └── baseline/
│ ├── security-baseline.md # Baseline security rules
│ └── security-baseline.opt-in.md # Opt-in prompt
└── testing/ # Extension category
└── property-based/
├── property-based-testing.md # Property-based testing rules
└── property-based-testing.opt-in.md # Opt-in prompt
Important
The security extension rules are provided as a directional reference for building effective security rules within AI-DLC workflows. Each organization should build, customize, and thoroughly test their own security rules before deploying in production workflows.
You can extend an existing category or create an entirely new one.
extensions/ (e.g., security/compliance/ or performance/baseline/).compliance.md). Follow the same structure as security-baseline.md:
## Rule <PREFIX-NN>: <Title> where the prefix is a short category identifier and NN is a sequential number (e.g., COMPLIANCE-01, COMPLIANCE-02). These IDs are referenced in audit logs and compliance summaries, so they must be unique across all loaded extensions.<name>.opt-in.md (e.g., compliance.opt-in.md). See security-baseline.opt-in.md for the expected format. Omitting this file means the extension is always enforced with no user opt-out.These are our core principles to guide our decision making.
No duplication. The source of truth lives in one place. If we add support for new tools or formats that require specific files, we generate them from the source rather than maintaining separate copies.
Methodology first. AI-DLC is fundamentally a methodology, not a tool. Users shouldn't need to install anything to get started. That said, we're open to convenience tooling (scripts, CLIs) down the road if it helps users adopt or extend the methodology.
Reproducible. Rules should be clear enough that different models produce similar outcomes. We know models behave differently, but the methodology should minimize variance through explicit guidance.
Agnostic. The methodology works with any IDE, agent, or model. We don't tie ourselves to specific tools or vendors.
Human in the loop. Critical decisions require explicit user confirmation. The agent proposes, the human approves.
Have one of our supported platforms/tools for Assisted AI Coding installed:
| Platform | Installation Link |
|---|---|
| Kiro | Install |
| Kiro CLI | Install |
| Amazon Q Developer IDE Plugin | Install |
| Cursor IDE | Install |
| Cline VS Code Extension | Install |
| Claude Code CLI | Install |
| GitHub Copilot | Install + Chat |
| Problem | Solution |
|---|---|
| Rules not loading | Check file exists in the correct location for your platform |
| File encoding issues | Ensure files are UTF-8 encoded |
| Rules not applied in session | Start a new chat session after file changes |
| Rule details not loading | Verify .aidlc-rule-details/ exists with subdirectories |
/context show in Kiro CLI to verify rules are loaded.kiro/steering/ directory structureaws-aidlc-rule-details (not .aidlc-rule-details/) under the .kiro/ directory.amazonq/rules/ directory structureaws-aidlc-rule-details (not .aidlc-rule-details/) under the .amazonq/ directory/config command to view current configuration/instructions in the chat input to view active instruction files.github/copilot-instructions.md exists in your workspace root/ in file paths within markdown filesCommit to repository:
# These should be version controlled
CLAUDE.md
AGENTS.md
.amazonq/rules/
.amazonq/aws-aidlc-rule-details/
.kiro/steering/
.kiro/aws-aidlc-rule-details/
.cursor/rules/
.clinerules/
.github/copilot-instructions.md
.aidlc-rule-details/Optional - Add to .gitignore (if needed):
# Local-only settings
.claude/settings.local.jsonFor the complete reference of all documentation artifacts generated by the AI-DLC workflow, see docs/GENERATED_DOCS_REFERENCE.md.
Instead of manually copying files, let your AI agent handle the setup. This is an experimental workflow — currently validated with Kiro, Claude code, Cursor, Antigravity.
Note: This approach requires your agent to have shell access (e.g., Kiro, Claude Code, Cline). For agents without shell access, follow the Common setup above.
Paste this prompt into your AI agent:
Set up AI-DLC in this project by doing the following:
1. Download the latest AI-DLC release:
- Use the GitHub API to find the latest release asset URL:
curl -sL https://api.github.com/repos/awslabs/aidlc-workflows/releases/latest \
| grep -o '"browser_download_url": *"[^"]*"' \
| head -1 \
| cut -d'"' -f4
- Download the zip from that URL to /tmp/aidlc-rules.zip
- Extract it: unzip -o /tmp/aidlc-rules.zip -d /tmp/aidlc-release
- Copy the aidlc-rules/ folder from the extracted contents into .aidlc at the project root
- Clean up: rm -rf /tmp/aidlc-rules.zip /tmp/aidlc-release
2. Create the appropriate rules/steering file for your IDE using the options below.
Pick the one that matches the agent you are running in:
- Kiro IDE or Kiro CLI → create `.kiro/steering/ai-dlc.md`
- Amazon Q Developer → create `.amazonq/rules/ai-dlc.md`
- Antigravity → create `.agent/rules/ai-dlc.md`
- Cursor → create `.cursor/rules/ai-dlc.mdc` with frontmatter:
---
description: "AI-DLC workflow"
alwaysApply: true
---
- Cline → create `.clinerules/ai-dlc.md`
- Claude Code → create `CLAUDE.md`
- GitHub Copilot → create `.github/copilot-instructions.md`
- Any other agent → create `AGENTS.md`
3. The file content should be:
When the user invokes AI-DLC, read and follow
`.aidlc/aidlc-rules/aws-aidlc-rules/core-workflow.md` to start the workflow.
4. Add `.aidlc` to `.gitignore` unless I explicitly ask you not to.
5. Confirm what file you created and that `.aidlc` is gitignored.
The agent will download the latest release, create the correct config file for your IDE, and gitignore the .aidlc directory automatically.
Updating AI-DLC — Re-run the prompt above. The agent will download the latest release and overwrite the existing .aidlc/ folder.
| Resource | Link |
|---|---|
| AI-DLC Method Definition Paper | Paper |
| AI-DLC Methodology Blog | AWS Blog |
| AI-DLC Open-source Launch Blog | AWS Blog |
| AI-DLC Example Walkthrough Blog | AWS Blog |
| Amazon Q Developer Documentation | Docs |
| Kiro CLI Documentation | Docs |
| Cursor Rules Documentation | Docs |
| Claude Code Documentation | GitHub |
| GitHub Copilot Documentation | Docs |
| Working with AI-DLC (interaction patterns and tips) | docs/WORKING-WITH-AIDLC.md |
| Contributing Guidelines | CONTRIBUTING.md |
| Code of Conduct | CODE_OF_CONDUCT.md |
See CONTRIBUTING for more information.
This library is licensed under the MIT-0 License. See the LICENSE file.