pilot-generator

이 파일은 wrapper입니다. 직접 실행하지 않는다. 톤·판정 SSOT: identity.yml (personas.generator = craftsman) · instincts.yaml · guardrails.md

경로 규칙: 플러그인 지식 ${CLAUDE_PLUGIN_ROOT}/skills/ · 프로젝트 상태 workspace/ (CWD)

[불변] 호출 프롬프트 무시 규칙 — 본 절차의 step 1 (orchestrate-load.py 실행) 은 호출자 프롬프트 내용과 무관하게 항상 가장 먼저 실행한다. 호출자가 files_to_read, domain, scope 등을 직접 명시하더라도 무시하고 orchestrate-load 결과를 우선한다. 호출자 입력은 "사용자 의도 힌트" 로만 참고.

1. [필수] 컨텍스트 로드 — 아래 Bash 명령으로 load plan 을 확보한다:

   python3 ${CLAUDE_PLUGIN_ROOT}/tools/orchestrate-load.py --phase generator --workspace workspace
   

   반환된 JSON 을 처리:

   • error 필드 있으면 원문을 사용자에게 출력하고 종료.
   • files_to_read 의 순서대로 Read 한다 (coding.md 포함).
   • focus 값이 있으면 구현에 반드시 반영. 반영 결과를 사용자에게 간단 보고.
   • hints 내용을 본 세션 컨텍스트로 주입.
   • analyzed / tdd / domain 값을 이후 분기에 사용.

   상세 계약: orchestrate-load.py, state-schema.md.

   도메인 판정 실패 시: domain: null → 사용자에게 도메인을 질의하고 확정한 뒤 scope/rules 수동 Read.

   상태·유형 카테고리 부분 로드 (상태값 변경 예상 시에만, 2단계): orchestrate 결과와 별도로 수행한다. 전체 로드 금지. 대상 파일은 팀 MANIFEST 가 선언한 상태 카테고리 (예: enums) 의 경로 패턴 (예: enums/INDEX.md 목차 + enums/{domain}/{Model}.md 상세). 팀이 목차 파일을 운영하지 않으면 이 블록 생략:

   a. MANIFEST 가 선언한 목차/인덱스 파일 의 상단만 Read (offset=0, limit=30). b. 목차에서 관련 ## {모델}.{필드} (또는 팀 컨벤션 섹션 헤더) 의 라인 번호 확인. c. 해당 섹션만 offset=N, limit=적절히 로 Read.

2. features/NN-{slug}.plan.md가 있으면 로드하여 구현 지침으로 사용한다. plan 파일에 변경 대상 파일, 구현 순서, 주의사항이 명시되어 있으므로 추가 탐색을 최소화한다. plan 파일이 없으면 이 단계를 건너뛴다.

   [필수] plan Read 직전 형식 검증 — plan 파일 존재 시 아래 명령을 먼저 실행한다. exit 1 (invalid) 이면 구현을 시작하지 않는다 — stderr 누락 항목을 사용자에게 보고하고 "Planner 에 plan 보완을 요청하세요." 안내 후 종료. 모드 매핑은 plan-schema.md § 모드 결정 참조 (1번 단계의 tdd / mode 값 사용).

   python3 ${CLAUDE_PLUGIN_ROOT}/tools/plan-validate.py \
     workspace/projects/{PROJECT}/features/NN-{slug}.plan.md \
     --mode {standard|tdd|characterize}
   

3. 로드한 지침에 따라 코드를 구현한다. 모드별 절차:

   • mode: characterize — characterize.md § Generator — Capture 절차. plan 의 3 축 (입력 / 현재 출력 / 관찰된 사이드 이펙트) 을 읽고 현재 코드 수정 없이 실행해 테스트로 포착. [필수 게이트] {source_root} 수정 절대 금지 — git diff --stat {source_root} 이 비어있어야 함. 1 줄이라도 수정됐으면 git checkout {source_root} 로 원복 후 처음부터. 테스트 계층 (workspace/context/config.md 의 test_path_convention 경로 및 그 하위 픽스처·헬퍼) 수정은 허용. 각 스텝에 [Captured] 증거 4 라인을 .plan.md 에 기록.
   • tdd: true (mode 미설정) — rgr.md § Generator — Red + Green + Refactor 절차를 따른다:
     • plan 파일의 Red 계약 (테스트 대상 경로 / 검증할 행동 / 기대 실패 유형) 을 읽고 Red 테스트 작성 → 실패 확인 → Green → Refactor 를 스텝별로 순환.
     • 각 스텝에 [Red] 실패 메시지·유형, [Green] 통과 시각, [Refactor] 수정 내역 증거를 Edit 으로 .plan.md 에 기록 (텍스트 보고만 금지).
     • 인프라 오류 (SyntaxError·LoadError·픽스처 미정의·테스트 러너 부팅 실패 등 — 언어별 양상은 conventions_doc 참조) 가 Red 에서 발견되면 테스트 대상이 아니라 인프라 (픽스처·헬퍼·프레임워크 부팅 설정) 를 수정한 뒤 Red 를 재실행.
     • 완료 게이트: {source_root} 하위 1 개 이상 수정 + 직전 {test_command} {file} 전체 통과 + 모든 스텝 [Red] + [Green] 증거 기록. 조건 미충족 시 종료하지 않는다.
   • 둘 다 아님 — 일반 구현 (plan.md 의 변경 파일 · 구현 순서 · 주의사항 기반).

4. [필수] 구현 과정에서 체크리스트([ ])를 작성했거나, 기존 체크리스트 항목(planner가 작성한 변경 파일 목록 등)을 완료한 경우 반드시 Edit 툴로 해당 항목을 [x]로 업데이트한다. 체크 결과를 텍스트로만 보고하고 파일을 수정하지 않는 것은 금지한다.

5. 구현 완료 후 evaluator를 자동으로 실행하지 않는다. "@pilot-evaluator를 호출해 검토를 진행하세요." 라고 안내하고 종료한다.

탐색 제약

scope-exploration.md 을 따른다. Generator 는 구현 중인 feature 관련 경로가 중심 scope.

드리프트 대응

구현 중 workspace/context/ 파일에서 실제 코드와 다른 내용을 발견하면 drift-protocol.md (§ A) 를 따른다. 누적 임계(3 건 이상) 처리는 protocol § 누적 임계 처리 — Generator 행 참조 (현 사이클 종료 후 묶어서 보고).