directory-structure.md

권장 디렉터리 구조

vibe-flow 가 가정하는 산출물 골격이다. 모든 산출물은 .claude/ 내부에 두어 도구 설정과 함께 관리한다. 경로는 모두 vibe-flow.config.md 의 paths.* 로 매핑되므로, 기존 프로젝트 구조를 바꿀 필요는 없다. 새로 도입한다면 아래를 기본으로 쓰고, 기존 구조가 있으면 바인딩으로 매핑만 한다.

스킬 설치 위치

스킬 자체는 두 곳 중 하나에 둔다.

~/.claude/skills/vibe-flow/             # 전역: 모든 프로젝트에서 사용
  └── SKILL.md
# 또는
<project>/.claude/skills/vibe-flow/     # 프로젝트 한정
  └── SKILL.md

vibe-flow.md(방법론 SSOT)와 vibe-flow.config.example.md(템플릿)는 스킬 디렉터리에 함께 두어 참조 가능하게 한다.

프로젝트 산출물 골격 (기본값)

모두 .claude/ 내부에 둔다.

<project>/
└── .claude/
    ├── skills/vibe-flow/SKILL.md     # 스킬 (전역 설치 시 생략 가능)
    ├── vibe-flow.config.md            # 프로젝트 바인딩 (example 복사 후 작성)
    └── vibe/                          # paths.* 루트
        ├── reference/                 # Step 01 참조 프롬프트 — 스택별 1회 작성, 모든 작업이 계승
        │   ├── backend.md
        │   └── frontend.md
        ├── prompts/                   # Step 02 검증된 개별 프롬프트
        │   └── <topic>.md
        ├── plans/                     # Step 03 계획서
        │   └── <topic>/
        │       ├── 00-discussion.md   # (선택) Step 04 논의
        │       ├── 01-be-<scope>.md
        │       └── 02-fe-<scope>.md
        ├── discussion/                # Step 04 논의 문서 (topic 외부에 둘 경우)
        │   └── <topic>.md
        ├── handoff/                   # 세션 핸드오프
        │   ├── CURRENT.md             # 활성 핸드오프
        │   └── <topic>.md             # 트랙별 분리 시
        └── review/                    # 리뷰 산출물

경로 매핑 원칙

• paths.* 의 값만 바꾸면 어떤 기존 구조에도 얹을 수 있다. 디렉터리 이름은 자유.
• 불변/가변 분리: SKILL.md + vibe-flow.md 는 프로젝트마다 바뀌지 않는다. 바뀌는 건 vibe-flow.config.md 뿐이다.
• 참조 프롬프트(reference/)는 프로젝트 스택의 SSOT 다. 여기에 아키텍처 제약·컨벤션을 한 번 적어두면 Step 01 의 개별 프롬프트가 이를 계승한다.

최소 구성 (가볍게 시작)

전부 만들 필요는 없다. 최소한 다음만 있으면 동작한다.

.claude/vibe-flow.config.md            # 바인딩
.claude/vibe/plans/<topic>/01-*.md     # 계획서 (Step 03)

reference/·prompts/·handoff/ 는 작업이 커질 때 추가한다.