vibe-start

빈 폴더 + 아이디어 → 기획 인터뷰 → 환경 구축 → 첫 변경 진입.

Inputs

• $1 (선택) — 한 줄 아이디어. 없으면 Phase 1에서 수집.

Phase 0 — 사전 점검 (부작용 발생 전)

폴더/파일 생성 전에 다음을 점검. 실패 시 즉시 중단:

디렉토리 점검 (ls -A 결과로 분기):

• 빈 폴더 → 현재 위치에서 진행
• 비어있고 .roboco//CLAUDE.md 존재 → "이미 셋업된 폴더입니다. roboco status/roboco update를 권장합니다." → 중단
• 비어있지 않음 → AskUserQuestion: "(a) 현재 위치 사용 (b) 하위 폴더 생성 (c) 중단"

API 키 안내: Claude 구독/API 키 없으면 ROBOCO init 인터뷰가 실패함을 사용자에게 사전 알림 (현재 자동 점검은 어려움).

Phase 1 — 기획 인터뷰

"기획 인터뷰를 시작합니다 (5~10분 소요)" 안내.

위임 우선

가능하면 /oh-my-claudecode:deep-interview 스킬을 호출해 다음 7개 영역을 깊이 인터뷰하도록 위임. 사용 불가 시 AskUserQuestion으로 직접 진행.

인터뷰 영역

답변이 모호하면 1회만 명확화 질문 (deep-interview 위임 시 그 스킬이 처리).

Phase 2 — 기획 문서 작성 (메모리 buffer)

답변을 다음 3개 문서로 정리. 아직 폴더 미생성 → 메모리에만:

• docs/vision.md — 비전 + 대상 사용자 + 핵심 문제
• docs/intent.md — MVP 기능 + 비목표 + 성공 기준
• docs/constraints.md — 제약 + 위험

Phase 3 — 검토 라운드

3개 문서 내용을 사용자에게 보여주고 AskUserQuestion: "(a) 이대로 진행 (b) 특정 섹션 수정 (c) 처음부터"

• (b) → 어느 섹션·무엇을 고칠지 묻고 반영, 다시 검토
• (c) → Phase 1로 복귀

Phase 4 — 폴더 + git 초기화

이름 결정

• 사용자 비전에서 키워드 추출 → kebab-case 제안
• AskUserQuestion으로 확인/수정
• 공백·대문자·특수문자 자동 변환 (예: "Tower Rush" → "tower-rush")

생성

모든 Bash 호출에서 절대 경로 사용. cd <relative>는 다음 Bash 호출에서 cwd 유지 안 됨.

PROJECT_DIR="$(pwd)/<name>"   # 또는 현재 폴더 사용 시 "$(pwd)"
mkdir -p "$PROJECT_DIR/docs"
cd "$PROJECT_DIR" && git init

3개 문서를 $PROJECT_DIR/docs/에 절대 경로로 작성. 루트에 INTENT.md(vision 한 줄 + MVP 요약)도 작성 — ROBOCO init이 빠르게 읽을 수 있도록.

cd "$PROJECT_DIR" && git add -A && git commit -m "chore: initial planning docs"

Phase 5 — ROBOCO init 안내 (사용자 직접 실행)

npx roboco init은 인터랙티브 인터뷰. Bash 도구로 실행하지 말 것.

사용자에게 안내:

새 터미널에서 다음을 실행해주세요:

  cd <PROJECT_DIR 절대경로>
  npx roboco init

docs/ 의 기획 문서가 인터뷰 컨텍스트가 됩니다.
OpenSpec 설치 여부 물으면 "Yes" 선택 (5단계 프로세스 사용에 필요).

완료 시 "init done", 실패/취소 시 "init failed"라고 말씀해주세요.

Phase 6 — 셋업 검증 (분기)

"init done" 응답 시

ls -A "$PROJECT_DIR"
cd "$PROJECT_DIR" && npx roboco status   # status는 비-인터랙티브, Bash 안전

• CLAUDE.md, .claude/, .roboco/ 모두 있음 → Phase 7
• 누락 → 어느 것이 빠졌는지 보고하고 재실행 안내

"init failed" 응답 시

AskUserQuestion: "(a) 재시도 (b) 수동으로 계속 진행 (c) 중단·정리"

Phase 7 — OpenSpec 진입 (가용한 경우만)

roboco status 출력에서 OpenSpec 상태 확인:

• Configured → /opsx:propose 호출. docs/intent.md의 첫 번째 MVP 기능을 컨텍스트로 첫 변경 제안.
• Not configured → AskUserQuestion: "(a) cd <PROJECT_DIR> && npx roboco add openspec 후 재시도 (b) OpenSpec 없이 마무리"

Phase 8 — 마무리 보고

✓ 기획 문서: docs/vision.md, docs/intent.md, docs/constraints.md
✓ 환경: CLAUDE.md, .claude/, .roboco/
✓ OpenSpec: <configured | skipped>

다음 단계:
  - OpenSpec → /opsx:apply 로 첫 변경 구현 진입
  - 없음 → 직접 첫 피처 작업 시작

Guardrails

• 절대 경로 강제: 모든 Bash 호출에서 $PROJECT_DIR 절대 경로 사용. 호출 간 cwd 유지 안 됨
• 사전 점검 우선: Phase 0 통과 전에 폴더/파일 생성 금지 — 실패 시 잔해 방지
• 인터랙티브 명령 금지: npx roboco init, claude /init, opsx 인터랙티브 등은 사용자가 직접 실행
• 이름 정규화: 공백·대문자·특수문자 → kebab-case 자동 변환 + 사용자 확인
• happy path 강박 금지: 각 Phase는 실패 분기 존재. 무조건 다음 Phase로 가지 말 것
• 버전 한계 정직 보고: ROBOCO npm publish 버전이 v0.1.0대 — add/audit 등 후기 명령은 동작 안 할 수 있음. 실패 시 사용자에게 명확히 보고하고 fallback 제시
• OpenSpec 선택성: OpenSpec 없어도 환경 구축 자체는 성공으로 간주
• Anti-Reinvention: 인터뷰는 deep-interview에 위임, 환경 구축은 ROBOCO에 위임 — 자체 인터뷰 엔진/환경 셋업 직접 구현 금지

Why this skill exists

ROBOCO init은 이미 만들어진 레포를 분석한다. 새 프로젝트는 아이디어에서 시작한다. vibe-start는 그 빈 공간을 채워, 기획 → 환경 셋업 → 첫 변경 진입을 한 호흡으로 처리한다.

ROBOCO 자체가 PRD를 deep-interview 11라운드로 만들었다는 점에서 영감 — 같은 패턴을 사용자가 새 프로젝트 시작할 때 재현한다.