| name | gd-start-project |
| description | 프로젝트 초기 세팅. 요구사항 수집 → 복잡도 판단 → write-spec 추천 또는 바로 세팅 (TODO.md + CLAUDE.md + MEMORY.md + README.md). '/gd-start-project', '프로젝트 시작', '프로젝트 초기 세팅' 요청 시 사용. |
| allowed-tools | Read, Write, Edit, Glob, Grep, Skill |
프로젝트 초기 세팅을 수행한다.
워크플로우
1. 요구사항 파악
- 프롬프트가 있으면 → 파싱하여 부족한 부분만 확인
- 프롬프트가 없으면 → "어떤 프로젝트를 시작하시나요?"
- 파악할 항목: 핵심 기능(what), 기술 선호(how), 대상 사용자(who)
- 답변 못하는 항목은 건너뛰거나 적절한 기본값 추천
- 최소한 "what"만 있으면 진행 가능
2. 복잡도 판단
요구사항을 파악한 뒤, 사전에 정해야 할 설계 결정이 많은지 판단한다.
다음 중 해당사항이 많으면 /gd-write-spec을 추천:
- 데이터 모델 간 관계가 복잡하거나 엔티티가 다양함
- 화면/산출물이 다양함
- 외부 시스템 연동 필요 (API, DB, 인증 등)
- 요구사항이 모호하여 구조화가 필요
자동 호출하지 않고, 추천만 하고 사용자가 결정한다.
→ 분기
├─ 간단 → 바로 프로젝트 세팅 (Step 3)
└─ 복잡 → "/write-spec으로 상세기획을 먼저 하시겠어요?"
├─ Yes → Skill("gd-write-spec") 호출 → SPEC.md 생성 → Step 3으로 이어서 진행
└─ No → 바로 프로젝트 세팅 (Step 3)
3. 프로젝트 세팅
아래 파일을 생성한다 (이미 있는 파일은 건너뜀):
TODO.md
- 서브프로젝트(큰 주제)별
## 섹션으로 구분
- 상태 표기:
[x] 완료 · [~] 진행중 · [ ] 미착수
- SPEC.md가 있으면 그 내용을 기반으로 TODO 항목 생성
- SPEC.md가 없으면 요구사항 파악 내용을 기반으로 TODO 항목 생성
CLAUDE.md에 Session Rules 추가
- 세션 시작 시 TODO.md를 읽고 체크박스 상태를 확인하여 현재 진행 상태를 파악한다.
- 작업 완료 →
[x], 진행중 → [~]로 TODO.md 갱신한다.
MEMORY.md 초기화
- 위치: 프로젝트 루트
./MEMORY.md (git 동기화, 멀티 머신 공유)
- 초기 내용: 프로젝트 요약 1~2줄 + 핵심 구조/파일 경로
- 200줄 이내 유지 (초과분은 잘림)
README.md 생성
- 프로젝트 소개, 설치, 사용법
- 초기 1회 생성 후 필요 시 갱신
문서 역할 (혼재 금지)
| 파일 | 독자 | 역할 | 갱신 |
|---|
SPEC.md | Claude Code + 팀원 | 상세 기획서 (/gd-write-spec 산출물) | 필요 시 |
TODO.md | Claude Code + 팀원 | 작업 트래커 (체크박스로 진행률 추적) | 매 세션 |
CLAUDE.md | Claude Code | 프로젝트 규칙 | 필요 시 |
MEMORY.md | Claude Code | 세션 간 컨텍스트 유지 | 매 세션 |
README.md | GitHub 방문자 | 프로젝트 소개 | 필요 시 |
다음 단계
프로젝트 세팅 완료 후 → 구현 작업 시작. 복잡한 기능은 /harness로 에이전트 팀 구성.
