@byh3071/vhk 1.0.1 → 1.3.0

package/README.md

@@ -109,6 +109,33 @@ vhk 기획 끝났고 바로 시작
 | `vhk context-show` | `맥락보기` | 현재 컨텍스트 파일 내용 출력 |
 | `vhk memory` | `기억` | 결정사항 기억 관리 (`add` / `list` / `remove`, `.vhk/memory.json` 기반, 태그 지원) |
 | `vhk brief` | `브리핑` | 프로젝트 정보 + git 상태 + 결정사항 + 레퍼런스 통합 보고서 `.vhk/brief.md` |
+| `vhk goal` | `목표` | Goal 단계별 미션 관리 (`init` / `list` / `next` / `check` / `done`) — vspec/vooster 패턴 |
+| `vhk blocker <설명>` | `블로커` | 블로커 1건 → `docs/state/blockers.md` append. 3건 누적 시 `.vhk/HARD_STOP` 자동 생성 |
+| `vhk learn <교훈>` | `교훈` | 교훈 1건 → `docs/state/learnings.md` append (memory.json 과 별도 SoT) |
+| `vhk resume --confirm` | `재개` | `.vhk/HARD_STOP` 해제 (사람 확인 필요, 자동 호출 금지) |
+
+### 자율 루프 (v1.3+)
+
+`AGENTS.md` 의 Loop Protocol 참조. 단방향 사이클:
+
+```text
+vhk context → vhk goal next → (작업) → vhk goal check → vhk goal done
+                                          ↓ FAIL × 3 cycle
+                                   vhk blocker "<증상>"
+                                          ↓ 3건 누적
+                                   .vhk/HARD_STOP 자동 → 사람 검토 → vhk resume --confirm
+```
+
+### goal 서브커맨드 (v1.2+)
+
+| 서브 | 설명 |
+|------|------|
+| `vhk goal init` | 현재 프로젝트에 `goals/` + `docs/state/` 스캐폴딩 (기존 파일 보존) |
+| `vhk goal list` | `goals/*.md` frontmatter 파싱 → id 순 목록 (status/priority/title) |
+| `vhk goal next` | active goal (IN_PROGRESS → 첫 NOT_STARTED) 선택 → `docs/state/next-task.md` 갱신 |
+| `vhk goal check [--id N]` | `scripts/check-goal-<id>.sh` 실행 (생략 시 active goal) |
+| `vhk goal done [--id N]` | 게이트 재검증 → 통과 시 frontmatter `status: DONE` + `completed: YYYY-MM-DD` |
+| `vhk check --goal N` | 위 `goal check` 의 별칭 (기존 `check` 시그니처 무변경 + optional 옵션) |
 
 ### init 옵션
 
@@ -135,7 +162,16 @@ vhk mcp-init           # .cursor/mcp.json 자동 생성
 # 예: "상태 알려줘" → Cursor가 vhk status 도구 호출
 ```
 
-노출되는 MCP 도구 8개: `save`, `undo`, `status`, `diff`, `ship`, `doctor`, `check`, `recap`.
+노출되는 MCP 도구 **24개** (v1.1):
+
+- **git 워크플로 (8)**: `save`, `undo`, `status`, `diff`, `ship`, `doctor`, `check`, `recap`
+- **환경/규칙 (4)**: `env`, `env-check`, `sync`, `secure`
+- **품질/감사 (3)**: `audit`, `harness`, `mcp-init`
+- **컨텍스트/기록 (4)**: `context`, `context-show`, `memory-list`, `brief`
+- **dry-info (4)**: `deploy`, `publish`, `migrate`, `update` — 인터랙티브 본질이라 실제 실행 안 함, 진단/안내만
+- **레퍼런스 (1)**: `ref-list`
+
+MCP 제외 확정 커맨드 (대화형 본질): `gate`, `init`, `start`, `design palette`, `theme`, `goal` (각각 CLI 에서만 동작).
 
 MCP 서버를 수동으로 띄우려면:
 
@@ -178,7 +214,7 @@ vhk brief               # 세션 종료 시 상태 보고서
 - **공개 API 안정성**: 명령어 이름, CLI 인자, `.vhk/` 파일 포맷은 v2.0까지 breaking change 없음
 - **deprecation 절차**: 명령어/옵션 제거 전 1개 마이너 버전(1.x.0)에서 deprecation 경고
 - **i18n 키**: `ko.ts`의 `t()` 키 이름은 안정. 신규 키 누적, 기존 키 미제거
-- **MCP 서버 도구**: 8개 도구(save/undo/status/diff/ship/doctor/check/recap) 인터페이스 안정
+- **MCP 서버 도구**: v1.0 GA 의 8개 baseline 도구(save/undo/status/diff/ship/doctor/check/recap) 인터페이스 안정 — v1.1 에서 16개 추가되어 총 24개
 
 > **`vhk memory` vs Claude Code `auto memory`** — `vhk memory`는 **프로젝트 단위** 결정사항(`.vhk/memory.json`, 팀 공유). Claude Code의 `auto memory`는 **사용자 단위** (`~/.claude/projects/.../memory/`, 개인 컨텍스트). 둘은 별개.