PABCD 워크플로우 기본 활성

P — Plan (계획) 사용자 승인 필요

계획 단계에서는 프로젝트 문서와 개발 스킬을 읽은 후 두 부분으로 구성된 계획을 작성합니다:

• 파트 1 — 쉬운 설명: 무엇을 만들 것인지 비개발자 용어로 설명합니다. 누구나 이해할 수 있어야 합니다.
• 파트 2 — Diff 수준의 정밀도: 정확한 파일 경로 (NEW / MODIFY / DELETE), MODIFY의 경우 변경 전/후 diff, NEW의 경우 전체 내용을 포함합니다.

범위 명확화

요청의 범위가 불명확하거나 기술이 지정되지 않은 경우, 계획 수립자가 먼저 명확히 합니다:

• <기술명> -- <쉬운 설명> 형태로 2-3개 옵션을 제시합니다
• 프로젝트에 맞는 근거와 함께 하나를 추천합니다
• 한 번 확인 후 진행합니다

저장소 스캔 (광범위한 변경)

광범위한 변경이나 익숙하지 않은 저장소의 경우, P 단계에서 반드시 다음을 포함해야 합니다:

• 현재 저장소 구조의 간결한 트리
• 감지된 저장소 규칙: 문서, 계획, 아키텍처 노트, 진실 소스(source-of-truth) 로그, 네이밍, 테스트
• 기존 structure/, devlog/, docs/, plans/ 또는 동등한 로그를 읽었는지 여부와 재사용 계획
• structure/ 또는 devlog/ 생성 제안 여부

Devlog 명명 규칙

PABCD 작업에서 devlog/ 계획 산출물을 생성하거나 업데이트하는 경우, 계획에 정확한 번호가 매겨진 Jawdev 파일명을 나열해야 합니다:

00_overview.md
01_phase1_<slug>.md
02_phase2_<slug>.md

PLAN.md, DIFF_PLAN.md, PHASES.md, RCA.md, plan.md 같은 단순 파일명은 새로운 devlog 단계 파일로 허용되지 않습니다.

게이트 질문

계획을 제시하기 전에 계획 수립자가 질문합니다:

1. "제가 단독으로 결정하면 안 되는 비즈니스 로직이 있나요?"
2. "파트 1이 의도와 일치하나요?"

계획이 제시되고 피드백에 따라 수정됩니다. 사용자가 승인하면 cli-jaw orchestrate A로 전환합니다.

A — Plan Audit (계획 감사) 사용자 승인 필요

워커가 생성되어 계획을 감사합니다 (코드가 아님). 워커가 검증하는 항목:

• 계획에 있는 모든 파일 경로와 import가 실제로 존재하는지
• 함수 시그니처가 실제 코드와 일치하는지
• 통합 위험이 없는지
• 기존 진실 소스(source-of-truth) 문서/로그가 있을 때 읽었는지
• 사용자 승인 없이 새로운 structure/, devlog/, 문서, AGENTS 파일이 도입되지 않았는지
• 새 JS/TS 파일이 TypeScript 우선 규칙을 따르는지 (계획에서 JS가 필요한 이유를 명시하지 않는 한)
• 새 TypeScript가 strict 호환이거나 제한 사항이 명시되었는지
• 새 devlog 단계 문서가 번호가 매겨진 Jawdev 파일명 규칙을 따르는지

워커가 감사 결과를 JSON으로 출력합니다. 결과가 검토됩니다:

• FAIL → 계획을 수정하고 재감사
• PASS → 결과를 사용자에게 보고

사용자가 승인하면 cli-jaw orchestrate B로 전환합니다.

B — Build (구현) 사용자 승인 필요

구현 단계입니다. 보스가 모든 코드를 직접 작성합니다. 워커는 읽기 전용 검증자 역할만 합니다.

구현 후, 코드가 존재하고 깔끔하게 통합되는지 확인하기 위해 워커가 검증에 투입됩니다:

• NEEDS_FIX → 보스가 문제를 수정하고 재검증
• DONE → 결과를 사용자에게 보고

P 단계에서 승인되었거나 명시적으로 요청되지 않는 한 structure/ 또는 devlog/를 생성하지 않습니다.

사용자가 승인하면 cli-jaw orchestrate C로 전환합니다.

C — Check (검증) 자동 진행

자동으로 실행되는 최종 정합성 검사입니다:

1. 모든 파일이 저장되고 일관성이 있는지 확인
2. npx tsc --noEmit 실행 (TypeScript 프로젝트인 경우)
3. 해당하는 경우 프로젝트 구조 문서 업데이트
4. 완료 요약 보고

완료되면 cli-jaw orchestrate D를 통해 자동으로 D 단계로 전환됩니다.

D — Done (완료) 자동 진행

전체 PABCD 흐름을 요약합니다:

• 계획된 내용(P), 감사된 내용(A), 구현된 내용(B), 검증된 내용(C)
• 변경된 파일 목록
• 후속 작업 항목

상태가 자동으로 IDLE로 돌아갑니다.