[HINT] Download the complete skill directory including SKILL.md and all related files
| name | vibe-init |
| description | 프로젝트 초기 세팅을 대화형으로 진행합니다. 환경 점검, provider 인증, 프로젝트 맞춤 설정까지 자동으로 안내합니다. |
이 스킬은 프로젝트 초기 세팅을 Claude Code 대화형으로 진행합니다. 총 4단계(Phase 1~4)로 구성되며, 각 Phase를 순서대로 진행합니다.
용어 정리: CLAUDE.md 의 "Phase 0 — 프로젝트 최초 1회" 는 이 Phase 1~4 전체를 묶는 umbrella term 입니다. 개별 sub-step 은 "Phase N Step N-M" 로 표기합니다 (예: Sprint 로드맵 작성 = Phase 3 Step 3-5). "Phase 0" 을 개별 task 이름으로 사용하지 마십시오 (naming 혼란 방지).
이번 세션에서 프로젝트를 사람이 주도할지 에이전트가 주도할지를 먼저 확인합니다. 이후 모든 Phase 의 interactivity / fast-path / PO-proxy 기본값이 이 선택에 연동됩니다.
질문:
이번 세션에서 이 프로젝트를 어떤 방식으로 진행할까요?
1. human (기본) — 사람이 각 단계 질문에 직접 답하고 승인합니다.
2. agent — 에이전트가 초기 prompt 를 분석하여 모든 단계를 자동으로 진행합니다.
선택 결과는 .vibe/config.json 의 mode 필드에 기록합니다 (값: "human" 또는 "agent").
답을 얻지 못하면 기본값 "human" 으로 진행합니다.
mode=human: Phase 2 Fast-path 은 사용자가 "기본" 등으로 답했을 때만 활성. Phase 3 는 사용자 상호작용 기본. Step 1-1 로 진행.mode=agent: 아래 Step 1-0-agent 분기 로 이동 — 본 /vibe-init 세션은 agent delegation prompt 를 터미널에 출력한 뒤 즉시 종료. 사용자가 출력된 prompt 를 새 agent 세션에 copy-paste 하면 그 새 세션의 agent 가 Phase 2~4 를 자율 진행한다.Step 1-0 에서 사용자가 agent 를 선택하면 다음을 순차 수행:
ONE_LINER 질문:
무엇을 만들고 싶은지 한 줄로 정의해주세요.
(예: "커맨드라인 가계부 도구 — 태그별 월간 요약 + 일일 지출 cap 경고")
사용자 답변을 <ONE_LINER> 변수로 저장.
machine-checkable delegation command 실행:
Claude Code에서 실행 중이면:
npm run vibe:init -- --from-agent-skill --mode=agent --runtime=claude --one-liner "<ONE_LINER>"
Codex에서 실행 중이면:
npm run vibe:init -- --from-agent-skill --mode=agent --runtime=codex --one-liner "<ONE_LINER>"
이 command 는 .vibe/config.json.mode = "agent" 만 기록하고, .claude/templates/agent-delegation-prompt.md 의 실제 prompt 본문을 runtime에 맞게 렌더링해 stdout에 출력한 뒤 종료한다.
완성 prompt 를 터미널에 출력:
치환 완료된 prompt 본문을 아래 형식으로 사용자에게 표시한다:
─────────────────────────────────────────────────────────────
Agent Delegation Prompt (복사해서 새 agent 세션에 주입)
─────────────────────────────────────────────────────────────
```md
<치환된 prompt 본문 전체>
```
─────────────────────────────────────────────────────────────
```
안내 + 세션 종료:
위 prompt 를 copy-paste 하여 새 agent 세션에 전달하세요.
그 세션의 agent 가 /vibe-init Phase 2~4 + Sprint 로드맵 + Sprint 실행 + closure
를 자율적으로 진행합니다.
본 /vibe-init 세션은 여기서 종료합니다.
.vibe/config.json.mode 를 "agent" 로 기록한 뒤 본 /vibe-init skill 흐름은 즉시 중단. Phase 1-1 이하로 진행하지 않는다. (환경 점검 / provider 설정 등은 새 세션의 agent 가 담당.)
특히 .env, .vibe/config.local.json, .vibe/agent/*, .vibe/interview-log/* 를 생성하거나 수정하지 않는다.
왜 새 세션으로 넘기는가:
npm run vibe:init -- --from-agent-skill --mode=human을 실행하여 기본 파일(.env, .vibe/config.local.json)을 생성한 뒤,
아래 환경 점검을 직접 수행합니다:
필수 도구 확인 — node (>=24, Active LTS), npm, git, bash (Windows는 Git Bash)
AI Agent CLI 확인 — claude, codex CLI 등 존재 여부를 확인합니다.
codex exec)로 직접 호출합니다. 플러그인(codex:rescue)은 Windows 불안정·속도 저하로 보류.Native interview 확인 — 별도 설치는 필요 없습니다. .vibe/harness/scripts/vibe-interview.mjs는 Node 24+만으로 동작합니다.
결과를 사용자에게 보여줍니다. 예:
환경 점검 결과:
node (v22.x) ✓
npm ✓
git ✓
claude CLI ✓
codex CLI ✗ (미설치)
사용자에게 Sprint의 3가지 역할에 대해 각각 어떤 AI를 사용할지 물어봅니다.
Fast-path (기본값 일괄 수용): 사용자가 "기본", "default", "엔터", "그대로" 등으로 답하거나, 이미
.vibe/config.local.json이 존재하고sprintRoles가 채워져 있으면 세 역할을 모두 기본값(claude-opus/codex/claude-opus)으로 즉시 확정하고 Step 2-2의 인증 확인으로 바로 넘어갑니다. 역할별 개별 질문을 반복하지 않습니다. dogfood/재실행 케이스에서 Phase 2가 불필요하게 질문을 반복하는 것을 방지합니다.
아래와 같이 질문합니다:
Sprint 역할별 AI를 설정합니다. 각 역할에 어떤 AI를 사용할지 선택해주세요.
기본값은 괄호 안에 표시됩니다. 그대로 쓰려면 엔터만 누르면 됩니다.
(전체 기본값을 한 번에 수용하려면 "기본" 이라고 답하면 됩니다.)
1. Planner (스펙 정의 — "무엇을" 만들지 정의) [기본: claude-opus]
선택지: claude-opus / codex / 기타
2. Generator (코드 구현 — 체크리스트 기반 구현) [기본: codex (CLI)]
선택지: codex / claude-opus / 기타
3. Evaluator (판정 — 합격/불합격 판정) [기본: claude-opus]
선택지: claude-opus / codex / 기타
"기타"를 선택하면 커스텀 AI agent를 연결할 수 있습니다.
사용자가 **"기타"**를 선택한 경우, 추가 질문:
커스텀 AI agent 설정:
- provider 이름은 뭔가요? (예: deepseek, grok, gemini, aider)
- CLI 명령어는 뭔가요? (예: deepseek, grok)
- 프롬프트를 전달하는 인자 형식은 어떻게 되나요?
예시) deepseek --prompt "{prompt}"
예시) grok chat "{prompt}"
모르면 비워두세요. 나중에 .vibe/config.local.json에서 직접 수정할 수 있습니다.
각 선택된 provider에 대해 CLI가 설치되어 있는지 Phase 1 결과를 참조하여 확인합니다.
CLI가 미설치인 경우, 해당 provider의 설치 및 인증 방법을 step-by-step으로 안내합니다:
| Provider | 설치 안내 | 인증 안내 |
|---|---|---|
| codex | npm install -g @openai/codex 으로 Codex CLI 설치. codex --version으로 설치 확인 | 아래 인증 방식 선택 안내 참조 |
| claude-opus | Claude Code 사용 중이므로 이미 인증됨 | - |
| 기타 (custom) | 사용자가 알려준 설치 방법 또는 "해당 AI의 공식 문서를 참고하세요" | 사용자에게 인증 방법 확인 |
Codex CLI 인증 방식 선택 (codex가 선택된 경우):
Codex CLI 설치 후, 사용자에게 인증 방식을 선택하도록 안내합니다:
Codex CLI 인증 방식을 선택해주세요:
1. OAuth 로그인 (기본, 권장)
→ `codex auth login` 실행 후 브라우저에서 OpenAI 계정 로그인
→ API 키 관리 없이 간편하게 사용 가능
2. API 키 직접 설정
→ OPENAI_API_KEY 환경변수에 API 키를 설정
→ .env 파일에 추가하거나, 터미널에서 직접 설정
사용자가 **1 (OAuth)**를 선택한 경우:
! codex auth login 실행을 안내합니다 (사용자가 직접 실행)codex auth status로 인증 상태를 확인합니다사용자가 **2 (API 키)**를 선택한 경우:
.env 파일에 OPENAI_API_KEY=sk-... 추가를 안내합니다! export OPENAI_API_KEY=sk-... 로 현재 세션에서 직접 설정하도록 안내합니다안내 후 사용자에게 확인합니다:
설치/인증을 지금 진행하시겠어요?
- "예" → 사용자가 터미널에서 직접 명령 실행하도록 안내 (! 명령어 prefix 안내)
- "나중에" → 건너뛰고 다음 단계로 진행
- "건너뛰기" → 해당 provider를 일단 설정만 해두고 나중에 연결
선택 결과를 바탕으로 아래 파일들을 업데이트합니다:
CLAUDE.md (CRITICAL — 반드시 수행)<!-- BEGIN:SPRINT_ROLES --> ~ <!-- END:SPRINT_ROLES --> 영역의 역할 테이블을 선택된 provider 이름으로 교체합니다.
또한 CRITICAL 블록 내 Generator sub-agent(현재 설정: **{이전 값}**) 부분을 선택된 generator provider로 업데이트합니다.
이 업데이트는 context 압축 후에도 올바른 모델이 참조되도록 보장하기 위해 필수입니다.
예시 (generator를 deepseek로 선택한 경우):
<!-- BEGIN:SPRINT_ROLES (vibe-init 자동 업데이트 영역) -->
| 역할 | Provider | 상주 여부 | 책임 |
|------|----------|-----------|------|
| **Orchestrator** | **claude-opus** (메인 대화) | 상주 | Sprint 생명주기 관리, 사용자 소통, context 전달, 보고서 |
| **Planner** | **claude-opus** (sub-agent) | Sprint 내 | "무엇을(WHAT)" 정의 + 완료 체크리스트 작성 |
| **Generator** | **deepseek** (sub-agent) | Sprint 내 | 체크리스트 기반 코드 구현 (HOW는 Generator 재량) |
| **Evaluator** | **claude-opus** (sub-agent) | Sprint 내 | 체크리스트 기준 합격/불합격 판정 |
<!-- END:SPRINT_ROLES -->
CRITICAL 블록도 업데이트:
> 모든 코드 구현은 반드시 Generator sub-agent(현재 설정: **deepseek**)를 생성하여 위임한다.
.vibe/config.local.json선택한 Sprint 역할 구성을 반영합니다. 커스텀 provider는 providers 맵에 추가합니다.
config.local.json을 작성할 때 Codex provider는 기본적으로 모든 OS에서
./.vibe/harness/scripts/run-codex.sh를 유지합니다. 이 wrapper가 UTF-8 locale, common rules,
retry, session-start를 담당하므로 Windows에서도 raw codex.cmd exec를 표준 경로로
기입하지 않습니다.
표준 원칙:
"codex": {
"command": "./.vibe/harness/scripts/run-codex.sh",
"args": ["{prompt}"],
"env": {}
}
vibe:run-agent가 .sh wrapper를 실행할 때는
harness가 Git Bash 실행 파일을 직접 탐색합니다. bare bash는 사용하지 않습니다.
where bash가 C:\Users\<user>\AppData\Local\Microsoft\WindowsApps\bash.exe를
반환하면 WSL launcher입니다. Windows Codex wrapper 실행 경로로 사용하지 않습니다.C:\Program Files\Git\bin\bash.exe입니다.VIBE_GIT_BASH 환경변수로 지정할 수 있습니다..vibe/harness/scripts/run-codex.cmd는 Windows-native health/debug wrapper입니다.
node .vibe/harness/scripts/vibe-preflight.mjs는 Windows에서 이 .cmd wrapper의 --health를
우선 사용합니다. Generator 실행 표준은 여전히 run-codex.sh입니다.node와 codex를 별도로 설치합니다.
/mnt/c/.../npm/codex 같은 Windows npm shim은 WSL 실행 경로로 사용하지 않습니다.CODEX_*/VIBE_*를 Windows에서 WSL로 넘기는 워크플로우는 WSLENV에 명시 등록해야
합니다. 기본 템플릿은 Windows와 WSL의 env 공유를 전제로 하지 않습니다.C:\Users\{user}\.local\bin\claude.exe, POSIX claude.Windows 결과 예시:
"providers": {
"claude-opus": {
"command": "C:\\Users\\{user}\\.local\\bin\\claude.exe",
"args": ["-p", "{prompt}"],
"env": {}
},
"codex": {
"command": "./.vibe/harness/scripts/run-codex.sh",
"args": ["{prompt}"],
"env": {}
}
}
POSIX (macOS/Linux/WSL) 결과 예시:
"providers": {
"claude-opus": {
"command": "claude",
"args": ["-p", "{prompt}"],
"env": {}
},
"codex": {
"command": "./.vibe/harness/scripts/run-codex.sh",
"args": ["{prompt}"],
"env": {}
}
}
탐색 실패 시 해당 CLI가 미설치 상태로 간주하고 Phase 2의 "CLI 미설치" 흐름으로
분기합니다. Windows에서 Git Bash가 없으면 Git for Windows 설치 또는 VIBE_GIT_BASH
지정을 안내합니다.
로컬에서 의도적으로 wrapper를 우회해야 하는 실험이 아니라면
config.local.json에codex.cmd exec를 직접 기입하지 않습니다.
예시 (generator를 deepseek로 선택한 경우):
{
"orchestrator": "claude-opus",
"sprintRoles": {
"planner": "claude-opus",
"generator": "deepseek",
"evaluator": "claude-opus"
},
"sprint": {
"unit": "feature",
"subAgentPerRole": true,
"freshContextPerSprint": true
},
"providers": {
"claude-opus": {
"command": "claude",
"args": ["-p", "{prompt}"],
"env": {}
},
"codex": {
"command": "./.vibe/harness/scripts/run-codex.sh",
"args": ["{prompt}"],
"env": {}
},
"deepseek": {
"command": "deepseek",
"args": ["--prompt", "{prompt}"],
"env": {}
}
}
}
AGENTS.mdGenerator로 선택된 provider에 맞게 파일 내용을 수정합니다.
# DeepSeek project memory
너의 기본 역할은 Sprint의 **Generator (코드 구현)** 다.
...
CLAUDE.md 의 <!-- BEGIN:SPRINT_ROLES --> 영역선택된 역할 배정을 이 영역의 표에 반영합니다. 이 표가 Sprint 역할의 single source of truth입니다.
docs/orchestration/providers.md커스텀 provider가 추가된 경우, 해당 provider 섹션을 문서에 추가합니다.
Phase 3 인터뷰는 .vibe/harness/scripts/vibe-interview.mjs만 사용합니다.
상세 실행 규약은 .claude/skills/vibe-interview/SKILL.md를 authoritative runbook으로 따릅니다.
CRITICAL — Phase 3는 스킵 금지: 사용자가 "자율 진행 / 위임 / 알아서 해"라고 말해도 Phase 3 인터뷰 자체는 반드시 완주합니다. 사용자가 직접 답하지 않으면 Orchestrator가 PO-proxy로 답변하고 rationale을 남깁니다.
사용자의 프로젝트 한 줄 설명을 입력으로 받아 인터뷰 세션을 시작합니다. 이 단계는 도메인 추론, probing 질문, context shard seed 생성을 준비합니다.
실행 순서:
node .vibe/harness/scripts/vibe-interview.mjs --init --prompt "<one-liner>" [--lang ko|en] [--max-rounds 30] [--output .vibe/interview-log/<session-id>.json]{ phase: "domain-inference", inferencePrompt }를 Orchestrator가 읽습니다..claude/skills/vibe-interview/SKILL.md의 invocation protocol을 따릅니다.vibe-interview는 10개 핵심 dimension을 backbone으로 삼고, 다음 질문은 Orchestrator LLM이 생성합니다.phase: "done"이 아니라 먼저 phase: "consensus"가 반환됩니다. Step 3-2로 넘어가기 전에 .claude/skills/vibe-interview/SKILL.md의 Consensus Check 절차에 따라 사람 승인, 수정, 보류, 또는 PO-proxy 미확인 상태를 기록해야 합니다.사용자가 자율 진행을 요청하거나 답변을 제공하지 않으면 Orchestrator가 PO 관점에서 답합니다.
--continue와 --record pipe로 기록합니다.approved로 기록합니다. Orchestrator가 PO-proxy로 종료하면 --consensus --decision proxy-unconfirmed를 사용합니다.session-log.md에 [decision][phase3-po-proxy] 항목을 한 번만 남깁니다.인터뷰 결과의 seedForProductMd와 dimension coverage를 기준으로 context shards를 작성합니다.
각 shard 작성 전에 기존 파일 내용을 읽고 사용자 작성 내용을 보존합니다.
원칙 — Write after Read:
docs/context/*.md3개 파일이 placeholder인지 확인한 뒤 작성하고, 사용자 내용은 덮어쓰지 않습니다.
| seed field | 작성 위치 / 의미 |
|---|---|
dimensions.goal | product.md one-liner / success criteria |
dimensions.target_user | product.md target users |
dimensions.platform | product.md platform |
dimensions.data_model | architecture.md data model |
dimensions.primary_interaction | product.md user flow |
dimensions.success_metric | product.md acceptance criteria |
dimensions.non_goals | product.md non-goals |
dimensions.constraints | product.md core assumptions + conventions.md security rules |
dimensions.tech_stack | architecture.md tech stack |
dimensions.domain_specifics | product.md domain notes + conventions.md extra rules |
작성 완료 후 Orchestrator는 seedForProductMd를 docs/context/product.md의 ## Phase 3 답변 기록 (native interview) 섹션에 append합니다.
Also write an explicit review signal block in docs/context/product.md so /vibe-review does not infer frontend status from arbitrary prose:
<!-- BEGIN:PROJECT:review-signals -->
platforms = ["<normalized platform>"]
frontend = true|false
<!-- END:PROJECT:review-signals -->
Use frontend = true only when the product is a browser/web frontend that should be considered for bundle and browser-smoke opt-in review seeds. Use frontend = false for workers, CLIs, data pipelines, capture/import tools, and non-browser apps.
기존 세션의 legacy interview 디렉터리가 남아 있어도 vibe-doctor는 사용하지 않습니다. 사용자가 직접 제거할 수 있습니다.
After Step 3-2 writes the interview seed, inspect the interview log for tech_stack.normalized_slugs[].
Use .claude/skills/test-patterns/_index.md to map each slug to a test shard path, then derive lint shards from the language prefix:
ts-* -> typescript-debt.mdpy-* -> python-debt.mdrust-* -> rust-debt.mdgo-* -> go-debt.mduniversal-debt.mdcanvas-dom-isolation.md or shell-bats.md only when their test slugs are presentRewrite only the marker blocks below in docs/context/conventions.md. If a marker is missing, append the full section. Re-running must be idempotent and must preserve user-authored content outside the markers.
## 테스트 전략
<!-- BEGIN:VIBE:TEST-PATTERNS -->
- TypeScript unit/integration: [.claude/skills/test-patterns/typescript-vitest.md](../../.claude/skills/test-patterns/typescript-vitest.md)
<!-- END:VIBE:TEST-PATTERNS -->
## Lint 규칙
<!-- BEGIN:VIBE:LINT-PATTERNS -->
- TypeScript debt grep: [.claude/skills/lint-patterns/typescript-debt.md](../../.claude/skills/lint-patterns/typescript-debt.md)
- Universal TODO/FIXME: [.claude/skills/lint-patterns/universal-debt.md](../../.claude/skills/lint-patterns/universal-debt.md)
<!-- END:VIBE:LINT-PATTERNS -->
After Step 3-3, inspect inferred_domain, dimensions.platform, and tech_stack.normalized_slugs[] to decide whether the project is a web/frontend candidate.
Treat the project as a web/frontend candidate when either condition matches:
normalized_slugs[] includes a ts- stack slug related to browser/frontend work such as ts-react, ts-vue, ts-svelte, ts-vite, or ts-nextplatform explicitly names a browser/web/frontend surface. Do not treat mobile alone as a browser/frontend signal unless it is mobile web.Decision flow:
bundle.policy = "automatic" by default, then resolve it after interview context is available:
bundle.enabled = true with an agent-selected budget.bundle.enabled = false only with rationale and replacement evidence.bundle.enabled = false with rationale that bundle gate is not applicable.1) 번들 크기 검증 정책을 어떻게 둘까요? [automatic]
choices: automatic / custom / off
- automatic: 인터뷰 이후 에이전트가 프로젝트 유형에 따라 켜거나 끄고 rationale을 남김
- custom: 사용자가 gzip budget을 입력
- off: 끄되 rationale + replacement evidence 필요
2) custom이면 gzip budget KB를 입력해주세요. 예: 250KB [80]
3) 브라우저 UI 가 있어 smoke 검증을 활성화할까요? [y/N]
If the user answer is unclear, missing, "모름", "미정", "추천해줘", "default", or equivalent, record bundle.policy = "automatic".
Apply the result by patching .vibe/config.json:
"bundle": {
"enabled": false,
"policy": "automatic",
"dir": "dist",
"limitGzipKB": 80,
"excludeExt": [".map"],
"rationale": "automatic bundle policy deferred to post-interview project classification"
},
"browserSmoke": {
"enabled": false,
"configPath": ".vibe/smoke.config.js"
}
When bundle.policy = "custom", set bundle.enabled = true, bundle.limitGzipKB to the user-provided number, and bundle.rationale to the user/agent budget reason.
When bundle.policy = "off" or the agent resolves automatic to bundle.enabled = false for a frontend/browser project, include both:
"rationale": "<why the bundle gate is not the right check>",
"replacementEvidence": "<manual smoke, Lighthouse run, screenshot/playthrough evidence, or other calibrated replacement>"
Do not treat off as silent success. /vibe-review will suppress the old default opt-in warning for explicit decisions, but it may raise a replacement-evidence finding when rationale or replacement evidence is missing.
If the product build output uses a custom path such as app/dist, set .vibe/config.json bundle.path and browserSmoke.dist to that path (default: dist).
Always append one session log entry with the rationale and, when a frontend/browser gate is disabled, replacement evidence:
- 2026-04-16T00:00:00.000Z [decision][phase3-utility-opt-in] bundle=false browserSmoke=false rationale=... replacement=...
If browserSmoke.enabled becomes true, create .vibe/smoke.config.js only when it does not already exist. Use this skeleton:
export default {
url: 'http://localhost:5173',
viewport: { width: 375, height: 812 },
expectDom: ['#stage'],
expectConsoleFree: true,
canvasAssertions: []
};
Also create a root README.md from .claude/skills/vibe-init/templates/readme-skeleton.md when the file does not already exist. Replace:
{{project_name}} with the first heading from docs/context/product.md{{one_liner}} with the interview seed one-liner{{status}} with WIP (Phase 0 complete)If README.md already exists, skip it and print:
[vibe-init] README.md exists, skipping skeleton write
Step 3-4 의 context shard 작성 직후, Orchestrator 가 product 맥락을 가장 풍부하게 보유한 상태 에서 Sprint 로드맵을 직접 작성합니다. 이 단계는 Planner 에 위임하지 않습니다 (CLAUDE.md §Sub-agent 소환 트리거 매트릭스 > "Sprint 로드맵 분할" 참조). 위임 시 인터뷰 context 손실로 품질이 저하됩니다.
절차:
docs/context/product.md + docs/context/architecture.md + 인터뷰 seeddocs/plans/sprint-roadmap.md 에 Iteration 1 섹션 append{id, name, 한 줄 목표, 의존, 예상 LOC} 형태포맷 예시:
# Iteration 1 — <project-slug> (v0.1.0)
## Sprint M1 — <one-line-goal>
- id: sprint-M1-<slug>
- 목표: <한 줄>
- 의존: 없음 (첫 slot)
- 예상 LOC: ~<N>
작성 완료 후 session-log.md 에 [decision][sprint-roadmap-drafted] 한 줄 기록을
남깁니다. 이 산출물은 Phase 4 Step 4-0a 의 seal commit 에 포함됩니다.
Sprint Generator가 Codex CLI(또는 trust-based sandbox를 쓰는 다른 provider)인 경우,
프로젝트 루트에 .git이 존재하지 않으면 Codex가 Not inside a trusted directory 에러로
첫 Sprint부터 즉시 실패합니다. 따라서 여기서 git 초기화를 강제합니다.
절차:
git rev-parse --is-inside-work-tree로 기존 git 저장소 여부 확인git init
git add -A
git -c commit.gpgsign=false commit -m "chore: initial vibe-doctor scaffold"
이 단계는 Phase 2에서 Codex/기타 샌드박스형 provider를 선택한 경우에만 필수지만, 선택과 무관하게 git 저장소가 있으면 이후 작업(커밋, 리뷰, 복구)이 모두 수월해지므로 언제나 실행하는 것을 기본값으로 삼습니다.
Immediately after Step 4-0 finishes, run:
node .vibe/harness/scripts/vibe-phase0-seal.mjs
Expected outcomes:
0 with [phase0-seal] committed: ... after staging the Phase 0 artifacts and creating the seal commit0 with [phase0-seal] already sealed (no changes) when nothing changed0 with [phase0-seal] no candidate files present when the Phase 0 files are absentIf the command exits non-zero, print the reason, tell the user to run it manually once, and continue Phase 4 without blocking.
Orchestrator asks:
Sprint 자율 실행 시 권한 프롬프트를 줄이는 agent-delegation 프리셋을 적용하시겠습니까? (npm install/build/test/git 등 scope 제한된 명령만 자동 허용) [Y/n]
node .vibe/harness/scripts/vibe-sprint-mode.mjs on./vibe-sprint-mode on으로 활성화할 수 있습니다."모든 단계가 끝나면 아래를 출력합니다:
초기 세팅이 완료되었습니다!
환경:
node {버전} ✓
npm ✓
git ✓
Sprint 역할 설정:
Orchestrator : claude-opus (기본)
Planner : {선택된 planner} {✓ 인증됨 / ⚠ 미연결}
Generator : {선택된 generator} {✓ 인증됨 / ⚠ 미연결}
Evaluator : {선택된 evaluator} {✓ 인증됨 / ⚠ 미연결}
작성/수정된 파일:
- CLAUDE.md (Sprint 역할 테이블 + CRITICAL 블록)
- .vibe/config.local.json (Sprint 역할 + provider 설정)
- docs/context/product.md (프로젝트 목표)
- docs/context/architecture.md (기술 스택)
- docs/context/conventions.md (코드 규칙)
- AGENTS.md (Generator 규칙)
이제 목표를 말씀해주시면 Sprint 단위로 작업을 시작할 수 있습니다.
예) "Goal: 로그인 페이지를 만들어줘"
npm run vibe:init -- --from-agent-skill --mode=human 실행이 실패하면 원인을 파악하여 해결 후 재시도합니다.mode=agent 선택 후에는 npm run vibe:init -- --from-agent-skill --mode=agent --runtime=<claude|codex> --one-liner "<...>"만 실행하고 즉시 종료합니다. --mode=agent 경로에서 Phase 1-1 bootstrap command를 먼저 실행하지 않습니다.! 명령어 형식을 안내합니다.["--prompt", "{prompt}"])을 사용하고 나중에 .vibe/config.local.json에서 수정 가능하다고 안내합니다.