@su-record/vibe 2.16.4 → 3.0.0

package/skills/vibe.spec/SKILL.md

@@ -1,579 +1,82 @@
 ---
 name: vibe.spec
-description: 프로젝트 명세 통합 진입점 — interview → plan → spec → review → run/figma 전체 워크플로 오케스트레이션
-argument-hint: "(선택) feature name, plan/interview file path, or idea"
+description: SPEC 진입점 — 자연어 요구사항(+첨부)을 받아 단일 패스 SPEC 작성 → 1회 승인 → /vibe.run 핸드오프
+argument-hint: "(선택) feature name, requirement, file path, or idea"
 user-invocable: true
 ---
 
 # /vibe.spec
 
-**vibe 워크플로 통합 진입점.** "무엇을 개발할지" 질문으로 시작해서 interview → plan → SPEC 작성 → review → 구현 + UI 디자인까지 전체 흐름을 오케스트레이션한다.
+**SPEC 단계의 얇은 진입점.** 요구사항을 받아 `spec` 스킬(단일 패스)을 실행하고, SPEC 승인(유일한 의무 게이트) 후 `/vibe.run` 으로 넘긴다. interview → plan → spec → review 다단계 파이프라인은 폐지되었다 — 명확화 질문은 spec 패스 안에서 인라인으로, 리뷰는 셀프 리뷰 1회로 흡수됐다.
 
 ## Usage
 
 ```
-/vibe.spec                                       # 빈 시작 — "무엇을 만들까요?"부터
-/vibe.spec "패럴랙스 웹사이트"                     # 아이디어/피처명 지정 시작
-/vibe.spec ".vibe/plans/{feature}.md"     # 기획서 입력 (plan 단계 스킵)
-/vibe.spec ".vibe/interviews/{feature}.md" # interview 입력 (interview 단계 스킵)
-/vibe.spec "docs/prd.md"                         # 외부 PRD/아이디어 파일 입력
-/vibe.spec + 📎 첨부                              # 첨부 기반 시작
-/vibe.spec "feature-name" ultrawork              # 중단 게이트 없이 자동 전 흐름 실행
+/vibe.spec                              # 빈 시작 — Smart Resume 또는 "무엇을 만들까요?"
+/vibe.spec "패럴랙스 웹사이트"            # 아이디어/요구사항으로 시작
+/vibe.spec "docs/prd.md"                # 외부 PRD/아이디어 파일 입력
+/vibe.spec + 📎 첨부                     # 첨부 기반 시작
+/vibe.spec "feature-name"               # 기존 feature 재개
 ```
 
-## Philosophy
-
-> **사용자는 "무엇을 만들지"만 말하면 된다. 어떤 스킬을 언제 부를지는 vibe가 결정한다.**
-
-- **단일 진입점**: `/vibe.spec` 하나로 전체 워크플로 시작. 다른 `/vibe.*` 커맨드 이름 외울 필요 없음.
-- **Smart resume**: 기존 interview/plan/spec 파일 존재 여부로 어느 단계부터 시작할지 자동 판단.
-- **자동 체이닝**: 스킬 `chain-next` 메타데이터 따라 interview → plan → spec → spec-review 진행.
-- **분기 판단**: 기획서의 `type` 필드로 UI 트랙/로직 트랙 여부 결정.
-- **사용자 제어**: 각 단계 사이에 사용자 확인 지점(stop gate) 제공 (ultrawork 모드는 스킵).
-
 ## Flow
 
 ```
 /vibe.spec ["input"?]
     ↓
-Phase 0: Git branch setup
-    ↓
-Phase 0.5: Input 분석 + Smart resume 결정
-    - 첨부/파일/아이디어 감지
-    - 기존 .vibe/{interviews,plans,specs}/ 확인
-    - 시작 단계 결정: interview | plan | spec | review
-    ↓
-Phase 1: Interview (skill: interview)
-    - 조건: interview 파일 없음
-    - 사용자 "그만"까지 반복 인터뷰
-    - 출력: .vibe/interviews/{feature}.md
-    ↓
-    [Stop Gate 1] — ultrawork 모드에서는 스킵
+Input 분석 + Smart Resume
     ↓
-Phase 2: Plan (skill: plan)
-    - 조건: plan 파일 없음
-    - interview → 마크다운 기획서 정제
-    - 출력: .vibe/plans/{feature}.md
+Load skill `spec` — 단일 패스: 컨텍스트 수집 → (필요시) 인라인 질문 → SPEC + Feature 작성 → 셀프 리뷰 1회
     ↓
-    [Stop Gate 2 + 분기 판단]
-    기획서 type 읽고 경로 결정:
-      - website/webapp/mobile → UI + Logic 병렬
-      - api/library/feature-data → Logic만
+SPEC 승인 (1회 — automationLevel: autonomous 면 생략)
     ↓
-Phase 3: SPEC 작성 (skill: spec)
-    - PTCF 구조 SPEC 문서 + Feature(BDD) 파일
-    - Parallel research (GPT/Antigravity/Claude agents)
-    - Large scope 자동 분할
-    - Ambiguity scan + 품질 게이트(100점, 수렴까지 루프)
-    - 출력: .vibe/specs/{feature}.md + .vibe/features/{feature}.feature
-    ↓
-Phase 4: SPEC Review (skill: spec-review)
-    - Race Review (GPT + Antigravity, 라운드 수 캡 없음, 수렴까지 루프)
-    - (옵션) Codex adversarial review
-    - 사용자 최종 체크포인트
-    ↓
-Phase 5a: Logic Track → /vibe.run
-Phase 5b: UI Track (병렬, UI 프로젝트만) → /vibe.figma
-    ↓
-Phase 6: Verify (/vibe.verify)
-Phase 7: Trace (/vibe.trace)
-    ↓
-Done
-```
-
-## Rules Reference
-
-**`~/.claude/vibe/rules/` (global) 준수:**
-
-- `core/development-philosophy.md`
-- `core/quick-start.md` — Korean first
-- `core/communication-guide.md`
-
-## Process
-
-> **⏱️ Timer**: 시작 시 `getCurrentTime` 호출, `{start_time}`로 기록.
-
-### Phase 0: Git Branch Setup (MANDATORY)
-
-```bash
-git branch --show-current
-```
-
-| 현재 | 행동 |
-|-----|-----|
-| `main`/`master` | 임시 이름으로 `git checkout -b vibe/tmp` (이후 feature 이름 확정되면 리네임) |
-| `feature/*`, `plan/*`, `interview/*`, `vibe/*` | 확인: "이 브랜치에서 계속?" |
-| 기타 | 사용자 확인 |
-
-### Phase 0.5: Input 분석 + Smart Resume
-
-**입력 우선순위:**
-
-```
-1. 📎 첨부 파일 있음? → 첨부 분석 → feature name 추출
-2. 인자가 파일 경로? → 파일 위치로 시작 단계 결정:
-     .vibe/interviews/*.md → Phase 2 (plan)
-     .vibe/plans/*.md      → Phase 3 (spec)
-     .vibe/specs/*.md      → Phase 4 (review)
-     기타 (.md/.txt/.pdf)         → Phase 2 (plan, 외부 PRD 흡수)
-3. 인자가 feature name? → .vibe/에서 기존 파일 검색
-     existing spec → "리뷰 재실행? 이어서? 재작성?" 물음
-     existing plan → Phase 3 (spec)
-     existing interview → Phase 2 (plan)
-     아무것도 없음 → Phase 1 (interview)
-4. 인자 없음 → Smart Resume Fallback 알고리즘 실행 (아래 참조)
-```
-
-#### Smart Resume Fallback (인자 없는 `/vibe.spec` 호출 시)
-
-**목적**: feature 이름을 기억하지 못해도 진행 중 작업을 자동 발견해서 이어서 진행할 수 있게 한다.
-
-```
-알고리즘:
-
-Step 1) .vibe/.last-feature 확인 (pointer 파일)
-  - 파일 없음 → Step 2로
-  - 존재 → 해당 feature의 상태 요약 출력 + 확인 질문:
-      "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-       🔄 마지막 작업: {feature-name}
-       ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-       ✅ interview: .vibe/interviews/{feature}.md  (status: complete, N일 전)
-       ✅ plan:      .vibe/plans/{feature}.md       (N일 전)
-       ❌ spec:      없음
-       → 다음 단계: Phase 3 (spec 스킬 — SPEC 작성)
-
-       이어서 진행할까요?
-         Enter / yes → 이어서 진행
-         list        → 다른 진행 중 작업 목록 보기
-         new         → 새 아이디어로 시작
-         abort       → 종료"
-
-  - yes → Phase 0.5의 인자 분석 경로 3번 (feature name)으로 진입
-  - list → Step 2로
-  - new → Step 3으로
-  - abort → 종료
-
-Step 2) 진행 중 작업 목록 표시 (.vibe/ 디렉토리 스캔)
-  수집:
-    features = {} (feature name → {hasInterview, hasPlan, hasSpec, mtime})
-    for each file in .vibe/interviews/*.md:
-      feature = basename without .md
-      features[feature].hasInterview = true
-      features[feature].interviewMtime = file.mtime
-      features[feature].interviewStatus = frontmatter의 status (complete/partial)
-    동일하게 plans/*.md, specs/*.md 스캔
-
-  정렬: 가장 최근 작업 (max mtime) 순
-  최대 10개까지 표시
-
-  진행 중 작업 0개 → Step 3으로
-  1개 이상 → 목록 출력 + 선택 질문:
-    "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-     🔍 진행 중인 작업
-     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-     1. bean-landing      [interview: partial]        2일 전
-     2. todo-app          [plan: complete]            어제
-     3. payment-api       [spec: complete]            방금 전
-     ─────────────────────────────────────────────
-     n. ➕ 새로 시작
-     a. 종료
-
-     선택 번호 또는 feature 이름을 입력하세요:"
-
-  사용자 응답 처리:
-    - 숫자 (1~N) → 해당 feature 선택 → 인자 분석 경로 3번으로
-    - 정확한 feature 이름 → 인자 분석 경로 3번으로
-    - "n" 또는 "new" → Step 3으로
-    - "a" 또는 "abort" → 종료
-    - 자유 텍스트 (매칭 없음) → "{입력}은 기존 feature가 아닙니다. 새로 시작할까요? (y/n)" 확인
-
-Step 3) 빈 시작 (기존 동작)
-  "👋 무엇을 만들고 싶으신가요?" 질문 → Phase 1 (interview)
-```
-
-#### `.last-feature` 포인터 파일 갱신 규칙
-
-```
-경로: .vibe/.last-feature
-형식: 한 줄, feature name만 저장
-     예: "bean-landing\n"
-
-⚠ 이 파일은 **개인 작업 포인터**이므로 git에 커밋하지 않는다.
-   `.gitignore` 에 `.vibe/.last-feature` 엔트리 필수.
-
-갱신 시점:
-  - Phase 1 (interview) 진입 시 → feature name 결정되면 즉시 기록
-  - Phase 2 (plan) 진입 시 → 기록 (이미 맞으면 no-op)
-  - Phase 3 (spec) 진입 시 → 기록
-  - Phase 4 (review) 진입 시 → 기록
-
-즉, 어느 Phase에서 멈추든 다음 /vibe.spec 호출 시 이 feature가 1순위로 제안된다.
-
-삭제 시점:
-  - Phase 7 (trace) 완료 시 → 파일 삭제 (워크플로 완주)
-  - 사용자가 명시적으로 종료/abort 선택 시 → 삭제하지 않음 (재개 가능하게)
-```
-
-**출력 예시:**
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🔍 Input 분석
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-입력: "패럴랙스 웹사이트"
-분류: 신규 아이디어
-기존 파일: 없음
-
-→ 시작 단계: Phase 1 (interview)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
-### Phase 1: Interview (조건부)
-
-**진입 조건:** interview 파일이 아직 없음
-
-**진입 방식:**
-
-1. **인자 있음** (`/vibe.spec "아이디어"`)
-   → `interview` 스킬 로드 + 아이디어 전달
-
-2. **인자 없음** (`/vibe.spec`)
-   → **Smart Resume Fallback 먼저** (Phase 0.5 참조):
-     - `.last-feature` 있고 사용자가 "이어서" 선택 → 해당 feature로 진입 (이 Phase 1 건너뛸 수 있음)
-     - 진행 중 작업 목록에서 선택 → 해당 feature로 진입
-     - "new" 선택 or 진행 중 작업 없음 → 아래 질문으로 빈 시작
-   → 빈 시작 질문:
-   ```
-   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   👋 무엇을 만들고 싶으신가요?
-   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-   예:
-   - "패럴랙스 웹사이트"
-   - "할 일 관리 앱"
-   - "Stripe 결제 연동 API"
-   - 또는 자유롭게 설명
-
-   (파일/이미지 첨부도 가능)
-   ```
-   → 사용자 응답 → `interview` 스킬 로드
-
-**스킬 로드:**
-
-```
-Load skill `interview` with input: {user_idea}
-```
-
-> **`.last-feature` 갱신**: interview 스킬이 feature name을 확정하는 즉시 `.vibe/.last-feature` 에 한 줄로 기록. 이후 Phase 2/3/4 진입 시에도 동일 기록 유지 (값이 같으면 no-op).
-
-`interview` 스킬이 자체적으로:
-- 프로젝트 타입 감지 (website/webapp/mobile/api/library/feature)
-- 타입별 체크리스트 로드 (`skills/interview/checklists/{type}.md`)
-- 반복 인터뷰 실행 (사용자 "그만"까지)
-- `.vibe/interviews/{feature-name}.md` 저장
-
-**Stop Gate 1**: Interview 완료 후 (ultrawork 모드 스킵)
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-✅ Interview 완료
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📄 .vibe/interviews/{feature}.md
-   Required: N/M | Optional: K/L | Discovered: X
-
-다음 단계: 기획서 작성
-  1. 계속 진행 (기본)
-  2. Interview만 저장하고 종료
-  3. Interview 수정 후 다시 (interview 재실행)
-
-Enter → 계속
-```
-
-### Phase 2: Plan (조건부)
-
-**진입 조건:** plan 파일이 아직 없음
-
-```
-Load skill `plan` with input: .vibe/interviews/{feature}.md
-```
-
-`plan` 스킬이 자체적으로:
-- 템플릿 로드 (`~/.claude/vibe/templates/plan-template.md`)
-- Interview 섹션별 정제
-- UI 섹션 조건부 포함 (type 기반)
-- `.vibe/plans/{feature}.md` 저장
-
-**Stop Gate 2**: 기획서 완료 후 + 분기 판단 (ultrawork 모드 스킵)
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-✅ 기획서 완성
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📄 .vibe/plans/{feature}.md
-Type: {type}
-
-{type ∈ UI}:
-자동 경로: SPEC 작성 → Review → Logic Track + UI Track 병렬 실행
-  1. 계속 (권장)
-  2. Logic Track만 (SPEC만)
-  3. UI Track만 (/vibe.figma 바로)
-  4. 여기서 종료
-
-{type ∈ non-UI}:
-자동 경로: SPEC 작성 → Review → Logic Track
-  1. 계속 (권장)
-  2. 여기서 종료
-
-Enter → 계속
-```
-
-### Phase 3: SPEC 작성
-
-**진입 조건:** spec 파일이 아직 없음 (또는 재작성 요청)
-
-```
-Load skill `spec` with input: .vibe/plans/{feature}.md
-```
-
-`spec` 스킬이 PTCF 구조 SPEC 문서 + Feature(BDD) 파일 생성.
-
-**핵심 단계** (상세는 `skills/spec/SKILL.md` 참조):
-
-1. Project analysis (explorer agent)
-2. config.json references 로드
-3. Parallel research (GPT + Antigravity + Claude agents, 8개 병렬)
-4. UI/UX Design Intelligence (UI 키워드 시 자동)
-5. PTCF SPEC 작성 (Large scope 자동 분할)
-6. Feature file (BDD) 생성
-7. Ambiguity scan
-8. Quality gate (100점, 수렴까지 루프)
-
-**출력:**
-
-- `.vibe/specs/{feature-name}.md` (또는 split folder)
-- `.vibe/features/{feature-name}.feature` (또는 split folder)
-
-### Phase 4: SPEC Review
-
-```
-Load skill `spec-review` with feature: {feature-name}
-```
-
-`spec-review` 스킬이 Race Review + 품질 검증 + 사용자 체크포인트 실행.
-
-**핵심 단계** (상세는 `skills/spec-review/SKILL.md` 참조):
-
-1. SPEC/Feature 파일 로드 (single/split 자동 감지)
-2. Quality Validation (100점 게이트, 수렴까지 auto-fix 루프)
-3. Race Review (GPT + Antigravity parallel, 라운드 수 캡 없음, P1=0 + 수렴 시 종료)
-4. (옵션) Codex adversarial review
-5. Review Debate Team (2+ P1/P2 이슈 시)
-6. 사용자 최종 체크포인트
-
-### Phase 4.5: Contract Extract (auto, only for features with an API)
-
-```
-Load skill `contract` with: extract "{feature-name}"
-```
-
-If the SPEC has a `## API` / `## Endpoints` / `## Interface` section, extract the contract to `.vibe/contracts/{feature-name}.md`. If the section is absent, exit cleanly (not every feature has an API).
-
-The contract is referenced during Phase 5a implementation, and used by `/vibe.verify` for drift detection.
-
-### Phase 5a: Logic Track
-
-```
 /vibe.run "{feature-name}"
 ```
 
-SPEC → code. Auto-checks at start:
-- `/vibe.regress list --feature {feature-name}` — warn if any open regressions exist
-- `.vibe/contracts/{feature-name}.md` — load if present, use as implementation guide
-
-### Phase 5b: UI Track (type ∈ {website, webapp, mobile}일 때만)
-
-**5a와 병렬 실행** (또는 순차 — 사용자 선택):
+## Input 분석 + Smart Resume
 
 ```
-/vibe.figma
+1. 📎 첨부 있음 → 첨부를 spec 입력으로 전달
+2. 인자가 파일 경로 →
+     .vibe/specs/*.md   → 기존 SPEC: "승인 재확인? 재작성? /vibe.run 진행?" 질문
+     기타 (.md/.txt/.pdf) → 외부 PRD 로 spec 입력에 병합
+3. 인자가 feature name → .vibe/ 검색:
+     spec 존재      → "재작성? 이어서 /vibe.run?" 질문
+     spec 없음      → spec 패스 시작 (레거시 아티팩트가 있으면 입력으로)
+4. 인자 없음 → .vibe/.last-feature 확인 → 있으면 "이어서 진행?" 제안,
+     없으면 .vibe/specs/ 스캔해 진행 중 목록 제시, 그것도 없으면
+     "👋 무엇을 만들고 싶으신가요?" 로 빈 시작
 ```
 
-**`/vibe.figma`에 전달할 컨텍스트:**
+### 레거시 아티팩트 호환 (구버전 .vibe/interviews/, .vibe/plans/)
 
-- `.vibe/plans/{feature}.md` 경로
-- 기획서의 §7 Look & Feel, §8 레이아웃, §9 반응형 섹션을 Phase 1 스토리보드 입력으로 사용
+구버전 vibe 가 남긴 `.vibe/interviews/{feature}.md`, `.vibe/plans/{feature}.md` 가 존재할 수 있다:
 
-### Phase 6: Verify
+- **존재하면**: spec 패스의 **입력 컨텍스트**로 읽어 활용한다 (이미 답한 질문을 다시 묻지 않게).
+- **절대 요구하거나 재생성하지 않는다**: 이 파일들의 부재는 결함이 아니라 정상 상태다. interview/plan 스킬은 더 이상 존재하지 않는다.
 
-```
-/vibe.verify "{feature-name}"
-```
+### `.last-feature` 포인터
 
-UI + 로직 + 연결 검증 (후속 PR에서 3축 확장 예정).
+- spec 패스에서 feature 이름 확정 시 `.vibe/.last-feature` 에 한 줄 기록 (spec 스킬이 수행).
+- 개인 작업 포인터이므로 git 커밋 금지 (`.gitignore` 에 `.vibe/.last-feature`).
+- 워크플로 완주(verify 통과) 시 삭제.
 
-### Phase 7: Trace
+## 승인과 루프
 
-```
-/vibe.trace "{feature-name}"
-```
-
-SPEC ↔ 구현 추적.
-
-> **Phase 7 완료 시**: `.vibe/.last-feature` 삭제 (워크플로 완주 — 다음 `/vibe.spec` 호출은 빈 시작 또는 진행 중 작업 목록에서 시작).
-
-## ultrawork 모드
-
-`ultrawork` (또는 `ulw`)가 인자에 포함되면:
-
-- **모든 Stop Gate 스킵**
-- interview → plan → spec → review → run → (figma 병렬) 전체 자동 실행
-- askUser 체크포인트 스킵, 기본값 사용
-- 수동 개입 없이 완주
-
-```
-/vibe.spec "패럴랙스 웹사이트" ultrawork
-```
+SPEC 승인이 `vibe/rules/loop-contract.md` 가 정의하는 **유일한 의무적 사람 개입**이다. 승인 후에는 ANCHOR→ACT→JUDGE→RECORD 루프가 게이트 통과까지 자동 반복한다 (`/vibe.run` → `/vibe.verify`). 별도의 파이프라인 승인·단계별 stop gate 는 없다.
 
-## Smart Resume 예시
-
-### 예시 1: 신규 프로젝트
-```
-User: /vibe.spec "원두 브랜드 랜딩"
-
-Claude: 🔍 Input 분석
-        입력: "원두 브랜드 랜딩"
-        분류: 신규 아이디어
-        기존 파일: 없음
-        → 시작 단계: Phase 1 (interview)
-
-        [interview 스킬 로드]
-        Type: website 감지 → checklists/website.md 로드
-        ...
-```
-
-### 예시 2: 기획서에서 시작
-```
-User: /vibe.spec ".vibe/plans/bean-landing.md"
-
-Claude: 🔍 Input 분석
-        입력: plan 파일 경로
-        분류: 기존 기획서
-        Feature: bean-landing
-        → 시작 단계: Phase 3 (spec)
-
-        [spec 스킬 로드]
-        기획서 읽기 → research → PTCF 작성 ...
-```
-
-### 예시 3: 기존 feature 재개
-```
-User: /vibe.spec "bean-landing"
-
-Claude: 🔍 Input 분석
-        입력: feature name
-        기존 파일 검색...
-          ✅ interview: .vibe/interviews/bean-landing.md
-          ✅ plan: .vibe/plans/bean-landing.md
-          ❌ spec: 없음
-        → 시작 단계: Phase 3 (spec)
-
-        [spec 스킬 로드]
-        ...
-```
-
-### 예시 4: SPEC 리뷰 재실행
-```
-User: /vibe.spec "bean-landing"
-
-Claude: 🔍 Input 분석
-        기존 파일:
-          ✅ spec: .vibe/specs/bean-landing.md
-          ✅ feature: .vibe/features/bean-landing.feature
-
-        이미 SPEC이 존재합니다. 어떻게 진행할까요?
-        1. SPEC 리뷰 (Phase 4: spec-review 스킬 로드)
-        2. /vibe.run 실행 (구현)
-        3. SPEC 재작성 (기존 백업 후 새로 작성)
-        4. 종료
-```
-
-### 예시 5: feature 이름을 잊고 인자 없이 호출 (Smart Resume Fallback)
-```
-User: /vibe.spec
-
-Claude: (.last-feature 읽기 → "bean-landing" 발견)
-
-        🔄 마지막 작업: bean-landing
-        ✅ interview: .vibe/interviews/bean-landing.md  (status: partial, 2일 전)
-        ❌ plan:      없음
-        ❌ spec:      없음
-        → 다음 단계: Phase 2 (plan — 기획서 작성)
-
-        이어서 진행할까요?
-          Enter / yes → 이어서 진행
-          list        → 다른 진행 중 작업 목록 보기
-          new         → 새 아이디어로 시작
-          abort       → 종료
-
-User: yes
-
-Claude: [Phase 2 진입]
-        .last-feature = bean-landing
-        [plan 스킬 로드]
-        ...
-```
-
-### 예시 6: 여러 feature 중 선택 (Fallback list 모드)
-```
-User: /vibe.spec
-
-Claude: (.last-feature 없음 → 디렉토리 스캔)
-
-        🔍 진행 중인 작업
-
-        1. bean-landing      [interview: partial]        2일 전
-        2. todo-app          [plan: complete]            어제
-        3. payment-api       [spec: complete]            방금 전
-        ─────────────────────────────────────────────
-        n. ➕ 새로 시작
-        a. 종료
-
-        선택 번호 또는 feature 이름을 입력하세요:
-
-User: 2
-
-Claude: Feature: todo-app 선택
-        ✅ plan 완성 → Phase 3 (spec) 진입
-        .last-feature = todo-app
-        ...
-```
-
-## Rollback / Resume
-
-- 각 Phase 종료 시 상태가 `.vibe/{interviews,plans,specs,features}/`에 저장됨
-- **`.vibe/.last-feature` pointer**가 각 Phase 진입 시 갱신되어 "가장 최근에 작업한 feature" 추적 (Phase 7 완주 시 삭제)
-- 중단 시 다시 `/vibe.spec`으로 돌아오면 Smart Resume Fallback 동작:
-  - 인자 있음 (`/vibe.spec "feature-name"` 또는 파일 경로) → 해당 feature의 가장 진행된 단계 다음으로 바로 진입
-  - 인자 없음 → `.last-feature` 우선 제안 → 거부하면 진행 중 작업 목록 제시 → 또 거부하면 빈 시작
-- 수동 개입 필요시 스킬 직접 호출 가능 (`Load skill interview` 등)
+- `automationLevel: autonomous` (`.vibe/config.json`) 또는 deprecated `ultrawork`/`ulw` 별칭 → SPEC 승인도 생략, 비대화형 완주.
+- `--interactive` → 회전마다 확인 (과거 기본값).
 
 ## Next Step
 
 ```
-# 전형적인 사용
-/vibe.spec "프로젝트 아이디어"
-
-# 중간 단계 재개
-/vibe.spec "feature-name"
-
-# ultrawork 자동 완주
-/vibe.spec "feature-name" ultrawork
+/vibe.run "{feature-name}"        # 승인된 SPEC 구현 (spec 승인 직후 자동 제안)
+/vibe.verify "{feature-name}"     # Done Criteria 판정 → run-ledger 기록
 ```
 
+trace(`/vibe.trace`)·contract(`/vibe.contract`) 는 사용자가 요청하거나 SPEC 에 API Contract 섹션이 있을 때만 체인한다.
+
 ---
 
 ARGUMENTS: $ARGUMENTS

package/skills/vibe.utils/SKILL.md

@@ -31,7 +31,7 @@ Collection of utility tools. Use with options.
 
 ## --ui (UI Preview)
 
-Read and follow `agents/ui-previewer.md` for UI preview generation.
+Generate the UI preview directly in the main session (native capability — no dedicated agent).
 
 Generate UI preview from description or design folder.
 
@@ -217,7 +217,7 @@ Fix TypeScript/build errors with minimal changes.
 
 ## --clean (Dead Code Removal)
 
-Read and follow `agents/refactor-cleaner.md` for safe dead code removal.
+Perform safe dead code removal directly (native capability — the `/simplify` skill covers reuse/simplification cleanups; this mode handles detection + removal with an audit trail).
 
 Detect and remove unused code with audit trail.
 
@@ -280,7 +280,7 @@ docs/CODEMAPS/
 
 ## --compound (Solution Documentation)
 
-Read and follow `agents/compounder.md` for solution documentation.
+Document the solved problem directly (native capability — no dedicated agent).
 
 Document solved problems for knowledge accumulation.