awslabs / aidlc-workflows

awslabs / aidlc-workflows

AI-DLC (AI-Driven Development Life Cycle) 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 (人工智能驱动的开发生命周期) 重要提示

生成式 AI 可能会出错。您应考虑审查所选 AI 模型和智能编码助手生成的所有输出内容及相关成本。请参阅《AWS 负责任的 AI 政策》。AI-DLC 是一种智能软件开发工作流,它能够适应您的需求、维持质量标准,并让您始终掌控开发过程。如需了解更多关于 AI-DLC 方法论的信息,请阅读此博客以及其中引用的《方法定义论文》。


Table of Contents

Common, Platform-Specific Setup, Usage, Three-Phase Adaptive Workflow, Key Features, Extensions, Tenets, Prerequisites, Troubleshooting, Version Control Recommendations, Additional Resources, Generated aidlc-docs/, Reference, Experimental: AI-Assisted Setup (Release Download), Contributing, License.

目录

通用说明、平台特定设置、使用方法、三阶段自适应工作流、关键特性、扩展、原则、先决条件、故障排除、版本控制建议、其他资源、生成的 aidlc-docs/、参考资料、实验性功能:AI 辅助设置(发布下载)、贡献指南、许可证。


Common

Download the latest release zip file named ai-dlc-rules-v<release-number>.zip from the Releases page to a folder outside your project directory (e.g., ~/Downloads). Extract the zip. It contains an aidlc-rules/ folder with two subdirectories:

  • aws-aidlc-rules/ — the core AI-DLC workflow rules
  • aws-aidlc-rule-details/ — detailed rules conditionally referenced by the core rules

Follow the setup instructions for your coding agent and platform below.

通用说明

从 Releases 页面下载名为 ai-dlc-rules-v<release-number>.zip 的最新发布压缩包,并将其保存到项目目录之外的文件夹中(例如 ~/Downloads)。解压该压缩包,其中包含一个 aidlc-rules/ 文件夹,内含两个子目录:

  • aws-aidlc-rules/ — 核心 AI-DLC 工作流规则
  • aws-aidlc-rule-details/ — 由核心规则按需引用的详细规则

请按照下方针对您的编码助手和平台对应的设置说明进行操作。


Platform-Specific Setup

Kiro, Amazon Q Developer IDE Plugin, Cursor IDE, Cline, Claude Code, GitHub Copilot, OpenAI Codex, Other Agents.

平台特定设置

Kiro、Amazon Q Developer IDE 插件、Cursor IDE、Cline、Claude Code、GitHub Copilot、OpenAI Codex、其他智能体。


Kiro

AI-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.

Kiro

AI-DLC 在您的项目工作区中使用 Kiro Steering Files(引导文件)。以下命令假设您已将压缩包解压至 Downloads 文件夹。如果您使用了其他位置,请将 Downloads 替换为您实际的文件夹路径。

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 /I

Your project should look like:

<project-root>/
├── .kiro/
│   ├── steering/
│   │   ├── aws-aidlc-rules/
│   ├── aws-aidlc-rule-details/

您的项目结构应如下所示:

<project-root>/
├── .kiro/
│   ├── steering/
│   │   ├── aws-aidlc-rules/
│   ├── aws-aidlc-rule-details/

To verify the rules are loaded: Verify in Kiro IDE: 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.

Verify in Kiro CLI: Run kiro-cli, then /context show, and confirm entries for .kiro/steering/aws-aidlc-rules.

验证规则是否已加载: 在 Kiro IDE 中验证: 打开 steering files 面板,确认在 Workspace 下方能看到 core-workflow 条目(如下图所示)。我们使用 Vibe 模式下的 Kiro IDE 来运行 AI-DLC 工作流,这能确保 AI-DLC 工作流引导 Kiro 中的开发流程。有时,Kiro 可能会提示您切换到 spec 模式,请选择 No 以保持在 Vibe 模式。

在 Kiro CLI 中验证: 运行 kiro-cli,然后输入 /context show,确认其中包含 .kiro/steering/aws-aidlc-rules 的条目。