A project-agnostic Claude Code skill that drives feature development through a 6-step methodology: Context → Prompt QA → Roadmap → Technical Review → Execution → Commit & Close. Its value is enforcing order, conversational checkpoints, and document/code synchronization — it is a procedure, not a tool. All project-specific details (agent names, doc paths, verification commands, ticket formats) live in a per-project binding file, so the methodology itself stays reusable across stacks.
한국어가 1차 언어다 (방법론 출처가 한국어 프로젝트). 영문 번역 기여를 환영한다.
LLM 에이전트로 기능을 개발할 때 자주 무너지는 세 가지 — 순서 붕괴 / 컨텍스트 유실 / 문서·코드 표류 —
를 6단계 절차와 대화 체크포인트로 막는다. 자세한 근거와 단계 정의는 vibe-flow.md 참조.
| 파일 | 역할 | 프로젝트마다 |
|---|---|---|
SKILL.md |
Claude Code 스킬 (오케스트레이터) | 불변 |
vibe-flow.md |
방법론 상세 SSOT | 불변 |
vibe-flow.config.example.md |
프로젝트 바인딩 템플릿 | 복사 후 작성 |
docs/directory-structure.md |
권장 디렉터리 골격 | 매핑 |
- 스킬 설치 —
SKILL.md를 전역~/.claude/skills/vibe-flow/또는 프로젝트.claude/skills/vibe-flow/에 둔다.vibe-flow.md도 함께 둔다.- 한 번에 설치하려면 클론 대상을 스킬 디렉터리로 지정한다:
git clone https://github.com/hongdosan/vibe-flow.git .claude/skills/vibe-flow(전역은 경로를~/.claude/skills/vibe-flow로). 스킬은.claude/skills/<name>/경로에서 인식되므로skills/단계가 필요하다.
- 한 번에 설치하려면 클론 대상을 스킬 디렉터리로 지정한다:
- 바인딩 작성 —
vibe-flow.config.example.md를 프로젝트 루트의.claude/vibe-flow.config.md로 복사하고 에이전트 이름·경로·검증 명령·티켓/커밋 포맷을 채운다. - (선택) 디렉터리 골격 —
docs/directory-structure.md의 골격을 만들거나 기존 경로에paths.*로 매핑한다. - 참조 프롬프트 — 스택별 참조 프롬프트(
paths.reference)를 1회 작성한다. 이후 작업의 개별 프롬프트가 이를 계승하도록 설계한다. - 실행 — 기능 개발/티켓 작업을 요청하면 스킬이 Phase 0(바인딩 로드 + 컨텍스트 확인)부터 6단계를 구동한다.
config 가 없으면 스킬이 repo 를 감지해 바인딩 스캐폴딩을 제안한다(승인 전 추측 값으로 코드 작성 ❌).
- 불변/가변 분리 — 방법론(
SKILL.md+vibe-flow.md)은 프로젝트마다 바뀌지 않는다. 바뀌는 건vibe-flow.config.md뿐. - 승인 게이트 — 계획서(Step 03) 승인 전에는 코드를 쓰지 않는다.
- 동기화 — 구현 중 결정이 바뀌면 상위 문서를 먼저 고친다.
- 순차 + 대화 — 코드 변경은 순차, 단계 사이에 사용자와 대화. 병렬은 읽기 전용 리뷰만.
MIT. LICENSE 참조.