Vibe Framework v6 — полная методология вайбкодинга

# Vibe Framework v6 ## Что нового в v6 (vs v5.1) - **12 фаз** вместо 7 — добавлены System Analyst Interview, Decomposition, Team Planning - **20 агентов** вместо 4 — requirements-reviewer, business-reviewer, system-analyst, frontend/backend-architect, performance-engineer, и др. - **CLI `vibe`** — Python-утилита с гибридным роутером (Rules First + LLM Fallback) - **Guard-хук** — детерминистично блокирует работу без `vibe route` - **Agent Team Mode** — параллельная работа агентов (Wave→Checkpoint→Wave) - **10 флагов** — --delegate, --seq, --loop, --safe, --magic, --uc, --play, --preview, --trace, --introspect - **3 Review Gate** — requirements-reviewer, business-reviewer на аналитических фазах - **Gate 0: ConfidenceChecker** — ≥90% GO, 70-89% INVESTIGATE, <70% STOP ## Архитектура: Мозг + Команда + Руки + Совесть + Память ``` Мозг (rules/) → Что проверять, когда запускать Команда (agents/) → 20 специализированных агентов Руки (commands/) → 26 команд (/new-project, /deploy, /test...) Совесть (Vibe Runner) → Enforcement: guard + check + discover Память (project-init/) → PLANNING.md, TASK.md, KNOWLEDGE.md, naming.yaml ``` ## Pipeline (12 фаз) | Фаза | Название | S | M | L | |------|----------|---|---|---| | 0 | Context Load + Gate 0 | ✅ | ✅ | ✅ | | 1 | Brainstorming + Review | skip | ✅ | ✅ | | 2 | Business Analysis + Review | skip | opt | ✅ | | 3 | User-Spec + Review | skip | ✅ | ✅ | | 4 | System Analyst Interview | skip | ✅ | ✅ | | 5 | Tech-Spec + Gate 1 | skip | ✅ | ✅ | | 6 | Design System | skip | if UI | if UI | | 7 | Decomposition | skip | ✅ | ✅ | | 8 | Implementation (TDD + SEO) | ✅ | ✅ | ✅ | | 9 | Testing + Gate 2 | ✅ | ✅ | ✅ | | 10 | Deploy + Gate 3 | skip | ✅ | ✅ | | 11 | Growth | skip | opt | ✅ | ## CLI `vibe` (7 команд) ```bash vibe route "сделай лендинг" # Классификация → pipeline JSON vibe check post-code # Enforcement на каждом gate vibe discover # Инвентарь компонентов vibe guard --ensure-routed # PreToolUse хук (блокирует без route) vibe install --env=cli # Установка в проект vibe update # Обновление vibe config --show # Конфигурация ``` ### Гибридный роутер 1. **Pass 1 (Rules)** — ключевые слова RU/EN → тип, размер, UI (бесплатно, <10ms) 2. **Pass 2 (LLM)** — только если confidence <0.8 (Haiku, ~$0.005) 3. **Кэш** — после LLM сохраняет паттерн, со временем LLM вызывается реже ## Quality Gates - **Gate 0** — ConfidenceChecker (≥90%/70-89%/<70%) - **Gate 1** — architect + security-reviewer после Tech-Spec - **Gate 2** — code-reviewer + anti-mirage + SelfCheck после кода - **Gate 3** — pre-deploy: security + health check + rollback ## Anti-Mirage (НИКОГДА не пропускается) Проверка существования каждого файла, импорта, API-эндпоинта, зависимости. Если Claude говорит "файл X существует" — Anti-Mirage проверяет физически. ## Agent Team Mode Для L-задач с ≥3 задачами в Wave: - PM-Agent координирует (НЕ кодит) - Smart Worktree: file-dependency граф определяет изоляцию - Wave→Checkpoint→Wave pipeline - `.team/` директория: plan.md, tasks/, agents/, checkpoints/ ## Установка ```bash # PyPI (когда опубликован) uv tool install vibe-framework vibe install --env=cli --lang=ru # Ручная git clone https://github.com/CheatB/vibe-framework-ru cp -r vibe-framework-ru/.claude vibe-framework-ru/rules your-project/ ``` ## Состав - 16 rules/ файлов (principles, quality-gates, phases, coding-standards, security, database, design, testing, seo, flags, team-mode...) - 26 команд (.claude/commands/) - 20 агентов (agents/registry.md) - 9 скиллов (design-spec, design-tokens, ui-kit, aiogram-bot, legal-compliance, monetization, gtm, analytics-setup, accessibility) - 7 hook-скриптов + 7 hook-инструкций - 4 режима (modes/: delegate, introspect, safe, uc) ## Запреты (enforcement через хуки) - pip запрещён — только uv - Хардкод дизайн-значений → BLOCK - Anti-Mirage → НИКОГДА не пропускается - naming.yaml → не менять без обсуждения - Коммит без тестов → BLOCK ## Философия: Vibe Shift > Не надейся — принуждай. Claude читает правила, понимает их, может цитировать. Но через 5 минут пишет код как будто ничего не было. Проблема не в знаниях — в ENFORCEMENT. Vibe Runner решает это детерминистично: guard-хук блокирует работу, check валидирует каждый этап, compliance log фиксирует результат.