워크플로우¶
CodexSpec은 개발을 각 단계에서 인간 검증이 포함된 검토 가능한 체크포인트로 구조화합니다.
워크플로우 개요¶
┌──────────────────────────────────────────────────────────────────────────┐
│ CodexSpec 인간-AI 협업 워크플로우 │
├──────────────────────────────────────────────────────────────────────────┤
│ │
│ 1. Constitution ──► 프로젝트 원칙 정의 │
│ │ │
│ ▼ │
│ 2. Specify ───────► 요구사항 명확화를 위한 대화형 Q&A │
│ │ │
│ ▼ │
│ 3. Generate Spec ─► spec.md 문서 생성 │
│ │ ✓ 자동 검토: review-spec.md 생성 │
│ ▼ │
│ 4. Spec to Plan ──► 기술 계획 생성 │
│ │ ✓ 자동 검토: review-plan.md 생성 │
│ ▼ │
│ 5. Plan to Tasks ─► 원자적 작업 생성 │
│ │ ✓ 자동 검토: review-tasks.md 생성 │
│ ▼ │
│ 6. Implement ─────► 조건부 TDD 워크플로우로 실행 │
│ │
└──────────────────────────────────────────────────────────────────────────┘
리뷰가 중요한 이유¶
| 리뷰 없이 | 리뷰와 함께 |
|---|---|
| AI가 잘못된 가정을 함 | 인간이 초기에 오해를 포착 |
| 불완전한 요구사항이 전파됨 | 구현 전에 간극 식별 |
| 아키텍처가 의도에서 벗어남 | 각 단계에서 정렬 검증 |
| 결과: 재작업 | 결과: 첫 번째에 올바르게 |
자동 검토¶
각 생성 명령은 이제 자동으로 검토를 실행합니다:
/codexspec:generate-spec→ 자동으로review-spec호출/codexspec:spec-to-plan→ 자동으로review-plan호출/codexspec:plan-to-tasks→ 자동으로review-tasks호출
검토 보고서는 산출물과 함께 생성되어 문제를 즉시 확인할 수 있습니다.
반복 품질 루프¶
검토 보고서에서 문제가 발견되면, 자연어로 수정 내용을 설명하면 시스템이 산출물과 보고서를 모두 업데이트합니다:
┌──────────────────────────────────────────────────────────────────────┐
│ 반복 품질 루프 │
├──────────────────────────────────────────────────────────────────────┤
│ │
│ 산출물 (spec/plan/tasks.md) │
│ │ │
│ ▼ │
│ 자동 검토 ──────► 검토 보고서 (review-*.md) │
│ │ │ │
│ │ ▼ │
│ │ 문제가 발견되었나요? │
│ │ │ │
│ │ ┌─────┴─────┐ │
│ │ │ │ │
│ │ 예 아니오 │
│ │ │ │ │
│ │ ▼ ▼ │
│ │ 대화에서 수정 다음 단계로 │
│ │ 내용 설명하기 │
│ │ │ │
│ │ ▼ │
│ │ 동시에 업데이트: │
│ │ • 산출물 (spec/plan/tasks.md) │
│ │ • 검토 보고서 (review-*.md) │
│ │ │ │
│ └────────────────┘ │
│ (만족할 때까지 반복) │
│ │
│ 수동 재검토: /codexspec:review-* 를 언제든 실행하여 새로운 분석 획득 │
│ │
└──────────────────────────────────────────────────────────────────────┘
작동 방식:
- 자동 검토: 각 생성 명령이 해당 검토를 자동으로 실행
- 검토 보고서: 발견된 문제가 포함된
review-*.md파일 생성 - 반복적 수정: 대화에서 수정할 내용을 설명하면 산출물과 보고서가 함께 업데이트
- 수동 재검토:
/codexspec:review-spec|plan|tasks를 언제든 실행하여 새로운 분석 획득
핵심 명령¶
| 단계 | 명령 | 목적 |
|---|---|---|
| 1 | /codexspec:constitution |
프로젝트 원칙 정의 |
| 2 | /codexspec:specify |
요구사항에 대한 대화형 Q&A |
| 3 | /codexspec:generate-spec |
명세서 문서 생성 (★ 자동 검토) |
| - | /codexspec:review-spec |
자동 호출, 또는 수동으로 재검증 |
| 4 | /codexspec:spec-to-plan |
기술 계획 생성 (★ 자동 검토) |
| - | /codexspec:review-plan |
자동 호출, 또는 수동으로 재검증 |
| 5 | /codexspec:plan-to-tasks |
작업으로 분해 (★ 자동 검토) |
| - | /codexspec:review-tasks |
자동 호출, 또는 수동으로 재검증 |
| 6 | /codexspec:implement-tasks |
구현 실행 |
2단계 명세¶
specify vs clarify¶
| 측면 | /codexspec:specify |
/codexspec:clarify |
|---|---|---|
| 목적 | 초기 탐색 | 반복적 정제 |
| 시기 | spec.md가 없음 | spec.md가 존재, 간극 채우기 필요 |
| 입력 | 초기 아이디어 | 기존 spec.md |
| 출력 | 없음 (대화만) | spec.md 업데이트 |
조건부 TDD¶
구현은 조건부 TDD를 따릅니다:
- 코드 작업: 테스트 우선 (Red → Green → Verify → Refactor)
- 테스트 불가능한 작업 (문서, 구성): 직접 구현