av
ec136b50fb
- Двадцать сценариев шага были единственной проверкой над проверкой в проекте; запрет CLAUDE.md остался без исключений. - Ссылки на файл сняты в памятке, конвенции линтеров, журнале ревью и статусе ADR о спеке toolchain; норма шага живёт комментариями в самом скрипте.
Журнал решений
Одна запись — одно решение. ADR продвигает уже написанное решение, а не
сочиняет его заново: запись цитирует решение и ссылается на источник —
openspec/changes/archive/<id>/design.md, а у решения, принятого разведкой без
изменения, на её записку.
Когда заводить
Верно одно из трёх:
- дорогой откат — переделка стоит дороже переписывания одного файла;
- намеренный отказ от очевидного подхода;
- пересмотр прежнего решения — тогда у старой записи обязателен статус «заменено на».
Не заводить для рутины и для того, что видно из кода и git log.
Соглашения
- Имя файла —
ADR-ГГГГ-ММ-ДД-slug.md, дата — когда решение реально принято. Слаг английский по сути, а не транслитом:queue-as-table, неochered-tablicej. Форму имени и слаг проверяетdocs.py check. - Записи неизменяемы в решении: передумали — новая запись, старой ставится статус. Уточнить прежнюю запись можно только строкой «Уточнено ГГГГ-ММ-ДД:» в разделе «Последствия» и только фактом, который решения не меняет, — например действующим адресом того, что решение завело.
- Активная запись статуса не имеет. Значений два:
заменено на ADR-…иустарело; ставятся полем меты записи —- **Статус:** …рядом с датой и источником, а не абзацем в теле.
Записи
Новые сверху.
Решения, принятые до заведения канона 2026-08-10, источника в архиве изменений не имеют — сочинять их задним числом правило запрещает.