Skip to content

초기화 에이전트 플레이북 (Initializer Agent Playbook) ​

저장소에서 첫 번째 본격적인 세션, 즉 점진적인 기능 작업이 시작되기 전에 이 플레이북(playbook)을 사용하십시오. 초기화(initialization)는 이후 모든 세션이 안정적으로 작동할 수 있는 기반을 마련하는 단계입니다.

목표 (Goal) ​

이후 세션이 시작 명령, 현재 상태, 작업 경계를 재도출하지 않고도 동작을 구현할 수 있도록 안정적인 운영 환경(operating surface)을 만드는 것입니다.

필수 산출물 (Required Outputs) ​

초기화 에이전트(agent)는 최소한 다음 산출물을 남겨야 합니다.

  • AGENTS.md 또는 CLAUDE.md 와 같은 루트 지침 파일
  • feature_list.json 과 같은 기계 가독 기능 목록
  • claude-progress.md 와 같은 지속적인 진행 산출물
  • init.sh 와 같은 표준 시작 헬퍼(helper)
  • 기준선(baseline) 스캐폴드(scaffold)를 캡처하는 초기 안전 커밋(commit)

체크리스트 (Checklist) ​

  1. 표준 시작 경로를 정의합니다.
  2. 표준 검증(verification) 경로를 정의합니다.
  3. 진행 로그(progress log)를 생성하고 시작 상태를 기록합니다.
  4. 작업을 상태(status)가 있는 명시적인 기능으로 분해합니다.
  5. 첫 번째 클린(clean) 기준선 커밋(commit)을 생성합니다.

성공 테스트 (Success Test) ​

이전 채팅 컨텍스트(context) 없는 새 세션이 다음 질문에 답할 수 있어야 합니다.

  • 이 저장소가 무엇을 하는지
  • 어떻게 시작하는지
  • 어떻게 검증(verify)하는지
  • 무엇이 미완성인지
  • 다음으로 최선의 행동은 무엇인지