CLAUDE.md 생성 커맨드

이 커맨드를 실행하면 현재 프로젝트에 애자일-TDD 워크플로우를 적용하기 위한 CLAUDE.md 파일을 생성합니다.

실행 방법

/agile-tdd-workflow:generate-claude-md

생성할 CLAUDE.md 내용

프로젝트 루트에 다음 내용의 CLAUDE.md 파일을 생성하세요:

# 프로젝트 개발 가이드

이 프로젝트는 **애자일-TDD 워크플로우**를 따릅니다.

## 개발 방법론

### 핵심 원칙

1. **명세 주도 개발 (SDD)**: 모든 기능은 명세서와 사용자 스토리로 시작
2. **테스트 주도 개발 (TDD)**: 테스트를 먼저 작성하고 구현
3. **양방향 추적성**: 요구사항부터 코드까지 완전한 추적

### 워크플로우 순서

요구사항 수집 │ ▼ 명세 작성 (spec-writing 스킬) ├── SPEC-{번호}-{기능}.md ├── US-{번호}-{기능}.md (사용자 스토리 + 인수 테스트) └── traceability-matrix.md │ ▼ 프로젝트 부트스트랩 (project-bootstrap 스킬) [신규 프로젝트만] ├── 아키텍처 설계 ├── CI 파이프라인 설정 └── Hello World + Health Check │ ▼ 작업 계획 (task-planning 스킬) ├── 인수 테스트 기반 작업 분할 ├── TASK-{번호}-{제목}.md └── PROGRESS.md │ ▼ 구현 (implementation 스킬) ├── RED: 테스트 작성 (실패) ├── GREEN: 최소 구현 (통과) └── REFACTOR: 코드 개선 │ ▼ 반복 (모든 인수 테스트 완료까지)


## 문서 구조

docs/ ├── specs/ # 기능 명세서 │ └── SPEC-{번호}-{기능}.md ├── user-stories/ # 사용자 스토리 │ └── US-{번호}-{기능}.md ├── architecture/ # 아키텍처 문서 │ ├── ARCHITECTURE.md │ └── CI-PIPELINE.md ├── tasks/ # 작업 계획 │ ├── TASK-{번호}-{제목}.md │ └── PROGRESS.md └── traceability-matrix.md # 추적성 매트릭스


## 추적성 어노테이션

모든 코드와 테스트에 다음 어노테이션을 사용합니다:

| 어노테이션 | 용도 | 예시 |
|-----------|------|------|
| `@trace` | 인수 테스트 연결 | `// @trace US-001-AT-1` |
| `@spec` | 명세 요구사항 연결 | `// @spec SPEC-001-FR-1` |

### 예시

```javascript
// @trace US-001-AT-1
// @spec SPEC-001-FR-1
function processOrder(order) {
  // 구현
}

# @trace US-001-AT-1
# @spec SPEC-001-FR-1
def process_order(order):
    # 구현
    pass

TDD 규칙

RED 단계

구현 전에 테스트 먼저 작성
테스트는 반드시 실패해야 함

GREEN 단계

테스트를 통과시키는 최소한의 코드 작성
과도한 구현 금지

REFACTOR 단계

코드 품질 개선
테스트는 계속 통과해야 함

테스트 실패 시 처리

명세와 비교: 테스트가 명세와 일치하는지 확인
논리적 오류 판단:
- 테스트 오류 → 테스트 수정
- 구현 오류 → 구현 수정 (테스트보다 구현 수정 우선)
- 명세 오류 → 명세 검토 요청
테스트 통과까지 반복

작업 분할 기준

인수 테스트(AT) 단위로 작업 분할
작업 크기 = 구현 시간 + 테스트 작성 시간
하나의 작업에 1~3개의 인수 테스트 포함

CI/CD

GitHub Actions 사용
모든 PR에서 테스트 실행
테스트 통과 필수

스킬 사용법

스킬	트리거 예시
spec-writing	"명세 작성해줘", "요구사항 정리해줘"
project-bootstrap	"프로젝트 시작해줘", "CI 설정해줘"
task-planning	"다음 작업 알려줘", "남은 작업 확인"
implementation	"구현 시작해줘", "TDD로 개발해줘"

주의사항

사용자 스토리의 "사용자"는 항상 최종 사용자
모든 인수 조건은 Given-When-Then 형식
구현 코드에는 반드시 추적 어노테이션 포함
추적성 매트릭스 지속적 업데이트


## 생성 후 안내

CLAUDE.md 파일 생성 후 사용자에게 다음을 안내하세요:

1. **신규 프로젝트**: `spec-writing` 스킬로 요구사항 명세 작성 시작
2. **기존 프로젝트**: 기존 문서를 워크플로우 형식에 맞게 정리 후 진행

/generate-claude-md