Подробнее про микрофреймворк рассказал в статье на Хабре.

Шаблонный набор skills и примеры rules для Claude Code — каркас для spec-driven разработки в любом проекте. Примеры rules собраны для Python микросервиса.

В основе — три этапа: брейнсторминг идеи → план реализации → выполнение. Скиллы не зависят от стека: всё проектно-специфичное вынесено в CLAUDE.md и rules/.

1. Скопируй CLAUDE.md и skills/ в свой проект, папку rules/ скопируй как .claude/rules/.
2. Заполни CLAUDE.md под свой проект (см. шаблон). Лучше всего попросить Claude Code собрать CLAUDE.md для твоего проекта по шаблону.
3. Адаптируй файлы в rules/example-*.md под стек проекта (или удали неактуальные). Это также можно сделать при помощи Claude Code для твоего проекта, например дополнительно скормив ему какие-то командные документации и т.д.
4. Попробуй что-ниубдь разработать

Пайплайн запускается автоматически через skill-orchestrator, который вызывается в начале каждого разговора и сам решает, нужен ли полный цикл. Для простых задач (мелкий фикс, вопрос, однострочное изменение) оркестратор пропускает этапы пайплайна — использовать его для таких задач было бы переусложнением.

brainstorming  →  writing-plans → executing-plans (использует unit-test-writer) → code-review
      ↓                 ↓                                                               ↓
docs/specs/*.md   docs/plans/*.md                                          update-claude-md
                                                                           commit-and-changes-writer

• brainstorming — превращает идею в спек через диалог. На выходе — docs/specs/YYYY-MM-DD-<тема>-design.md, утверждённый пользователем. Хорошая практика: после написания спека попросить Claude Code перечитать его и назвать оставшиеся открытые вопросы и проблемы — и разобрать их до перехода к плану.
• writing-plans — превращает спек в исчерпывающий план задач с TDD-шагами. На выходе — docs/plans/YYYY-MM-DD-<фича>.md. Хорошая практика: после написания плана попросить Claude Code перечитать его и найти неоднозначности, пропущенные edge cases и риски — и устранить их до начала выполнения.
• executing-plans — выполняет план задача за задачей по TDD-циклу: сначала пишется падающий тест, затем минимальная реализация которая его проходит, затем верификация запуском. Каждый шаг плана считается выполненным только после того как тест зелёный и команда запущена.
• unit-test-writer / code-review — субагенты для тестов и ревью.
• update-claude-md — по завершении фичи синхронизирует CLAUDE.md с реальным состоянием кода, если структура или соглашения изменились.
• commit-and-changes-writer — формирует коммит и описание изменений для MR/QA по итогам выполненной работы. Если описание изменений не нужно — достаточно commit-writer.

Поверх процесса — два дисциплинарных скилла, которые срабатывают всегда:

• systematic-debugging — при любой ошибке/неожиданном поведении: 4 фазы (корневая причина → паттерны → гипотеза → реализация). Никаких фиксов до расследования.
• verification-before-completion — перед любым заявлением «готово» / «работает»: запусти команду, прочитай вывод, потом утверждай.

Каждый этап рекомендуется начинать в свежем контекстном окне — это снижает context rot (деградацию качества на длинных контекстах) и не тащит в следующий этап артефакты предыдущего. next-stage-prompt автоматизирует переход: генерирует готовый промпт с @-ссылкой на нужный файл спека или плана, который можно сразу вставить в новый чат.

Шаблон контекста проекта для агента. Высокоуровневая структура (язык, стек, архитектура, структура кода, тестирование, формат коммитов, подводные камни). Заполняется под проект.

Примеры правил, на которые ссылаются скиллы. Замени содержимое под свой стек, имена файлов оставь:

• example-code-style.md — код-стайл
• example-test-style.md — стиль тестов, фабрики, моки
• example-commit-style.md — формат коммитов и регексп задачи

Можно добавлять свои файлы — например, api-design.md, architecture-decisions.md, infra-conventions.md — и дорабатывать скиллы проекта так, чтобы они ссылались на эти правила. Скиллы читают правила через .claude/rules/..., поэтому достаточно добавить файл и прописать ссылку в нужном скилле.

12 скиллов. Все — на русском, проектно-нейтральные.

• Спек обязателен — даже для «простых» задач (пара предложений тоже считается).
• TDD — сначала падающий тест, потом минимальная реализация, потом верификация.
• Корневая причина важнее симптома — баг не считается исправленным, пока не понятно почему он возник.
• Доказательства раньше утверждений — никаких «должно работать», запускай и проверяй.
• Контекст проекта — в CLAUDE.md и rules/, не в скиллах — скиллы остаются переносимыми.

В наборе намеренно нет скиллов и MCP-серверов для работы с внешними системами: контроль версий (GitHub/GitLab), трекеры задач (Jira, Linear), мессенджеры, CI/CD и т.д. Если это нужно — добавь сам: подключи нужный MCP-сервер и при необходимости напиши скилл, который его использует.

Минимум:

1. Заполни в CLAUDE.md: название проекта, стек, структуру кода и тестов.
2. В .claude/rules/example-*.md оставь то, что применимо, остальное перепиши.
3. Если в проекте есть специфика (например, инфраструктурный скилл для работы с конкретным сервисом) — добавь свой скилл в skills/ и пропиши его в таблице skill-orchestrator.

Этот проект основан на open-source проекте obra/superpowers, распространяемом под лицензией MIT.

Оригинальный проект:

• Repository: https://github.com/obra/superpowers
• License: MIT License
• Copyright: Copyright (c) 2025 Jesse Vincent

В этой версии выполнены перевод на русский язык, адаптация и дополнительные доработки.

Проект распространяется под лицензией MIT. Подробности см. в файле LICENSE.