Перейти к содержимому

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