autodev

AutoDev — Codex /goal 자율 개발

Codex용 자율 개발 루프. PRD/체크리스트의 항목을 하나씩 완료하고 검증 가능한 커밋 후보를 만든다. 장기 목표와 중단 조건은 Codex 내장 /goal에 둔다. 하네스는 진행 문서, 검증 로그, 커밋 후보 로그를 보강한다.

핵심 원리

/goal 설정 → PRD 읽기 → 다음 항목 처리 → 검증 → 커밋 후보 로그
                                                      ↓
                                             done_when 충족?
                                              ↓ Yes       ↓ No
                                         /goal clear   /goal 유지 후 재개

Phase 0: 설정 수집

사용자에게 확인 (빠진 것만 질문):

goal: "무엇을 달성할 것인가"           # 예: "PRD.md의 모든 항목 완료"
done_when: "완료 판단 기준"            # 예: "PRD의 모든 체크박스 완료 + npm test 통과"
prd: "PRD 또는 체크리스트 파일 경로"    # 예: "PRD.md" 또는 "tasks/todo.md"
scope: ["수정 가능한 파일 패턴"]        # 예: ["src/**", "tests/**"]
verify: "검증 명령어"                  # 예: "npm test" (자동 감지 가능)
max_iterations: 100                   # 최대 반복 수 (기본 100)
mode: "continue"                      # continue | reset (기본 continue)

verify 자동 감지

사용자가 verify를 안 줬으면:

1. package.json → npm test 또는 vitest run
2. pyproject.toml → pytest
3. Makefile → make test
4. 없으면 → echo "no verify command"

Phase 1: 루프 초기화

Codex 세션에서 먼저 목표를 설정한다:

/goal {goal}; done_when={done_when}; scope={scope}; verify={verify}; docs=docs/harness/*

# 1. autodev 브랜치 생성
git checkout -b autodev/$(date +%Y%m%d-%H%M)

# 2. .codex-lattice/autodev/ 상태 디렉토리 생성
mkdir -p .codex-lattice/autodev

# 3. 상태 파일 초기화
cat > .codex-lattice/autodev/state.json << 'STATE'
{
  "active": true,
  "iteration": 0,
  "max_iterations": {max_iterations},
  "prompt": "{goal}",
  "done_when": "{done_when}",
  "prd_path": "{prd}",
  "verify_command": "{verify}",
  "started_at": "{ISO시간}",
  "status": "running"
}
STATE

# 4. .gitignore에 .codex-lattice/autodev/ 추가
echo ".codex-lattice/autodev/" >> .gitignore

# 5. 베이스라인 검증
{verify} 2>&1 | tee .codex-lattice/autodev/baseline.log

Phase 2: 반복 실행 (매 세션)

각 세션(반복)에서 수행하는 절차:

1. READ PRD
   - {prd} 파일을 읽는다
   - 미완료 항목([ ]) 중 첫 번째를 선택

2. PLAN
   - 선택한 항목을 구현하기 위한 최소 변경 계획
   - scope 내 파일만 수정 가능

3. IMPLEMENT
   - 계획대로 코드 수정
   - scope 밖 파일 절대 수정 금지

4. VERIFY
   - {verify} 실행
   - 실패 시 build-fix 1회 시도
   - 2회 실패 시 작업 중단, diff와 실패 원인을 기록
   - 파괴적 롤백은 사용자 승인 없이 실행하지 않음

5. COMMIT
   - 성공 시:
     git add [specific-files]
     git commit -m "[autodev] {항목 요약}"
     .codex-lattice/commits/에 후보 로그 확인
   - PRD에서 해당 항목을 [x]로 체크

6. CHECK COMPLETION
   - PRD에 미완료 항목이 남아있는가?
   - Yes → `/goal`을 유지하고 다음 반복을 명시적으로 재개
   - No → done_when 충족. `docs/harness/`와 검증 결과를 갱신하고 `/goal clear`