@su-record/vibe 2.13.0 → 2.14.0

package/skills/vibe.run/references/ultrawork-mode.md

@@ -1,24 +1,26 @@
-# ULTRAWORK Mode — Full Reference
+# ULTRAWORK Mode — Automation Level Reference
 
 > Loaded by vibe.run SKILL.md when user includes `ultrawork` or `ulw` keyword.
+>
+> **루프 시맨틱(ANCHOR/ACT/JUDGE/RECORD/stuck/max_iterations)의 SSOT는 `vibe/rules/loop-contract.md`다.** `ultrawork`/`ulw`는 `automationLevel: autonomous` + 병렬 ACT의 deprecated 별칭이다. 루프 자체는 모든 실행의 기본 동작이며, ultrawork는 그 루프를 자율(비대화형)·병렬 모드로 돌리는 축을 제어한다.
 
-## What ULTRAWORK Enables
+## What `automationLevel: autonomous` Enables
 
-When you include `ultrawork` (or `ulw`), ALL of these activate automatically:
+`ultrawork` (또는 `ulw`, `.vibe/config.json`의 `automationLevel: autonomous`) 설정 시 활성화:
 
 | Feature | Description |
 |---------|-------------|
-| **Parallel Exploration** | 3+ Task(haiku) agents run simultaneously |
-| **Boulder Loop** | Auto-continues until ALL phases complete |
+| **Parallel Exploration** | 3+ Task(haiku) agents run simultaneously (ACT 병렬화) |
+| **Loop (기본 동작)** | 모든 실행의 기본 — exit=게이트 통과 또는 stuck 또는 max_iterations |
 | **Context Compression** | Aggressive auto-save at 70%+ context |
-| **No Pause** | Doesn't wait for confirmation between phases |
+| **No Pause** | stuck·SPEC 게이트 외 확인 없음 (`automationLevel: autonomous`) |
 | **External LLMs** | Auto-consults GPT/Antigravity if enabled |
-| **Error Recovery** | Loops until 100% or stuck; on stuck auto-records TODO and proceeds (no user prompt) |
-| **Race Review (v2.6.9)** | Multi-LLM review (GPT+Antigravity) with cross-validation |
+| **Error Recovery** | stuck 시 TODO 기록 후 다음으로 (사용자 질문 없음) |
+| **Race Review** | Multi-LLM review (GPT+Antigravity) with cross-validation |
 
-## Boulder Loop (Inspired by Sisyphus)
+## Boulder Loop — Parallel ACT Visualization
 
-Like Sisyphus rolling the boulder, ULTRAWORK **keeps going until done**:
+루프 자체는 loop-contract의 기본 동작이다. Boulder Loop는 `automationLevel: autonomous`에서 **병렬 ACT**가 어떻게 실행되는지를 보여주는 다이어그램이다:
 
 ```
 ┌─────────────────────────────────────────────────────────────────┐
@@ -45,23 +47,24 @@ Like Sisyphus rolling the boulder, ULTRAWORK **keeps going until done**:
 │                       ↓         ↓                                │
 │                   [Continue]  [Complete!]                        │
 │                                                                  │
-│   NO STOPPING until acceptance criteria met or error limit hit   │
+│   loop-contract EXIT: 게이트 통과 │ stuck │ max_iterations       │
 └─────────────────────────────────────────────────────────────────┘
 ```
 
-## ULTRAWORK Example Session
+## Example Session (automationLevel: autonomous)
 
 ```
 User: /vibe.run "brick-game" ultrawork
 
 Claude:
-ULTRAWORK MODE ACTIVATED
+AUTONOMOUS MODE (automationLevel: autonomous)
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 SPEC: .vibe/specs/brick-game.md
 4 Phases detected
-Boulder Loop: ENABLED (will continue until all phases complete)
-Auto-retry: ON (loop until 100% or stuck → auto-TODO)
+Loop: ENABLED (exit = 게이트 통과 | stuck | max_iterations=10)
+Parallel ACT: ON
+automationLevel: autonomous (stuck → auto-TODO, no confirmation)
 Context compression: AGGRESSIVE
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -101,37 +104,37 @@ Retries: 2
 Context saved: 3 checkpoints
 ```
 
-## Normal vs ULTRAWORK Comparison
+## confirm vs autonomous Comparison
 
-| Aspect | Normal | ULTRAWORK |
-|--------|--------|-----------|
-| Phase transition | May pause | Auto-continues |
-| On error | Reports and stops | Auto-retries (3x) |
+| Aspect | `automationLevel: confirm` (default) | `automationLevel: autonomous` (ultrawork) |
+|--------|--------------------------------------|-------------------------------------------|
+| Loop | ANCHOR→ACT→JUDGE→RECORD (기본 동작) | 동일 |
+| Confirmation gates | stuck·SPEC에서 질문 | stuck 포함 전부 skip → TODO |
+| On error | Reports, asks before retry | Auto-retries, auto-TODO on stuck |
 | Context 70%+ | Warning only | Auto-compress + save |
 | Exploration | Sequential possible | FORCED parallel |
-| Completion | Phase-by-phase | Until ALL done |
 
 ## Automation Level System
 
-Magic keywords in the user input automatically set the **AutomationLevel**, which controls how much the AI self-advances vs. pausing for confirmation.
+**automationLevel**은 루프가 사람 개입 없이 얼마나 자율적으로 진행하는지를 제어한다. `.vibe/config.json`에서 설정하거나, deprecated 별칭 키워드로 런타임 오버라이드 가능.
 
 ### Level Definitions
 
-| Level | Name | Keyword(s) | Auto-advance | Auto-retry | Stuck Behavior | Parallel Agents | Checkpoints |
-|-------|------|------------|--------------|------------|----------------|-----------------|-------------|
+| Level | Name | 설정 방법 | Auto-advance | Auto-retry | Stuck Behavior | Parallel Agents | Checkpoints |
+|-------|------|-----------|--------------|------------|----------------|-----------------|-------------|
 | L0 | Manual | `manual` | No | No | Ask user every step | No | All |
-| L1 | Guided | `guided`, `verify` | No | No | Ask user on stuck | No | All |
-| L2 | Semi-auto | `quick` (default) | Yes | Yes (low cap: 2) | Ask user after 2 retries | No | Key points |
-| L3 | Auto | `ultrawork`, `ulw` | Yes | Yes (no cap) | Auto-TODO + proceed | Yes | Checkpoint-only |
-| L4 | Full-auto | `ralph`, `ralplan` | Yes | Yes (no cap) | Auto-TODO + proceed | Yes | None |
+| L1 | Guided | `guided`, `verify`(deprecated) | No | No | Ask user on stuck | No | All |
+| L2 | confirm | default | Yes | Yes (low cap: 2) | Ask user after 2 retries | No | Key points |
+| L3 | autonomous | `automationLevel: autonomous` / `ultrawork`(dep) / `ulw`(dep) | Yes | Yes (no cap) | Auto-TODO + proceed | Yes | Checkpoint-only |
+| L4 | Full-auto | `ralph`(deprecated) / `ralplan`(deprecated) | Yes | Yes (no cap) | Auto-TODO + proceed | Yes | None |
 
-### Detection Rule
+### Detection Rule (deprecated aliases)
 
 ```
-/vibe.run "login"              → L2 Semi-auto (default)
-/vibe.run "login" ultrawork    → L3 Auto
-/vibe.run "login" ralph        → L4 Full-auto
-/vibe.run "login" verify       → L1 Guided
+/vibe.run "login"              → L2 confirm (default)
+/vibe.run "login" ultrawork    → L3 autonomous (deprecated alias)
+/vibe.run "login" ralph        → L4 Full-auto (deprecated alias, exit=coverage-100)
+/vibe.run "login" verify       → L1 Guided (deprecated alias)
 ```
 
 ### Confirmation Matrix

package/vibe/rules/loop-contract.md

@@ -0,0 +1,54 @@
+# Loop Contract — vibe 실행의 기본 계약 (SSOT)
+
+> `/vibe`의 기본 동작은 **단계별 1회 실행이 아니라 완성까지의 루프**다.
+> 루프가 기본이 될 수 있는 이유: 폭주 방어가 모델의 양심이 아니라 결정론적 가드(코드)이기 때문.
+> 이 문서가 루프 시맨틱의 유일한 정의다 — ralph/Boulder/Convergence 등 과거 명칭은 전부 이 계약의 파라미터로 환원된다.
+
+## 적용 범위
+
+- **적용**: 검증 가능한 목표가 있는 실행 — `vibe.run`, `vibe.verify`, `vibe.review`, `vibe.loop` 및 이들을 체인하는 `/vibe` 파이프라인
+- **제외**: 단발 조회·생성 작업 (`vibe.docs`, `vibe.analyze`, `vibe.scaffold` 등) — 루프 의례를 강제하지 않는다
+
+## 계약
+
+```
+/vibe {요구사항}
+  → SPEC 확정  ← 유일한 의무적 사람 개입 지점 (DONE의 정의 = REQ-ID + 수용 기준 승인)
+  → 루프:
+      ANCHOR   디스크에서 재고정: SPEC + run-ledger + scope.json (+ 직전 인박스)
+      ACT      파이프라인 실행 (스킬 체인)
+      JUDGE    결정론 판정만 인정: run-ledger verifyPassed │ 테스트 exit code │ RTM status
+               — 모델의 "완료했습니다" 자기 보고는 종료 조건이 될 수 없다
+      RECORD   run-ledger(현재 회전) + loop-history.jsonl(회전 이력, 스케줄 루프)
+  → 종료(EXIT): 게이트 전부 통과 │ stuck │ max_iterations │ 예산 상한
+```
+
+### ANCHOR가 컨텍스트 오염 방어인 이유
+루프 상태는 컨텍스트가 아니라 디스크에 산다. 매 회전이 아티팩트에서 다시 시작하므로 컨텍스트가 오염되거나 compact로 소실돼도 루프는 깨지지 않으며, 회전마다 fresh 컨텍스트(서브에이전트)로 돌려도 된다.
+
+### stuck (결정론)
+연속 2회 회전의 발견(discover/findings) 해시가 동일 → 중단하고 사람에게 (`loop-ledger.js check-stuck`이 판정·기록). "다시 해보면 될 것 같다"는 모델 판단으로 무시 금지.
+
+## 파라미터 (기본값)
+
+| 파라미터 | 기본 | 의미 |
+|---|---|---|
+| `max_iterations` | 10 | 회전 상한. 도달 시 잔여를 인박스로 이월 |
+| `exit` | 게이트 통과 (P1=0 ∧ verifyPassed) | 종료 기준. coverage 100% 등으로 상향 가능 |
+| `--interactive` | off | 단계별 확인 모드 (회전마다 사람 승인 — 과거의 기본값) |
+| `--max-iter N` | — | 회전 상한 명시 (N=1이면 1회 시도) |
+| `automationLevel` | `confirm` | `confirm`(SPEC·stuck에서 질문) / `autonomous`(기록 후 계속, 비대화형) — `.vibe/config.json` |
+
+## 금지 (루프 권한 경계)
+
+루프는 push·release·배포·버전 범프를 수행하지 않는다. 커밋은 auto-commit verify 게이트 통과 시만. 결과는 인박스(사람 리뷰 큐)로.
+
+## Deprecated 별칭 (하위 호환 매핑 — 새 문서에서 가르치지 않는다)
+
+| 별칭 | 환원 |
+|---|---|
+| `ralph` | 기본 동작과 동일 (no-op). 굳이 구분하면 `exit: coverage-100` |
+| `verify` | 기본 동작과 동일 (no-op) — JUDGE는 항상 결정론 검증 |
+| `quick` | `--max-iter 1` + 최소 JUDGE |
+| `ralplan` | 같은 계약을 계획 단계에 적용 |
+| `ultrawork` / `ulw` | `automationLevel: autonomous` + 병렬 ACT — 루프 시맨틱이 아니라 자율성·병렬성 축 |

package/vibe/templates/loop-template.md

@@ -0,0 +1,69 @@
+---
+name: {loop-name}
+trigger: scheduled
+schedule: "0 2 * * *"
+goal: "{사람이 읽는 루프 목표 — 한 문장}"
+discover: |
+  {일거리를 발견하는 지시문.
+  여러 줄 사용 가능.
+  예: .vibe/regressions/open/*.md 를 스캔해 우선순위 높은 항목을 반환한다.}
+pipeline:
+  - vibe.spec
+  - vibe.run
+  - vibe.verify
+verify: ledger
+max_iterations: 10
+isolation: none
+status: active
+---
+
+# 루프: {loop-name}
+
+## 목적
+
+{이 루프가 자동화하는 작업과 그 이유를 1–3문장으로 설명한다.}
+
+## Discover 상세
+
+{`discover` frontmatter 필드의 상세 설명.
+루프 런타임이 어떤 소스를 보는지, 어떤 형식으로 항목이 반환되는지 기술한다.
+
+예시:
+- 스캔 대상: `.vibe/regressions/open/`
+- 반환 형식: `- REQ-XXX-NNN: 설명` 불릿 목록
+- 빈 결과 처리: 항목 없을 시 루프 즉시 종료}
+
+## 항목별 파이프라인
+
+{`pipeline` frontmatter에 나열된 각 스킬이 단일 항목에 대해 수행하는 작업을 설명한다.
+
+| 단계 | 스킬 | 입력 | 출력 |
+|------|------|------|------|
+| 1 | vibe.spec | 항목 설명 | SPEC 파일 |
+| 2 | vibe.run | SPEC | 구현 |
+| 3 | vibe.verify | 구현 | 검증 결과 |
+}
+
+## 종료 조건
+
+{루프가 단일 항목 처리를 완료로 판정하는 조건을 명시한다.}
+
+- `verify: ledger` — `.vibe/metrics/run-ledger.json`의 `verifyPassed === true` (모델 자기 보고 불가)
+- `verify: tests` — `test_command` exit code 0
+- `verify: none` — 파이프라인 마지막 스킬 완료 시
+- 연속 2회 `discoverHash` 동일 → stuck으로 중단, 인박스 기록
+
+## 인박스 보고 형식
+
+{각 반복 완료 후 `.vibe/loops/inbox.md`에 추가되는 항목 형식.}
+
+```
+## [{loop-name}] {YYYY-MM-DD HH:mm}
+
+- **결과**: ok | fail | stuck
+- **처리한 항목**: {항목 설명}
+- **검증 상태**: verifyPassed=true | false
+- **리뷰 필요**: {사람이 확인해야 할 사항. 없으면 "없음"}
+```
+
+> 루프는 push·release·배포를 수행하지 않는다. auto-commit verify 게이트 통과 시 커밋까지만.