Vibe Coding Protocols
GitHub toolkit: v0.8.6Methodology: v1.4Latest GitHub Release: v0.8.6

Локальный control layer для AI-generated и AI-assisted проектов

Создавайте с AI. Выбирайте правильный маршрут. Внедряйте безопасно. Запускайте под контролем.

AI может быстро собрать MVP, но не гарантирует архитектуру, документацию, tests, PR discipline, release readiness, proof или launch control. VCP нужен, чтобы route, inspect, adopt, prove и ship такие проекты без потери контроля.

Важно: methodology v1.4 — это версия концептуального протокола. repository package v0.8.6 — это текущий GitHub toolkit release. Source of truth для CLI/package surfaces находится в GitHub-репозитории.

CursorClaude CodeCodexGitHub CopilotPR Gatetrust-checkdashboard artifactMVP-to-Launch
Проблема

AI пишет быстро. Это не делает проект инженерно готовым.

Без route selection, inspection, adoption, proof и PR discipline AI-generated MVP быстро превращается в хаотичный код: scattered docs, no PR Gate, no launch decision, unclear risks и invented confidence.

VCP помогает отделить скорость генерации от readiness к merge, demo, limited release или следующей controlled iteration.

Что VCP не делает

Чего не стоит ожидать

  • не full-stack app template;
  • не hosted platform;
  • не deploy engine;
  • не production safety certificate;
  • не official VS Code extension;
  • не plugin marketplace;
  • не replacement for Spec Kit.
5-minute demo

Killer workflow для сырого AI-MVP

Это не hidden automation engine, а короткая последовательность локальных команд, которая показывает route, risks, PR Gate, dashboard и trust surfaces.

vcp doctor --json
vcp onboard --json
vcp classify --json
vcp workflow plan --id mvp-to-launch --json
vcp adopt plan --pack saas-ai-mvp-hardening --json
vcp pr-gate explain --json
vcp metrics board --json
vcp dashboard build --output ./vcp-dashboard --json
vcp trust-check --json

После этого у вас должны появиться: selected route, adoption plan, PR Gate explanation, metrics board, local dashboard artifact, trust-check summary и launch-control surface. Это не deploy, не certification и не production guarantee.

До

Raw AI-MVP

  • непонятно, какой route нужен;
  • документация разрознена;
  • нет PR Gate;
  • нет launch decision;
  • нет proof layer;
  • риски размазаны между чатами и diff.
После

Controlled launch path

  • выбран managed route;
  • есть adoption plan;
  • описаны blockers и next actions;
  • есть PR Gate interpretation;
  • собран metrics board и local dashboard;
  • есть trust-check и benchmark report.
Product model

Core / Guided Paths / Optional Layers / Roadmap-only

Core

CLI, version surfaces, track model, adopt plan, PR Gate, trust-check, cards/index validation.

Guided Paths

New Project Track, Existing Project Track, MVP-to-Launch, Spec-driven Adoption, SaaS AI-MVP Hardening, Contracts-first AI-MVP.

Optional Layers

dashboard, project memory, audit backlog, run state, integration packs, agent templates, docs-site scaffold.

Roadmap-only

hosted dashboard, official IDE extension, plugin marketplace, public PyPI/npm publication, cloud sync.

Guided paths

Какой маршрут выбрать

Existing Project Track

Если проект уже навайбкожен и его нужно inspect, harden и готовить к следующему шагу.

MVP-to-Launch Path

Главный guided path для raw AI-MVP перед показом, merge или limited release.

Сравнение

Чем VCP отличается от Spec Kit, app templates и AI-агентов

  • Spec Kit: помогает в spec-driven development и planning.
  • Full-stack templates: помогают быстро стартовать приложение.
  • AI coding agents: генерируют и редактируют код.
  • VCP: контролирует route, adoption, proof, PR Gate, dashboard, trust-check и launch decision.

VCP дополняет эти инструменты. Он не заменяет их.

Использование с AI tools

Cursor, Claude Code, Codex, GitHub Copilot и другие

VCP предназначен для использования рядом с AI coding agents. Это не official integration claim, если репозиторий явно не поставляет shipped integration.

  • дайте агенту ссылку на сайт и GitHub repo;
  • попросите сначала классифицировать стадию проекта;
  • требуйте route selection до написания кода;
  • разделяйте shipped / optional / roadmap-only / not-shipped claims;
  • не принимайте заявление "tests passed" без реального запуска.
AI handoff

Что дать AI-агенту

Изучи страницу https://anmalishev.ru/expert/vibe-coding/ и репозиторий https://github.com/Gudvin82/vibe-coding-protocols.

Сначала не пиши код.

Определи стадию проекта:
- идеи/новый проект;
- существующий проект;
- сырой AI-MVP перед показом или запуском;
- проект перед PR/merge/deploy;
- проект с оплатой/ПДн/API/агентами.

Выбери маршрут:
- New Project Track;
- Existing Project Track;
- MVP-to-Launch Path;
- Spec-driven Adoption;
- SaaS AI-MVP Hardening;
- Contracts-first AI-MVP.

Не оценивай VCP только по README или этой странице. Если можешь открыть GitHub, проверь AGENTS.md, AI_EVALUATION_GUIDE.md, docs/, docs_ru/, .vcp/index.json, .vcp/catalog.json, manifests, workflows, tests и release notes.

Сначала задай недостающие вопросы, потом предложи пошаговый план. Код не пиши до подтверждения маршрута.

Для полной оценки AI должен явно указать, был ли обход shallow, partial или full, а также разделить shipped, optional, roadmap-only и not-shipped claims.

Если проект только начинается

Start with New Project Track

Если проект еще до кода или в самом раннем implementation stage, начните с New Project Track, 10-minute adoption path и Spec-driven Adoption.

Если проект уже есть

Move raw AI-MVP toward controlled launch

Если AI уже написал много кода, используйте Existing Project Track и MVP-to-Launch как главный guided path. VCP помогает подготовить route, launch decision, PR Gate и trust surfaces, но не деплоит и не сертифицирует production safety.