Приложение C. Чек-листы прикладного SDD
Это приложение можно использовать как быстрый справочник во время прикладного цикла. Оно надстраивается над приложением C первого тома: базовые чек-листы перед спецификацией, реализацией и слиянием там не дублируются. Шаблоны процесса (запрос на слияние, ретроспектива, минимальные запросы для /clear и перепланирования) перенесены в [examples/templates/](examples/templates/): pr-template.md, retrospective.md, clear-prompt.md, replan-prompt.md.
Перед началом прикладного тома
- [ ] Прочитана часть 0, выбран один учебный incident-case.
- [ ] Понятно, какие команды в главах имеют статус
[runnable], а какие помечены как[project script]. - [ ] Создан или запланирован каталог
capstone/для итогового пакета. - [ ] Из первого тома понятны
requirements.md,plan.md,validation.md,QWEN.mdи пакет доказательств. - [ ] Выбран режим чтения: учебный минимум или полный production-трек.
Перед восстановлением спецификации из унаследованной системы
- [ ] Все источники перечислены с владельцем и ссылкой.
- [ ] Время событий нормализовано.
- [ ] Требования отделены от фонового контекста.
- [ ] Каждое утверждение имеет доказательство или помечено как гипотеза.
- [ ] Спорные пункты не попали в утверждённый контракт.
Перед запуском ядовитой спецификации
- [ ] Внесён ровно один дефект.
- [ ] Описан ожидаемый симптом сбоя.
- [ ] Есть критерий восстановления.
- [ ] Исправление должно менять spec/plan/validation, а не только объяснение.
Перед включением шлюза спецификации (Spec CI)
- [ ] У требований есть стабильные
REQ-*идентификаторы. - [ ] Пункты плана ссылаются на требования.
- [ ] Проверка области охвата опирается на доменную модель или API-контракт.
- [ ] JSON-примеры из
validation.mdвалидируются схемой. - [ ] CI-ошибка содержит файл, строку, правило, причину и действие.
Перед файловым арбитражем спорного изменения
- [ ] Роли Координатор, Имплементор и Верификатор описаны заранее.
- [ ] Верификатор принимает только проверяемые доказательства.
- [ ] Спор разрешается различиями (diff) в файлах, а не аргументами в чате.
- [ ] Повторяющиеся решения попадают в
precedents.md. - [ ] Есть стоп-условие для ручного ревью.
Перед оптимизацией production-метрик
- [ ] Целевая метрика отделена от инвариантов качества.
- [ ] Есть правило красной кнопки для сценария Гудхарта.
- [ ] Реплей проверяет не только агрегаты, но и дрейф поведения.
- [ ] След содержит источник решения, версию политики, хэш подсказки или иной воспроизводимый идентификатор.
- [ ] Изменение порога проходит как изменение риска, а не косметическая правка YAML.
Перед авто-ремедиацией
- [ ] Известен радиус последствий.
- [ ] Есть пробный прогон (dry-run) или безопасная предварительная проверка.
- [ ] Условие отката записано до исполнения.
- [ ] Ручное подтверждение включается при неопределённости, повторном провале или расширении радиуса последствий.
- [ ] Инцидент не закрывается до двух независимых подтверждений восстановления, если риск высокий.
Перед аудитом антипаттернов прикладного цикла
Полный разбор симптомов и причин — в части 12. Здесь — 12 вопросов как быстрый чек-лист.
- [ ]
constitution.mdсрабатывает как шлюз до выполнения, а не только как ревью после. - [ ] В
mutable_rulesнет правил безttlили сttlбольше 90 дней.
- [ ] После провала ядовитой спецификации меняется хотя бы один артефакт (
requirements.md,plan.md,validation.md), а не только объяснение. - [ ] Верификатор использует контрпример, лог hook'а или JSON Schema — не свободный текст.
- [ ] В
governance_protocolесть veto от Safety и детерминированный tie-breaker. - [ ] Запускаемые команды (
[runnable]) явно отделены от[project script]-интерфейсов. - [ ] Каждой целевой метрике сопоставлена парная anti-Goodhart-метрика.
- [ ] Когда CI падает, чинят код, а не ослабляют
validation.md. - [ ] У переключения между ярусами есть бюджетный потолок и аварийный режим.
- [ ] Каждая запись в
QWEN.mdимеет автора, доказательство иttl. - [ ]
manual_review_floorсохраняется независимо от значения KPI. - [ ] Поле
evidence_refзаполнено в каждой записи следа.
Если на три и больше пунктов ответ отрицательный — не добавляйте новые слои автоматизации; сначала закройте провалы в текущем контуре.
Перед итоговым production-зачётом
- [ ]
capstone/README.mdобъясняет кейс без истории чата. - [ ]
genealogy.mdсодержит требование, источники, уровень уверенности и открытый вопрос.
- [ ] Poisoned/fixed-пара содержит один дефект и одно проверяемое исправление.
- [ ]
validation.mdссылается минимум на один реально запущенный runnable-пример или его проектный аналог. - [ ]
judgment.mdсодержит вердикт, причину,evidence_refи следующий шаг. - [ ] Бюджетный и anti-Goodhart-слои имеют хотя бы по одному блокирующему инварианту.
- [ ] Readiness-вывод отделяет блокеры от улучшений.
- [ ] Диагностический чек-лист части 12 пройден, отрицательные ответы имеют владельца и следующий контроль.