VHK — AI 코딩 세션을 목표·증거·기억·규칙으로 묶는 한국어 CLI. 규칙 동기화, MCP 35 tools, verify/review/preflight 게이트.
Three tools with Korean descriptions and partial schema coverage. save and undo have input schemas (Zod-defined with optional params and descriptions), but descriptions are in Korean and lack English clarity for international LLM use. status has no input parameters. All three tools lack documented output schemas. Error handling is present (hardStopBlocked, isGitRepo checks) but recovery guidance is minimal. Tool naming is verb-based (save, undo, status) but descriptions do not clearly state when to use each tool or what they return. No parameter constraints (enums, ranges) beyond optional flags. Composition is reasonable (three distinct concerns), but output structure is not documented for LLM planning.
변경사항 저장 (git add → commit → push). 기본은 미리보기 — confirm:true 일 때만 실제 실행(고위험 옵트인).
프로젝트 상태 대시보드 (브랜치/변경사항/최근 커밋)
최근 커밋 되돌리기 (soft reset). 기본은 미리보기 — confirm:true 일 때만 실제 실행.
Descriptions are in Korean; international LLMs may not reliably parse intent. English descriptions required for production use.
No documented output schemas. LLMs cannot plan downstream calls or extract return values. save/undo should document what fields are returned (e.g., preview vs. actual result structure).
save and undo descriptions do not clearly state consequences. 'confirm:true 일 때만 실제 실행' is a critical safety detail but buried in parameter description, not tool description. Tool description must lead with: 'Commits and pushes changes (irreversible). Requires confirm:true to execute; defaults to preview.'
status tool description (30 chars) is too brief. Does not explain what 'dashboard' returns or when to call it. Expand to 50-150 chars with field names and use case.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
No error recovery guidance. hardStopBlocked() returns a text message, but LLM does not know if it should retry, ask user, or abort. Add actionable error classification.