.cursorrules 재작성
Cursor에서 Windsurf, Zed로 옮길 때마다 룰 파일을 처음부터 다시 짠다.
01 / VHK — VIBE HARNESS KIT
VHK.
Your AI Coding
Context, Everywhere.
바이브코딩 풀사이클 CLI — 컨텍스트 + 자율 하네스.
Cursor · Claude · Codex — IDE를 바꿔도 프로젝트 맥락은 그대로. 35개 명령어 · MCP 24 tool · goals 체계로 AI 에이전트가 스스로 목표를 추적한다.
아이디어부터: vhk gate → GO 판정 후 vhk init
명령을 외우지 않아도 된다. 설치 후 vhk만 치면 메뉴가 열린다.
// 02 — PAIN
AI IDE를 바꿀 때마다,
이런 경험 없나요?
CLAUDE.md 다시 세팅
Claude Code로 갈아탔는데 프로젝트 운영 규칙을 또 처음부터 적는다.
프로젝트 컨텍스트 재설명
새 세션마다 "이 프로젝트는 ~~ 이고 ~~ 하는 거야"를 반복한다.
세션 기록 망각
지난 세션에서 뭘 결정했는지, 어디까지 했는지 기억나지 않는다.
도구는 바뀌어도, 프로젝트의 맥락은 바뀌지 않는다.
VHK가 그 맥락을 지켜준다.
// 03 — FEATURES
35개 명령어, 하나의 CLI.
권장 순서: vhk gate → vhk init → 개발 → vhk sync. Cursor·Claude Desktop 에서는 MCP 서버로 24개 tool 을 채팅에서 직접 호출. 아래는 자주 쓰는 핵심 13개 — 전체 명령은 README.
🚦$vhk gate
아이디어 검증 (GO/다듬기)
🚀$vhk init
프로젝트 세팅 원클릭
🔄$vhk sync
RULES.md → IDE 규칙 동기화
🧠$vhk recap
Git 변경 → docs/log/ 세션 로그
✅$vhk check
RULES.md 규칙 린트
📦$vhk ship
출하 전 체크 · 회고 · build-log
🔒$vhk secure
보안 스캔
📋$vhk context
.vhk/context.md 생성
💾$vhk memory
.vhk/memory.json 결정 기록
🎯$vhk goal
Goal 단계별 미션 (init/list/next/check/done)
🚧$vhk blocker
블로커 기록 + HARD_STOP 트립와이어
📚$vhk learn
교훈 기록 (docs/state/learnings.md)
▶️$vhk resume
HARD_STOP 해제 (--confirm 필수)
검증 후 시작
vhk gate퀵 5문항으로 GO/다듬기 판정. 기획이 끝났다면 vhk init --skip-gate.
프로젝트 하네스 생성
vhk initCLAUDE.md, .cursorrules, docs/ 구조를 만든다. 이후 vhk sync로 IDE 규칙을 맞춘다.
IDE 간 규칙을 한 곳에서
vhk syncRULES.md 하나만 관리하면 .cursorrules, CLAUDE.md, AGENTS.md를 자동으로 동기화한다.
MCP 서버로 24개 tool 호출
vhk mcp-init.cursor/mcp.json 자동 생성 → 재시작 한 번이면 채팅에서 vhk status / save / goal / 24개 도구를 자연어로 호출.
// 04 — PROJECT + .VHK/
v1.3 현재프로젝트 루트 + .vhk/ + goals 하네스.
v1.3.x 기준 실제 산출물. RULES.md 동기화 + goals/ 단계별 미션 + docs/state/ SoT + .vhk/HARD_STOP 트립와이어로 AI 에이전트가 스스로 목표를 추적하고 막힐 때 자동으로 멈춘다. Layer 2~4 비전은 아래 로드맵 섹션.
// 디렉토리 구조 (README 정합)
// v1.3 — 프로젝트 루트
RULES.md ← 마스터 규칙 (vhk sync 소스)
CLAUDE.md ← Claude Code
AGENTS.md ← Codex / 범용 에이전트
.cursorrules ← Cursor
docs/
├── log/ ← vhk recap 세션 로그
├── adr/
├── troubleshooting/
└── state/
├── next-task.md ← vhk goal next 산출 (SoT)
├── blockers.md ← vhk blocker (3건 → HARD_STOP)
└── learnings.md ← vhk learn
// v1.3 — goals/ + scripts/ (자율 하네스)
goals/
├── _meta.md
├── 0-mcp-full-coverage.md
├── 1-goal-command.md
└── 2-agent-loop.md
scripts/
├── check-meta.sh
├── check-goal-0.sh
├── check-goal-1.sh
└── check-goal-2.sh
// v1.3 — .vhk/
.vhk/
├── HARD_STOP ← 트립와이어 (gitignored)
├── context.md ← vhk context
├── memory.json ← vhk memory
├── brief.md ← vhk brief
└── refs.json ← vhk ref// vhk sync 변환 흐름
vhk sync의 단일 소스.
배포는 vhk deploy/ publish. 출하 전 점검은 vhk ship.
// 05 — EVOLUTION
VHK는 자라고 있다.
v0.4 (시작 메뉴 + 자연어) 부터 v1.3 (자율 하네스) 까지. minor 단위는 한 줄로 압축, v2.0 부터는 메이저 카드로 묶는다 — 페이지 길이는 화면 1개 이하 유지.
v1.x
v1.0 출시 → v1.3 (2026-05-24 ~ 2026-05-28)
맥락 + 자율 하네스
공개 API 약속 + 맥락·기억·브리프 3종 + 목표 체계 + 자율 루프. 14 → 35 명령어, MCP 8 → 24 도구.
v2.x
2026 하반기
스스로 배우는 맥락 (Layer 2)
맥락이 스스로 진화한다. 세션마다 학습 → 규칙 갱신. 자세한 비전은 아래 로드맵 섹션.
처음엔 한 줄, 누적되면 카드.
스토리는 남기되, 스크롤은 늘지 않는다.
// 06 — ROADMAP
VHK는 진화한다.
Layer 1은 v1.3 현재 — goals 체계 + 자율 루프 + MCP 24 tool 까지 도달. Layer 2~4는 미래 비전 — 인텔리전스, 플랫폼, 프로토콜 단계로 확장한다.
Layer 1
지금
포터빌리티
컨텍스트를 옮긴다 — 어떤 IDE를 쓰든 .vhk/ 하나로 따라온다. goals 체계 + 자율 루프로 AI 에이전트가 스스로 목표를 추적하고, MCP 24 tool 로 IDE 내에서 직접 호출한다.
Layer 2
다음
인텔리전스
컨텍스트가 스스로 진화한다 — 세션마다 학습해 규칙을 갱신.
Layer 3
그 다음
플랫폼
컨텍스트를 공유하고 거래한다 — 팀, 커뮤니티, 마켓플레이스.
Layer 4
최종
프로토콜
.vhk가 AI 코딩 컨텍스트의 업계 표준이 된다.
코드에 Git이 있듯,
.vhk가 AI 코딩 컨텍스트의 업계 표준이 된다.
// 07 — INSTALL
지금 시작하세요.
npm 한 줄이면 끝. 설치 후 vhk만 치면 메뉴가 열린다. 아이디어부터 vhk gate, 통과 후 vhk init.
$npm i -g @byh3071/vhk
💬 피드백은 GitHub Issues 또는 디스콰이엇 메이커 페이지로.