Files
healthlog/docs/adr
avandClaude Opus 5 eb3fca77ee канон: поднят до версии 2 — шапка ADR мета-блоком
Миграция по записи «Версия 2» журнала канона: поля Дата и Источник в
docs/adr/template.md жирным, объявлено место под статус (- **Статус:**
заменено на ADR-… либо устарело), та же строка добавлена в «Соглашения»
docs/adr/README.md, docs/.pm.json переведён на canon 2.

Переносить статусы было не из чего: записей ADR в проекте пока нет, каталог
несёт только README и шаблон.

docs.py check зелёный, версия проекта сошлась с версией скрипта.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 18:04:29 +03:00
..

Журнал решений

Одна запись — одно решение. 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, а не переезд: адаптация раскладки содержания не сочиняет.