- беклог и план переехали в docs/tasks (38 задач, 11 целей), слаги переименованы с транслита на английские, 85 ссылок поправлены - conventions.md разобран в docs/conventions/, local-research.md — в docs/research/, review-journal.md — в docs/review.md с разделом настройки конвейера; заведены security.md, adr/ и .pm.json - шаг docs.py check добавлен в task gate; поведение в architecture.md помечено девятью маркерами долга, database.md получил настройки с числовым значением
Журнал решений
Одна запись — одно решение. ADR это промоут поверх архивного design.md,
а не второе сочинение: запись цитирует решение и ссылается на
openspec/changes/archive/<id>/design.md.
Когда заводить
Верно одно из трёх:
- дорогой откат — переделка стоит дороже переписывания одного файла;
- намеренный отказ от очевидного подхода;
- пересмотр прежнего решения — тогда у старой записи обязателен статус «заменено на».
Не заводить для рутины и для того, что видно из кода и git log.
Соглашения
- Имя файла —
ADR-ГГГГ-ММ-ДД-slug.md, слаг английский, дата — когда решение реально принято. - Записи неизменяемы: передумали — новая запись, старой ставится статус.
- Активная запись статуса не имеет. Значений два:
заменено на ADR-…иустарело.
Записи
Новые сверху.
| Дата | Запись | Статус |
|---|
Записей пока нет: каталог заведён переездом на канон 2026-08-03. Сырьё для
промоута накоплено — девять архивных изменений в
openspec/changes/archive/, из них решения с дорогим откатом и намеренные
отказы есть как минимум в 2026-08-01-polnota-tochki-mnozhestvom-klyuchey
(идентичность точки и тай-брейк), 2026-08-02-reindex-iz-arhiva (подмену базы
делает человек) и 2026-08-02-cena-chitayushchego-marshruta (чекпойнт WAL по
таймеру). Промоут делает скилл av-dev-pm:docs, а не переезд: адаптация
раскладки содержания не сочиняет.