Superpowers + Compound V
Связка из двух плагинов для реальной работы силами ИИ-команды: обсудить спецификацию, провести аудит местности, спланировать непересекающееся разбиение, затем направить каждую задачу нужной модели и бэкенду параллельно за жесткими воротами ревью, и все это с накоплением памяти о том, что было изучено.
A Золотой путь
идея → влито в main
Один раз на проект: /v:init - определить бэкенды, выбрать стратегию маршрутизации, сохранить конфиг. Дальше на каждую фичу:
Обсуди спецификацию superpowers
Скажи brainstorm <idea> (или "давай сделаем X"). Диалог по одному вопросу за раз + 2-3 подхода → утвержденная спецификация в docs/superpowers/specs/. Жесткое правило: ни строчки кода до утверждения дизайна.
Предполетные аудиты настоящий "онбординг"
Три агента параллельно изучают территорию - code-archaeologist (что уже есть), domain-expert (правила предметной области), doc-validator (реальное состояние библиотек и API). /v:archaeology запускает только аудит кода.
Спланируй разбиение superpowers
Спецификация → план по кусочкам с проверенной картой разбиения: непересекающиеся пути записи на каждую задачу, чтобы агенты никогда не сталкивались.
Кросс-модельное ревью плана по значимости
/v:review-plan - другое семейство моделей (Codex) состязательно проверяет план в режиме только для чтения; решение принимаешь ты. Запускай для безопасности / авторизации / платежей / миграций, крупных разбиений или архитектурных изменений.
Материализуй манифест
/v:orchestrate записывает manifest.yaml + state.json. Он не запускает диспетчеризацию - сначала просмотри или отредактируй.
Запусти параллельно
/v:dispatch - пакетное выполнение через несколько бэкендов. Сначала ворота partition-reviewer + validate-manifest; после каждой задачи срабатывает скоуп-гейт по git-диффу. Голый путь к плану материализуется автоматически.
Восстанови и проверь
/v:resume сверяет состояние с git (git побеждает) и перезапускает только незавершенные задачи. /v:status показывает фазу, таблицу по задачам и состояние бэкендов.
Ворота ревью → доработка → merge
Три прохода - SPEC → QUALITY → INTEGRATION, проверяет другое семейство моделей. Любая проблема возвращает задачу на доработку, затем повторное ревью. Мержится только когда все зеленое. Никаких "и так сойдет".
Фазы: SPEC_READY → PREFLIGHT_DONE → PARTITION_VERIFIED → DISPATCHED → COLLECTED → REVIEWED → MERGED · /v:epic объединяет несколько фич в одну автономную, возобновляемую сборку с учетом зависимостей - каждая проходит весь путь выше.
B Команды Compound V
/v:*
.claude/compound-v.json.docs/superpowers в локальный кэш V-memory.C Скиллы Superpowers
не команды · срабатывают автоматически
| Скилл | Триггер и назначение |
|---|---|
| brainstorming | "давай сделаем X" → диалог → утвержденная спецификация. Ни строчки кода до утверждения. |
| writing-plans | спецификация → план по задачам (пути, код, TDD, коммиты). |
| subagent-driven-development | рекомендуется отдельный субагент на задачу + двухэтапное ревью. |
| executing-plans | последовательное выполнение с контрольными точками (отдельная сессия). |
| test-driven-development | RED → GREEN → REFACTOR. Никакого продакшн-кода без падающего теста. |
| verification-before-completion | запусти реальную команду прямо сейчас, прежде чем заявлять о готовности. |
| systematic-debugging | сначала корневая причина, потом фикс; 3+ неудачных фикса = проблема архитектуры. |
| requesting / receiving-code-review | субагент-ревьюер на реальном диффе; проверяй фидбэк перед применением. |
| using-git-worktrees | изолированное рабочее пространство; сначала проверить существующую изоляцию. |
| finishing-a-development-branch | merge / PR / оставить / отбросить, затем убрать за собой. |
D V-memory
семантическая память проекта
Локальный слой памяти поверх прозы docs/superpowers/** - спецификации, планы, ревью, аудиты, извлеченные уроки. Отвечает на вопрос "мы уже такое видели?" по смыслу, а не по grep имени файла, и растет вместе с проектом: каждый закоммиченный план и постмортем становится доступным для поиска при следующем обновлении. Он остается вспомогательным - свидетельство для планирования и ревью, никогда не вход для маршрутизации.
FTS5 - BM25, всегда включен, чистый stdlib, офлайн, мгновенно. Надежная основа.
Embeddings - multilingual-e5-small, опционально, кэшируется вне репозитория. Включается для крупных корпусов; если отсутствует → молча остается только FTS5.
recall-check: паттерн файлов с ≥2 предыдущими заблокированными/ошибочными задачами → вердикт tighten (принудительный worktree / +1 ревью / объединение в Task 0). Только консервативно - может лишь ужесточать.
# извлечь прошлый контекст как свидетельство /v:remember "notion oauth token refresh" # переиндексация (+ опциональная семантическая полоса) /v:memory-refresh --with-embeddings # сам движок, напрямую python3 scripts/compound-v-memory.py bootstrap # ЕДИНСТВЕННЫЙ сетевой шаг python3 scripts/compound-v-memory.py refresh --with-embeddings python3 scripts/compound-v-memory.py search "<q>" --intent planning python3 scripts/compound-v-memory.py doctor # индекс / venv / состояние
E Бэкенды и маршрутизация
кто что делает
V маршрутизирует по уровню, а не по жестко заданной модели - конкретная модель определяется при диспетчеризации из обновляемой карты (/v:models), поэтому конфигурация переживает смену моделей. haiku никогда не используется.
механические правки в одном файле, документация, i18n, четко специфицированный CRUD.
ограниченная сборка фичи, включая крупную изолированную работу Codex.
архитектура, чувствительные поверхности, новые тесты, внешние API, каждый ревьюер, Task 0.
| Бэкенд | Доверие | Роль |
|---|---|---|
| claude | доверен ядром, в основном процессе | по умолчанию; Task 0, чувствительные поверхности, ревьюеры, документация |
| codex | в песочнице ядра worktree | рекомендованный союзник для крупной изолированной сборки |
| antigravity | пониженное доверие worktree | опциональные дополнительные руки, только доверенная поверхность |
| cursor | пониженное доверие worktree | тот же уровень и оговорки, что у antigravity |
- ревьюеры ⇒ deep (opus)
- codex / antigravity / cursor ⇒ worktree
- run: parallel ⇒ isolation: worktree
- неясный скоуп ⇒ назад к планированию
- скоуп-гейт: любая запись вне
write_allowed⇒ блокируется, никогда не мержится
Стратегии (выбираются при /v:init): Balanced (по умолчанию, с Codex) · Claude-only (если Codex отсутствует → строки сворачиваются к claude/deep) · Conservative · Cost-aware - но чувствительные поверхности и ревьюеры остаются deep при любой стратегии.
F Оптимальная настройка
подписки
Финансирует работу deep / reviewer / Task-0 - архитектуру, каждую чувствительную поверхность, всех ревьюеров. Это то, на чем никогда не экономят ни при одной стратегии, поэтому нужен бэкенд с максимальным доверием, работающий в основном процессе.
Работает как собственный изолированный процесс/worktree, поэтому крупные сборки распараллеливаются за пределами тарелки Claude - а другое семейство моделей дает декорреляцию ошибок, на которой построен слой ревью. Дешевле, чем второе место Opus.
Дополнительная параллельная мощность, имеет смысл добавлять только когда есть доверенная работа с узким радиусом поражения - нет ограничения записи на уровне ядра, поэтому гейт обнаруживает утечки, но не может предотвратить побочные эффекты за пределами worktree.
Плагин запрещает выдуманные цифры затрат/токенов ("anti-ruflo"), поэтому все остается на уровне тарифных планов подписки - место за $200 финансирует работу, на которой нельзя сэкономить; место за $100 финансирует параллельную пропускную способность плюс второе мнение.
Обсуди спецификацию → проведи аудит местности → спланируй непересекающееся разбиение → дай V направить каждую задачу нужной модели и бэкенду параллельно → поставь все за ворота (скоуп + трехпроходное кросс-модельное ревью) → доработай упавшее → влей в main. V-memory тихо запоминает все это, поэтому следующий прогон стартует умнее.