5 правил против гниения specs агента
AI Dive
0:00 / 0:00
5 правил против гниения specs агента
1 575 просмотров · 2 недели назад
AI Dive
110 подписчиков
1 575 просмотров · 2 недели назад
Десять разработчиков, четыре отряда, одна папка с документами: как версионировать, закреплять владельца и списывать specs и планы плагина Superpowers, которые коммитит агент.
Полный разбор, главы и транскрипт: https://aidive.dev/ru/videos/spec-pla...
Плагин Superpowers пишет каждый spec и каждый план в docs/superpowers и коммитит их по умолчанию. Так же делает spec-kit, так же делает Kiro, и собственный плейбук Anthropic коммитит артефакт на каждом этапе. На вопрос, куда идут файлы, отвечает любой инструмент. На вопрос, кто ими владеет и когда они мертвы — нет. Это видео о governance для docs/superpowers в реальной команде.
Начинается оно с утечки Okama: восемь написанных агентом планов, отрендеренных как публичные страницы Read the Docs. Затем два других документированных провала: issue 1246, где брейншторм коммитит планы прямо в main, и дрейф в spec-driven разработке — тихий провал, когда spec называет путь, удалённый два спринта назад, а агент в следующем квартале читает его как истину. Различие Биргитты Бёкелер между spec-first и spec-anchored объясняет, почему поведение по умолчанию даёт anchored-хранение при уходе за первым черновиком.
Дальше пять правил. Правило 1: одна папка на отряд с владельцем, через output-пути в CLAUDE.md claude code, записанные императивной строкой, потому что issue 939 показывает, как модель пропускает обычную таблицу, плюс CODEOWNERS для specs агента, чтобы каждое ревью попадало к нужным людям. Правило 2: личное против общего, с CLAUDE.local.md, git-файлом info/exclude и specs, которые пишут в ветке, а не в main. Правило 3: заголовок со статусом, чтобы spec становился superseded, а не молча оказывался неверным — так architecture decision records для AI-specs работают со времён Найгарда в 2011 году.
Правило 4 — это CI-проверка на дрейф spec: скрипт на пятнадцать строк, который читает каждый принятый spec, достаёт названные в нём пути и роняет сборку, если хотя бы один больше не существует. Правило 5 — бюджет размера, подкреплённый цифрами spec-kit против superpowers от Marmelab и OpenSpec bake-off: на 50% больше кода, вдвое дольше, втрое дороже. Spec заслуживает только работа, пересекающая границу отряда.
Вердикт: коммитьте specs и планы плагина superpowers, но управляйте ими как ADR-журналом. Файл CLAUDE, файл CODEOWNERS, заголовок и короткий скрипт. Это процесс, а не инструментарий.
0:00 Десять разработчиков, одна папка
0:44 Каждый инструмент коммитит файлы
1:44 Три сценария провала
3:29 Правило 1: один дом на отряд, с владельцем
4:42 Правило 2: личное против общего
6:02 Правило 3: жизненный цикл, как у ADR
7:30 Правило 4: gate на дрейф в CI
8:45 Правило 5: бюджет размера и его цена
9:57 Вердикт: коммить, потом governance
#ai #aidive #aitools #claudecode #superpowers #specdrivendevelopment #adr