Superpowers + Compound V
Зв'язка з двох плагінів для реальної роботи з AI-командою: обміркуй специфікацію, проведи розвідку території, сплануй роздільний поділ, а тоді розподіли кожне завдання на потрібну модель і бекенд паралельно за жорсткими гейтами перевірки, і все це запам'ятовується.
A Золотий шлях
ідея → змерджено
Один раз на проєкт: /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-diff запускається після кожного завдання. Голий шлях до плану матеріалізується автоматично.
Відновлення й перевірка
/v:resume звіряє стан з git (git головний) і перезапускає лише незавершені завдання. /v:status показує фазу, таблицю по завданнях і стан бекендів.
Гейт рев'ю → доробка → мердж
Три проходи: 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 | субагент-рев'юер на реальному diff; перевіряй фідбек перед застосуванням. |
| using-git-worktrees | ізольоване робоче середовище; спершу перевір наявну ізоляцію. |
| finishing-a-development-branch | мердж / PR / залишити / відхилити, потім прибрати за собою. |
D V-memory
семантичне пригадування проєкту
Локальний шар пригадування поверх прози docs/superpowers/**: специфікації, плани, рев'ю, аудити, висновки. Відповідає на питання "чи бачили ми таке раніше?" за змістом, а не грепом по назвах файлів, і накопичується з ростом проєкту: кожен план і постмортем, який ти комітиш, стає доступним для пошуку після наступного оновлення. Залишається другорядним: доказ для планування й рев'ю, ніколи не вхідні дані для маршрутизації.
FTS5, BM25, завжди увімкнено, чиста стандартна бібліотека, офлайн, миттєво. Надійна основа.
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 / рев'юер / Task-0: архітектуру, кожну чутливу поверхню, всіх рев'юерів. Саме це ніколи не оптимізується за вартістю в жодній стратегії, тож потребує найбільш довіреного, у-процесі бекенда.
Працює як власний ізольований процес/worktree, тож великі збірки розпаралелюються поза навантаженням Claude, а інша родина моделей дає декореляцію помилок, на якій побудований шар рев'ю. Дешевше за друге місце Opus.
Додаткова паралельна потужність, варта додавання лише коли в тебе є довірена робота зі збірки з вузьким радіусом ураження: немає обмеження запису на рівні ядра, тож гейт виявляє витоки, але не може запобігти побічним ефектам поза worktree.
Плагін забороняє вигадані цифри вартості/токенів ("anti-ruflo"), тож це залишається на рівні підписки: місце за $200 фінансує роботу, яку не можна здешевити; місце за $100 фінансує паралельну пропускну здатність плюс другу думку.
Обміркуй специфікацію → проведи розвідку території → сплануй роздільний поділ → дай V розподілити кожне завдання на потрібну модель + бекенд паралельно → постав усе під гейт (скоуп + 3-прохідне крос-модельне рев'ю) → доопрацюй те, що не пройшло → змерджуй. V-memory тихо запам'ятовує все це, тож наступний запуск починається розумнішим.