.cursorrules 재작성
Cursor에서 Windsurf, Zed로 옮길 때마다 룰 파일을 처음부터 다시 짠다.
// 02 — PAIN
AI IDE를 바꿀 때마다,
이런 경험 없나요?
CLAUDE.md 다시 세팅
Claude Code로 갈아탔는데 프로젝트 운영 규칙을 또 처음부터 적는다.
프로젝트 컨텍스트 재설명
새 세션마다 "이 프로젝트는 ~~ 이고 ~~ 하는 거야"를 반복한다.
세션 기록 망각
지난 세션에서 뭘 결정했는지, 어디까지 했는지 기억나지 않는다.
도구는 바뀌어도, 프로젝트의 맥락은 바뀌지 않는다.
VHK가 그 맥락을 지켜준다.
// 03 — FEATURES
32개 명령어, 하나의 CLI.
처음 깔면 `init` 하나로 시작. 이미 쓰고 있다면 `sync`로 IDE 간 규칙 동기화. 나머지는 필요할 때 꺼내 쓴다.
🚀$vhk init
프로젝트 세팅 원클릭
🔄$vhk sync
규칙 파일 동기화
🧠$vhk recap
세션 기록 자동 생성
✅$vhk check
프로젝트 품질 체크
📦$vhk ship
배포 준비 자동화
🔒$vhk secure
보안 스캔
📋$vhk context
프로젝트 맥락 관리
💾$vhk memory
결정사항 기록
바이브코딩 입문자 — 한 줄로 시작
vhk init프로젝트 루트에 `.vhk/` 디렉토리와 기본 규칙 파일을 생성한다. IDE에 맞춰 자동 적용까지.
IDE 간 규칙을 한 곳에서
vhk syncuniversal.md 하나만 관리하면 .cursorrules, CLAUDE.md, AGENTS.md를 자동으로 동기화한다.
// 04 — .VHK/ SPEC
.vhk/ — AI 코딩 컨텍스트의 새로운 표준.
프로젝트 루트에 .vhk/ 하나면, 어떤 AI 도구를 쓰든 맥락이 따라온다. 규칙을 한 번 작성하면, VHK가 IDE별로 변환한다.
// 디렉토리 구조
.vhk/ ├── rules/ │ ├── universal.md ← 마스터 규칙 (한 번 작성) │ ├── .cursorrules ← Cursor용 (자동 생성) │ └── CLAUDE.md ← Claude용 (자동 생성) ├── context/ │ └── project.md ← 프로젝트 정의 ├── memory/ │ └── decisions.md ← 결정사항 기록 └── prompts/ ← 재사용 프롬프트
// 변환 흐름
프로젝트 톤, 코딩 컨벤션, 회피 항목.
코드에 Git이 있듯,
AI 코딩 컨텍스트에도 표준이 필요하다.
// 05 — ROADMAP
VHK는 진화한다.
4단계 로드맵으로 .vhk/ 스펙을 표준까지 끌고 간다.
Layer 1
지금
포터빌리티
컨텍스트를 옮긴다 — 어떤 IDE를 쓰든 .vhk/ 하나로 따라온다.
Layer 2
다음
인텔리전스
컨텍스트가 스스로 진화한다 — 세션마다 학습해 규칙을 갱신.
Layer 3
그 다음
플랫폼
컨텍스트를 공유하고 거래한다 — 팀, 커뮤니티, 마켓플레이스.
Layer 4
최종
프로토콜
.vhk가 AI 코딩 컨텍스트의 업계 표준이 된다.
코드에 Git이 있듯,
.vhk가 AI 코딩 컨텍스트의 업계 표준이 된다.
// 06 — INSTALL
지금 시작하세요.
npm 한 줄이면 끝. `vhk init`으로 첫 프로젝트를 세팅해보세요.
$npm i -g @byh3071/vhk
💬 피드백은 GitHub Issues 또는 디스콰이엇 메이커 페이지로.