VibeFrame

에이전틱 코딩을 위한 컨트롤 플레인. VibeFrame은 소프트웨어가 그래야 하는 바 — 비즈니스 의도, 시스템 설계, 그리고 코드 자체 — 에 대한 살아있는 저장소 내 모델(repo model)을 유지하고, 이를 현실과 결정적으로 동기화하며, 둘 사이의 괴리가 발생하는 지점을 보여줍니다.

코딩 에이전트는 누구나 읽을 수 있는 속도보다 빠르게 코드를 작성합니다. 사라지는 것은 바로 이론입니다: 무엇이 존재하는지, 왜 존재하는지, 어떤 결정이 하중을 지탱하는지, 그리고 코드가 결정된 사항과 여전히 일치하는지 여부. VibeFrame은 이 이론을 가장 저렴하게 포착할 수 있는 순간(계획 수립 시점, 에이전트의 자체 MCP 프로토콜을 통해)에 포착하고, 이를 저장소의 일반 파일로 저장하며, 기계적으로 영구 검증하고, 코드베이스를 다시 grep하는 것보다 나은 작업 범위별 컨텍스트 브리프(task-scoped context brief)로 에이전트에게 보답합니다.

• 세 가지 평면, 하나의 그래프 — 기능 및 워크플로우(의도), 컴포넌트 및 제약 조건(시스템), 파일 및 심볼(코드, 100% 파생 — 절대 추측하지 않음).

• 모든 사실에 대한 신뢰 등급 — A 파생 / B 강화 / C 주장; 오래된 정보는 드러나며, 결코 조용히 지나치지 않습니다.

• 증거가 있는 드리프트 감지 — 라이브 반영(reflexion) 모델: 발산, 부재, 끊어진 바인딩, 고아(orphan), 순환, 잠긴 결정의 변경. LLM 호출 0회; 프레임워크는 결정적이고 코딩 에이전트가 지능입니다.

• 저장소 내 모델 — git으로 버전 관리되는 .vibeframe/ YAML/Markdown: 브랜치 안전, PR 리뷰 가능, 어떤 도구에서도 유지됩니다. gitignore된 SQLite 인덱스는 파생되며 재구축 가능합니다.

• 프로젝트당 하나의 데몬 — 단일 프로세스에서 Streamable-HTTP MCP 엔드포인트, REST + SSE, 라이브 브라우저 UI(Map, Focus, Inspector, Activity, Drift 받은 편지함, Decisions)를 제공합니다.

• Claude Code 우선 — 플러그인이 MCP 서버, 결정적 훅, 스킬을 번들로 제공합니다; 또한 이 모델은 AGENTS.md 다이제스트를 통해 모든 에이전트에 서비스를 제공합니다.

설치 (v0.1.0 — 아직 npm에 없음)

릴리스 tarball을 GitHub에서 직접 프로젝트에 설치합니다 (Node ≥ 22.12):

npm i -D https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-core-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-store-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-indexer-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-engine-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-daemon-0.1.0.tgz

(또는 클론에서: npm ci && npm run build && npm pack --workspaces 후 tarball을 npm i -D로 설치합니다. 절대 npm i vibeframe을 하지 마세요 — 해당 이름은 현재 레지스트리의 관련 없는 패키지에 속합니다.)

Related MCP server: Paparats MCP

빠른 시작

npx vibeframe init                              # scaffold .vibeframe/ — commit it
claude mcp add vibeframe -- npx vibeframe mcp   # or install the Claude Code plugin (below)
npx vibeframe start                             # daemon + browser UI (prints the URL)

완전한 Claude Code 경험(MCP 및 결정적 훅과 /vibeframe:* 명령)을 위해, 이 저장소의 플러그인을 Claude Code 내부에 설치하세요 — /plugin marketplace add jubayertalha/vibeframe 후 /plugin install vibeframe — 그리고 위의 claude mcp add 줄은 건너뛰세요 (플러그인이 서버를 포함합니다).

그런 다음 에이전트에게 기능을 계획하라고 요청하세요. 에이전트는 한 번의 vibe_context 호출로 방향을 잡고, 코딩 전에 워크플로우를 선언하며, 구현 후 바인딩합니다 — 그리고 에이전트가 잊어버린 모든 것은 결정적 계층이 잡아냅니다: 위반은 같은 턴의 경고로 돌아오고, 설명되지 않은 변경은 조정을 위해 대기열에 들어가며, 드리프트 받은 편지함은 현실이 계획에서 벗어난 정확한 위치를 file:line 증거와 함께 보여줍니다. 전체 워크스루: docs/getting-started.md.

문서

상태

v0.1.0 — 그린필드 TypeScript/JavaScript/Python 프로젝트에서 완전한 루프: init → declare → index → link → validate → reconcile, 데몬, MCP 도구, 훅, 여섯 개 렌즈 UI 포함. 설계상 연기됨(Discovery 참조): 기타 에이전트 어댑터, 브라운필드 adopt 모드, 심볼 수준 호출 그래프, 팀, 호스팅 서비스.

개발

npm ci && npm run build && npm run check   # lint + typecheck + unit tests
npm run test:dogfood                       # the full-loop acceptance suite

docs/contributing/development.md 및 CLAUDE.md를 참조하세요.

라이선스

MIT