Название и есть тезис: brownfield, а не greenfield. Плагин для Claude Code, который специфицирует изменение работающей системы, а не заявляет новый проект с чистого листа.
Два шага в Claude Code — и плагин доступен. После init он один раз пробегает ваш код и записывает конвенции. Дальше на каждое изменение — три команды.
Открыть на GitHub ↗/plugin marketplace add yknnv/brownspec
/plugin install brownspec@brownspec
/brownspec:init # раз на репо
/brownspec:spec "" # интервью → spec.md
/brownspec:design # blast radius → design.md
/brownspec:tasks # деплойится по шагам → tasks.md init отредактируйте .brownspec/policies.md руками — этот файл плагин трогать не имеет праваSpec-driven разработка сошлась на трёх артефактах — requirements, design, tasks — по хорошим причинам. Что типовое тулинг предполагает: пустой репозиторий. Опишите, что хотите, — получите спецификацию, сгенерируйте код.
Потом вы открываете реальный репозиторий: там шестьдесят сервисов, потребители, которых вы не писали, и изменение, которое должно уехать в прод, ничего не сломав.
Те же три артефакта, но для системы, которая уже работает. Что вокруг них устроено иначе:
Тезис маленький: спецификацию исправить — пять минут. Код, который агент уже написал, — нет.
Каждая фаза дописывает файл после каждого ответа. Прервать интервью и вернуться позже — норма.
Шесть вопросов, а не форма на сорок полей: спрашивается только то, чего репозиторий не может ответить сам. Плюс список политик, которых изменение касается.
Что изменение затрагивает: файлы, публичные контракты, потребители, миграции, откат. С провенансом — где именно в коде это увидели.
Упорядоченные шаги, каждый деплойится отдельно. Без «сначала месяц не деплоим, потом релизим всё разом».
Если проект стартует с нуля — используйте Spec Kit или Kiro. Первая фаза Brownspec — чтение кода, которого ещё нет.
| Предполагает greenfield | Читает ваши конвенции | Blast radius | Регуляторные профили | |
|---|---|---|---|---|
| GitHub Spec Kit | да | нет | нет | нет |
| Kiro (spec mode) | частично | нет | нет | нет |
| Brownspec | нет | да | да, с провенансом | да, opt-in |
Правила Brownspec стреляют, когда вы просите спеку. Они не стреляют, когда вы говорите «сделай это». Именно так задачи обычно и приходят.
Если хотите, чтобы spec-first был поведением по умолчанию, а не тем, что нужно вспомнить, — впишите правило в CLAUDE.md:
/brownspec:spec → /brownspec:design → /brownspec:tasks, а что — «просто сделать».## Specs
Изменение публичного контракта, схемы БД или
больше одного модуля идёт через Brownspec:
/brownspec:spec → /brownspec:design → /brownspec:tasks,
дальше — реализация по tasks.md.
Ниже порога — багфикс, правка копирайта, рефакторинг
внутри одного модуля — пишите код.
Если запрос «просто сделай» и изменение выше порога:
не начинайте. Скажите, что нужна спека, и назовите
команду.В комплекте — публичные регуляции. Ничего не включается по умолчанию.
Профиль policies/ru/152-fz-pdn.md: семь правил про персональные данные под российским законом. Каждое — триггер, который фаза spec может сопоставить, требование и факты, которые спека обязана указать.
Дальше — GDPR. Как только релиз готов, добавится тем же способом.
Профиль применяется только когда вы перечислили его в своей policies.md в списке profiles:. Пока не перечислили — плагин ведёт себя так, будто профиля не существует: ни вопросов, ни разделов в спеке, ни упоминаний в выводе.
Brownspec маршрутизирует, а не сертифицирует. Вывод — «изменение затрагивает PDN-03, поэтому в спеке нужны такие-то факты». Судить, соответствует ли реализация закону, будет ваш DPO или юрист, не плагин.
conventions.md и policies.md — разные файлы?conventions.md плагин генерирует и свободно перегенерирует. policies.md пишут люди — безопасность, архитектура — и плагин его никогда не переписывает. Смешать эти два файла — значит однажды получить регенерацию, которая тихо удалила контроль безопасности и оставила правдоподобно выглядящий документ./brownspec:init в вашем .brownspec/policies.md перечислите под profiles: тот, который нужен: ru/152-fz-pdn. Пока не перечислили — плагин ведёт себя так, будто профиля не существует: ни вопросов, ни разделов в спеке. Профиль маршрутизирует, но не сертифицирует: он указывает на статьи, а не заменяет юриста./plugin marketplace add yknnv/brownspec, затем /plugin install brownspec@brownspec. Один раз на репо: /brownspec:init — плагин пробегает код и записывает conventions.md. Потом на каждое изменение: /brownspec:spec «описание задачи» → /brownspec:design → /brownspec:tasks. Каждое интервью пишет на диск после каждого ответа, так что прерваться можно в любой момент.