awslabs/aidlc-workflows
요약
AI-DLC(Artificial Intelligence - Development Lifecycle Control)는 사용자의 요구에 맞춰 적응하며 품질 기준을 유지하고 개발 프로세스를 통제하는 지능형 소프트웨어 개발 워크플로우입니다. 이 가이드는 AI-DLC 규칙 세트를 로컬 프로젝트 환경에 설정하는 구체적인 방법을 안내합니다. 사용자들은 Kiro IDE나 Amazon Q Developer와 같은 코딩 에이전트 및 플랫폼 설정을 통해 AI-DLC를 통합하여, 생성형 AI의 잠재적 오류를 관리하고 개발 과정을 체계적으로 관리할 수 있습니다.
핵심 포인트
- AI-DLC는 적응형 워크플로우로, 품질 기준 유지 및 프로세스 통제를 목표로 합니다.
- 규칙 세트는 `aws-aidlc-rules`와 `aws-aidlc-rule-details` 두 부분으로 구성되어 있으며, 프로젝트 외부 폴더에 다운로드 후 배치해야 합니다.
- 설정 과정은 Kiro IDE의 `.kiro/steering` 디렉토리 또는 Amazon Q의 `.amazonq/rules` 디렉토리에 규칙을 복사하는 명령줄(CLI) 작업을 포함합니다.
- AI-DLC는 코딩 에이전트(예: GitHub Copilot, Claude Code 등)와 통합되어 개발 워크플로우를 안내하며, 사용자는 생성형 AI 출력 및 비용 검토에 주의해야 합니다.
중요
생성형 AI 는 실수를 할 수 있습니다. 선택한 AI 모델과 에이전트 코딩 어시스턴트로 생성된 모든 출력 및 비용을 검토할 것을 고려하세요. AWS 책임 있는 AI 정책을 참조하세요.
AI-DLC 는 사용자의 필요에 맞게 적응하며, 품질 기준을 유지하고 프로세스를 통제하게 해주는 지능형 소프트웨어 개발 워크플로우입니다. AI-DLC 방법론에 대해 더 배우려면 이 블로그와 해당 문서에서 언급된 방법 정의 논문을 읽어보세요.
- 공통
- 플랫폼 특화 설정
- 사용법
- 3 단계 적응형 워크플로우
- 주요 기능
- 확장성
- 원칙
- 전제 조건
- 문제 해결
- 버전 관리 권장 사항
- 추가 자료
- 생성된 aidlc-docs/ 참조
- 실험: AI 보조 설정 (릴리스 다운로드)
- 기여
- 라이선스
ai-dlc-rules-v<release-number>.zip
이름으로 된 최신 릴리스 zip 파일을 Releases 페이지에서 프로젝트 디렉터리 외부(예:~/Downloads) 폴더로 다운로드하세요.
-
zip 파일을 추출합니다.
aidlc-rules/
폴더가 있으며 두 개의 하위 디렉터리가 있습니다:
aws-aidlc-rules/
— 핵심 AI-DLC 워크플로우 규칙
aws-aidlc-rule-details/
— 핵심 규칙에 조건부 참조된 상세 규칙 -
아래 코딩 에이전트 및 플랫폼 설정 지침을 따르세요.
-
Kiro
-
Amazon Q Developer IDE 플러그인
-
Cursor IDE
-
Cline
-
Claude Code
-
GitHub Copilot
-
OpenAI Codex
-
기타 에이전트
AI-DLC 는 프로젝트 워크스페이스 내의 Kiro Steering Files 를 사용합니다.
아래 명령은 zip 파일을 Downloads 폴더에 추출했다고 가정합니다. 다른 위치를 사용했다면, Downloads 를 실제 폴더 경로로 교체하세요.
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/
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\"
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
프로젝트는 다음과 같이 보일 것입니다:
<project-root>/
├── .kiro/
│ ├── steering/
...
규칙이 로드되었는지 확인하려면:
Steering files 패널을 열고 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 /I
Your project should look like:
<project-root>/
├── .amazonq/
│ ├── rules/
...
To verify the rules are loaded:
- In the Amazon Q Chat window, click the
`Rules`
button in the lower right corner. - Confirm you see entries for
`.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'
...
**Windows PowerShell:**
New-Item -ItemType Directory -Force -Path ".cursor\rules"
$frontmatter = @"
...
**Windows CMD:**
mkdir .cursor\rules
(
echo ---
...
**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" -Recurse
Windows 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 /I
Verify Setup:
- Open
Cursor Settings → Rules, Commands - Under
Project Rules, you should seeai-dlc-workflow
listed - For
AGENTS.md, it will be automatically detected and applied
Directory Structure (Option 1):
├── .cursor/
│ └── rules/
...
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:
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md .clinerules/
mkdir -p .aidlc-rule-details
...
Windows PowerShell:
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".clinerules\"
New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
...
Windows CMD:
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".clinerules\"
mkdir .aidlc-rule-details
...
Unix/Linux/macOS:
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 ".aidlc-rule-details"
Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -Recurse
Windows CMD:
mkdir .aidlc-rule-details
xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /I
Verify Setup:
- Cline 채팅 인터페이스에서 채팅 입력 필드 아래에 Rules popover 을 찾아보세요
- 다음 파일이 목록에 포함되어 활성화되어 있는지 확인하세요:
core-workflow.md
- 필요시 규칙 파일을 켜고 끄기 (toggle) 가 가능합니다.
디렉토리 구조 (옵션 1):
├── .clinerules/
│ └── core-workflow.md
...
AI-DLC 는 프로젝트 메모리 파일인 CLAUDE.md 를 사용하여 지능형 워크플로우를 구현합니다.
아래 명령어는 zip 파일을 Downloads 폴더에 추출한 것으로 가정합니다. 다른 위치를 사용했다면 Downloads 를 실제 폴더 경로로 변경하세요.
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\" -Recurse
Windows 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 /I
Unix/Linux/macOS:
mkdir -p .claude
cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md .claude/CLAUDE.md
mkdir -p .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"
...
Windows CMD:
mkdir .claude
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".claude\CLAUDE.md"
mkdir .aidlc-rule-details
...
설치 확인:
- 프로젝트 디렉토리에 Claude Code 를 시작하세요 (CLI:
claude또는 VS Code 확장 프로그램) - 현재 설정을 보기 위해/config명령어를 사용하세요. Claude 에 "이 프로젝트에서 현재 활성화된 지침은 무엇입니까?"라고 물어보세요.
디렉토리 구조 (옵션 1):
├── CLAUDE.md
└── .aidlc-rule-details/
...
AI-DLC 는 GitHub Copilot 커스텀 지침을 사용하여 지능형 워크플로우를 구현합니다. .github/copilot-instructions.md 파일은 자동으로 감지되어 워크스페이스의 모든 채팅 요청에 적용됩니다.
아래 명령어는 zip 파일을 Downloads 폴더에 추출한 것으로 가정합니다. 다른 위치를 사용했다면, Downloads 를 실제 폴더 경로로 교체하세요.
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
...
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"
...
Windows CMD:
mkdir .github
copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".github\copilot-instructions.md"
mkdir .aidlc-rule-details
...
설치 확인:
- 프로젝트 폴더를 VS Code 로 엽니다.
- Copilot Chat 패널을 엽니다 (Cmd/Ctrl+Shift+I)
- Configure Chat(기어 아이콘) > Chat Instructions를 선택하여
copilot-instructions가 목록에 있는지 확인하세요. - 대안으로 채팅 입력창에/instructions를 입력하여 활성화된 지침을 확인합니다.
디렉토리 구조:
<my-project>/
├── .github/
│ └── copilot-instructions.md
...
AI-DLC 는 Codex AGENTS.md 관례를 사용하여 코딩 에이전트로서 OpenAI Codex 를 지원합니다. 세션을 시작할 때 Codex 는 자동으로 프로젝트 루트에서 AGENTS.md 파일을 발견하고 로드합니다.
아래 명령어는 zip 파일을 Downloads 폴더에 추출한 것으로 가정합니다. 다른 위치를 사용했다면, Downloads 를 실제 폴더 경로로 교체하세요.
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\" -Recurse
Windows 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 /I
설치 확인:
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Trending Python (daily)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기