설치와 프로젝트 준비

AI-DLC를 설치하고, 새 실습 폴더를 aidlc config --harness claude 로 Claude Code에 연결한 뒤 aidlc doctor 로 점검합니다. 폴더에 깔리는 에이전트·훅·기억 파일이 무엇인지 봅니다.

무엇을 · 왜#

AI-DLC는 특정 도구에 종속되지 않는 엔진(aidlc 명령)과 각 도구를 연결하는 하네스로 구성됩니다. 같은 엔진이 Claude Code, Kiro, Codex CLI, Cursor, opencode, GitHub Copilot에서 동작합니다. aidlc config --harness claude는 이 폴더에 Claude Code용 하네스를 설치하는 명령입니다. 설치되는 항목은 세 가지입니다.

대화가 길어지면 에이전트가 앞의 지시를 잊기 쉽습니다. AI-DLC는 지시를 대화뿐 아니라 파일에도 저장합니다. 도구를 호출할 때마다 훅이 현재 단계의 규칙과 기억 파일을 다시 넣어 줍니다. 진행 상태도 파일에 남으므로 /compact로 대화를 줄여도 단계가 사라지지 않습니다.

따라 하기#

1. 설치. macOS·Linux·WSL에서는 공식 설치 스크립트 한 줄로 설치합니다. Bun이나 Node.js 없이 aidlc 명령 하나가 설치됩니다. 기본 설치 위치는 ~/.local/bin이고, AIDLC_BIN_DIR·AIDLC_INSTALL_ROOT로 바꿀 수 있습니다.

   curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | sh
   aidlc --version && claude --version
   # aidlc 2.11.2 (runtime 2.11.2)
   # 2.1.318 (Claude Code)
   

   Windows PowerShell의 설치 명령은 irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex입니다.
2. 실습 폴더와 git. 빈 폴더를 만들고 git 저장소로 초기화합니다. AI-DLC의 작업 기록은 git으로 팀과 공유하는 것을 전제로 합니다.

   mkdir aidlc-voice-parking && cd aidlc-voice-parking && git init
   

3. Claude Code에 연결. aidlc config --harness claude를 실행하고 모든 항목에서 기본값을 선택합니다. MCP 서버는 끕니다(MCP [2]). 비어 있는 두 항목을 지금 채울지 묻는 질문에는 Enter를 누릅니다. 설정은 프로젝트에 기록하고, 모델 정책과 제공자는 현재 Claude Code 설정을 유지합니다.

   

4. 점검. aidlc doctor가 실행 환경, 프로젝트, 프레임워크 무결성을 차례로 점검합니다. 이번 실행 결과는 0 problems, 4 warnings였습니다. 경고는 "아직 첫 대화를 하지 않아 훅이 실행된 적이 없다", "새 버전 2.11.3이 있다", "작업 기록이 아직 커밋되지 않았다" 같은 참고 사항입니다.

   

5. 설치된 항목 둘러보기. 에이전트 목록과 훅, 기억 파일을 확인합니다.

   ls .claude/agents
   grep -o 'aidlc engine hook [a-z-]*' .claude/settings.json | sort -u
   find aidlc -name "*.md" | sort
   

   

녹화 환경에서 바꾼 것#

• 녹화할 때는 사용자 홈을 변경하지 않으려고 설치 위치를 실습 자료 폴더로 바꿔 두었습니다(AIDLC_INSTALL_ROOT, AIDLC_BIN_DIR). 실습할 때는 기본 위치를 그대로 사용하면 됩니다.
• 설치 장면은 따로 녹화하지 않았습니다. 설치 명령은 위 1번 그대로입니다.

확인 문제#