Vibe Coding Toolkit

Реальный процесс разработки с ИИ-помощью — проверенный в продакшене, а не в теории.

---

О проекте

Программировать с ИИ кажется простым, пока вы не замечаете, что «вставить большой промпт и надеяться» — это не процесс, а лотерея. Vibe Coding Toolkit — противоположность этому: это процесс, который я использую каждый день в настоящем production-коде, чтобы ИИ-агент (в первую очередь Claude Code, но многое справедливо и для Codex от OpenAI) работал как полноценный член команды — а не как гиперактивный стажёр, за которым нужна нянька.

Каждая часть здесь существует потому, что решила реальную проблему: сессии, которые теряли нить разговора; агенты, которые строили больше, чем просили; warnings линтера (инструмента, анализирующего код на рискованные паттерны без запуска), которые никто никогда не обнулял; дорогие уроки, повторявшиеся в каждой новой сессии, потому что ничего не фиксировалось. Ничего не добавлено просто «потому что выглядело классно» — если что-то здесь есть, значит, оно как минимум однажды предотвратило реальную проблему.

Пара слов о прозрачности: практики отсюда взяты из реального приватного production-проекта (финтех, под NDA) — исходный код показать нельзя, поэтому здесь представлен извлечённый и обобщённый метод, а не публичный changelog того проекта. Поэтому история этого репозитория короткая — здесь метод документируется, а не создавался.

Для кого это: разработчики любого уровня — если появляется технический термин, он объясняется тут же, при первом упоминании — которые уже используют или тестируют Claude Code / Codex и хотят структурированный процесс вместо проб и ошибок.

Superpowers — в первую очередь

[!IMPORTANT]

Superpowers, по скромному мнению автора, — самый мощный инструмент всего этого набора. Это не просто очередной плагин — это дисциплина, которая гарантирует, что агент сначала исследует намерение запроса, планирует и только потом пишет код, вместо того чтобы рисковать первой правдоподобной интерпретацией неоднозначного запроса. Всё остальное в этом репозитории поддерживает эту часть; она одна уже меняет поведение всей сессии.

Если вы настроите из этого репозитория только одну вещь — пусть это будет она: прочтите документацию Superpowers перед любым другим инструментом отсюда.

Два других документа заслуживают такого же внимания, даже без «прожектора» стороннего инструмента: оркестрация сабагентов параллельными волнами (протокол, устраняющий коллизии файлов и споры за коммиты на уровне структуры, а не дисциплины — ничего подобного не встречалось ни в одной сторонней коллекции, которую я искал для этого репозитория) и quality gates ESLint/Biome (повышение предупреждения до ошибки как отслеживаемая миграция, границы архитектуры, навязанные через линт). Если Superpowers — двигатель, то эти два — шасси.

Начните здесь

Если вы тут впервые, не пытайтесь читать всё по порядку — сразу идите в полный Playbook. Это гайд по онбордингу с нуля до реального проекта с работающим полным окружением, с примером от начала до конца вместо разрозненной теории.

Пара тизеров того, что вас там ждёт — первые команды, до чего-то более сложного. Заметьте: это «скопируй правильный файл, введи правильную команду» — (пока) не существует установщика, который сам определяет ваш стек и пишет всё за вас. Если нужно именно это — переходите сразу к сокращению aia-harness (/aia-harness:init), оно собирает основу само; остальное в этом репозитории станет материалом для понимания того, что было собрано, а не для ручной сборки с нуля:

npm install -g @anthropic-ai/claude-code
/plugin marketplace add anthropics/claude-plugins-official
/plugin install superpowers@claude-plugins-official
cp templates/CLAUDE.md.template CLAUDE.md

Эти команды устанавливают Claude Code, активируют самый важный инструмент набора и кладут шаблон инструкций проекта на нужное место. Остальное — оркестрация сабагентов, quality gates, память между сессиями — Playbook показывает по порядку, с объяснением зачем нужна каждая часть перед тем, как это устроено.

Или: только ESLint, одной строкой

Если вы не хотите устанавливать ничего из набора, а только хотите получить правила линта этого репозитория в своём проекте — включая потолок 350 строк на файл — вставьте это своему агенту (Claude Code, Codex, Cursor — любому, кто умеет читать URL):

Прочитай промпт из файла 08-eslint-quality-gates-install.md и выполни его в этом проекте. Используй MAX_LINES=350.

Он скачает три уже написанные и протестированные правила, адаптирует конфигурацию под реальную структуру вашего проекта и вернёт список файлов, превысивших потолок. Ничего не исправляет — измерение и исправление это две отдельные задачи.

Когда захотите, чтобы он исправил — замените 08- на 09-file-size-refactor.md: тогда он разобьёт большие файлы на модули поменьше, резав по ответственности (бизнес-логика, UI-компонент, доступ к данным), а не по количеству строк, по одному файлу на коммит, с прогоном тестов и проверкой типов между каждым.

Оба документа целиком: 08 — установить и измерить, и 09 — разбить большие файлы.

Оглавление

• О проекте
• Superpowers — в первую очередь
• Начните здесь
• Полный процесс
• Как использовать этот репозиторий
• Полная документация
• Авторы
• Лицензия

---

Полный процесс

От установки до первого прошедшего ревью коммита — это полный путь, и на нём видно, где каждый инструмент набора вступает в игру. Ключевая часть появляется рано: сабагенты (отдельные экземпляры главного агента, каждый специализирован на своей роли — ревьюер, база данных, тесты) делают основную работу, пока главная сессия только планирует и принимает решения.

На схеме ниже основной путь — линия времени слева направо; круги — вспомогательные инструменты, которые не являются этапами: они активны постоянно и формируют то, как этапы происходят «под капотом». Quality gates — один из таких: защищает каждый коммит, это не одноразовый шаг, который выполнил и забыл.

ИНСТАЛЛЯЦИЯ (Claude Code + плагины)
 → НАСТРОЙКА ПРОЕКТА (CLAUDE.md + hooks)
 → BRAINSTORM → ПЛАН (всё под управлением Superpowers)
 → ОРКЕСТРАЦИЯ САБАГЕНТОВ (параллельные волны)
 → МНОГОАГЕНТНОЕ РЕВЬЮ
 → КОММИТ / ЗАПУСК

Поддерживающие слои (активны постоянно):
 Graphify + Context7 — ориентируют до написания кода
 RTK — удешевляет всю сессию
 Ponytail + Caveman — управляют «что» и «как»
 Память (Claude + Obsidian) — контекст при старте и запись уроков в конце
 Quality gates — защищают каждый коммит

Обратите внимание: RTK, Ponytail, Caveman, граф Graphify (с Context7 рядом, ориентирующим до кодинга) и Quality gates — не остановки на пути, а постоянно активные слои. Одна оговорка про RTK конкретно: он здесь потому, что является реальной частью ежедневного процесса автора, но документирован как паттерн для воспроизведения, а не как публичный бинарник для установки — остальные узлы схемы как раз устанавливаются. А память (система Claude + Obsidian) входит с двух сторон: загружает контекст в начале сессии и записывает, чему стоит научиться, в конце.

Как использовать этот репозиторий

Не существует одного «правильного» способа проходить репозиторий — зависит от того, что вы уже знаете и что ищете сейчас.

• Нужен полный набор с нуля? Идите в Playbook — это направляемый путь шаг за шагом, заканчивающийся реальным проектом, работающим по всему процессу.
• Уже знаете процесс и нужен конкретный инструмент? Справочник по инструментам — каждый файл самодостаточен, не требует прочтения остальных.
• Нужен готовый промпт, чтобы скопировать и адаптировать? В каталоге промптов есть готовые шаблоны: санитизация проекта, burndown линт-предупреждений, многоагентное ревью кода и другие.
• Нужны только файлы конфигурации для вставки в проект? В каталоге шаблонов есть CLAUDE.md.template, пример settings.json для hooks и готовое правило параллельных волн.
• Нужен настроенный ESLint с потолком 350 строк на файл, без ручной настройки? Вставьте своему агенту промпт установки quality gates — он скачает готовые правила из шаблонов, адаптирует под ваш проект и отчитается, сколько файлов превысило потолок — ничего не исправляя. Потом замените 08- на 09-, и агент разобьёт файлы на модули, по одному за раз, с тестом между каждым.

Одно замечание о языке: этот README и все объяснения в документации (как, зачем, туториалы) были на португальском для тех, кто за автором. Единственная часть, намеренно оставленная по-английски, — готовые блоки промптов в каталоге промптов (текст, который вы копируете и вставляете прямо в ИИ-агента) — так работает лучше универсально, независимо от языка читателя. Где концепция специфична для Claude Code (плагины, hooks, skills), в документе это явно указано — большая часть остального работает так же в Codex или любом другом агенте, читающем файл инструкций и выполняющем команды.

Полная документация

Основы

Инструменты

Готовые промпты

---

Авторы

Этот набор не родился из пустоты. Он упаковывает, документирует и связывает в единый процесс работу других людей — стоит познакомиться с оригинальными проектами:

• Superpowers — Anthropic
• Ponytail — Dietrich Gebert
• Caveman — Julius Brussee
• aia-harness — Leandro Silva Ferreira
• Graphify — Graphify Labs
• agent-browser — Vercel Labs

Лицензия

Проект распространяется по лицензии MIT — используйте, копируйте, адаптируйте, распространяйте. Только не подавайте в суд, если что-то сломается. 🙂

---

Сделано с 🤖 + ☕, по одному коммиту за раз.