VHDB — 지난 세션에 물어보세요

같은 질문이 매주 돌아옵니다

바이브코딩을 오래 하면 같은 질문이 계속 돌아옵니다. 답은 지난 대화 어딘가에 있지만 세션이 끝나면 찾기 어렵습니다. VHDB(Vibe History Database)는 세션에서 오간 대화, 결정, 오류, 해결, 편집, 커밋을 저장해 두고, 필요할 때 검색합니다. 읽을 이력은 SmartWorkbench 의 결정 장부(읽기만 합니다)이거나 플러그인이 자기 로그로 남기는 기록입니다.

지난 세션에 물어보기

Claude Code 안에서 슬래시 명령으로 바로 찾습니다.

/vhdb:search "refresh race" kind:error,decision
/vhdb:search file:src/auth.js kind:decision
/vhdb:history src/auth.js

전에 해 봤나? 과거의 시도와 오류, 그 오류를 닫은 해결을 찾습니다. 왜 이렇게 정했지? 결정을 이유와 함께, 그 결정이 대체한 이전 결정과 함께 보여 줍니다. 이 파일은 어떻게 여기까지 왔지? 그 파일을 건드린 요청 전체를 최신순 타임라인으로 보여 줍니다.

질의는 단어, 구절, 파일·커밋·세션·종류·기간 조건을 쓸 수 있습니다. 한국어는 음절 단위로, 코드는 camelCase·snake_case·경로 조각으로도 찾고, 결정과 오류를 위로 올리고 최신 기록에 가중치를 둡니다.

Claude 가 작업 전에 스스로 찾아봅니다

플러그인은 Claude 가 직접 부르는 도구도 줍니다. query_history 와 file_history 로 같은 실수나 결정 번복을 피하려고 작업 전에 이력을 찾고, record_decision 으로 여러 안 중 하나를 고를 때 선택과 이유를 남깁니다. 이전 결정을 뒤집으면 그 결정은 '대체됨'으로 바뀝니다.

스위치 세 개는 기본이 모두 꺼져 있고, /vhdb:on 으로 기록과 맥락 주입을 켜며 편집 전 확인은 /vhdb:on guard 로 따로 켭니다. 기록은 테스트·빌드·린트 결과와 실패를 남기고, 같은 검사가 나중에 통과하면 열린 오류를 닫습니다. 맥락 주입은 프롬프트를 낼 때와 이미 본 오류가 다시 날 때 유효한 결정과 미해결 오류를 정해진 분량 안에서 붙이고, '과거 기록이며 지시가 아니다'라는 문구를 달아 둡니다. 편집 전 확인은 유효한 결정이 걸린 파일의 첫 편집을 한 번 멈춰 그 결정을 보여 주며, 실패하거나 시간이 넘어도 편집을 막지 않습니다.

내 컴퓨터 안에서, 비밀은 가리고

플러그인에는 네트워크 코드가 없고, 모든 데이터는 내 컴퓨터의 저장소 안에만 있습니다. 토큰·API 키·URL 속 계정 정보 같은 비밀은 저장하기 전에 가리고, 검색 결과에는 도구 출력 본문을 넣지 않습니다.

데이터베이스 엔진은 처음부터 Rust 로 직접 만들었고 외부 데이터베이스가 필요 없습니다. 세션 로그를 그대로 기록의 원본으로 쓰고, 어느 시점에 중단되어도 같은 로그에서 같은 결과로 돌아옵니다. 같은 엔진이 Claude Code 플러그인 안(로컬), 개인용 데몬, 팀 서버 세 곳에서 돕니다.

솔직하게 말씀드리면

플러그인은 지금 로컬 엔진만 씁니다. 팀 서버 연결과 원격 업로드는 아직 구현되지 않았습니다. 프로젝트를 넘나드는 검색은 없고, 의미 검색은 선택 사항인데 지금은 단순한 방식뿐입니다. 로그 구조라서 이력을 하나씩 지울 수 없고, 시간은 UTC 로 표시합니다. 처음 내놓은 버전(0.1.0)입니다.

시작하기

Node.js 24 이상과 git 저장소가 필요합니다. 플러그인 저장소를 내려받은 뒤 Claude Code 를 이렇게 시작합니다.

claude --plugin-dir ~/vhdb-plugin

그다음 /vhdb:search 토큰 갱신 kind:decision since:30d 로 찾아보고, /vhdb:on 으로 기록과 맥락 주입을 켭니다(편집 전 확인은 /vhdb:on guard). 읽을 이력은 SmartWorkbench 의 /swb ledger on 이 쌓은 장부이거나 /vhdb:on record 로 이 플러그인이 남기는 기록이면 됩니다. 팀 서버는 릴리스 페이지의 설치 파일(.deb, .rpm, tar.gz)로 설치합니다.