ДмитрийArchitecture Decision Records — claude-brain
Реестр архитектурных решений управляющего слоя Claude. ADR документируют значимый выбор вместе с контекстом, рассмотренными альтернативами и последствиями — живая документация «почему система устроена так».
Формат — семисекционный шаблон adr-kit (Status / Context / Decision / Alternatives / Consequences / Related / References [+ Enforcement]); правила — скил adr-kit:adr, проверка — tools/adr-judge.py (вендорен из adr-kit v0.13.1).
Состояние реестра (миграция split, 2026-06-15)
Каталог наполнен в ходе разделения Документация → claude-brain (см. ADR-020). Перенесены управляющие/tooling-ADR; ADR Лидерры (001 frontend-stack, 002 multitenancy-RLS, 018 audit-chain-per-tenant) остаются в Документация и сюда не переезжают — отсюда «пропуски» 001/002/018 в нумерации намеренные.
NB наследие именования. ADR-012…015 в каноне идут без префикса
ADR-(012-finance-tooling.mdи т.п.) — скопированы verbatim из источника, переименование не делалось (сломало бы cross-refs в нормативке). Остальные —ADR-NNN-…. Нормализацию не проводим в рамках миграции.
Индекс
Process
| ADR | Заголовок | Status |
|---|---|---|
| ADR-000 | ADR process | Accepted |
Governance / Process
| ADR | Заголовок | Status |
|---|---|---|
| ADR-011 | Brain governance (observer / router-procedure / контролёры) | Accepted |
| ADR-016 | §17 universal skill-coverage (classifier-driven default-deny) | Accepted |
| ADR-020 | Split control layer into dedicated claude-brain repo |
Accepted (2026-06-15) |
Off-phase tooling
| ADR | Заголовок | Status |
|---|---|---|
| ADR-003 | Audit / risk tooling (D3) | Accepted |
| ADR-004 | Project-management tooling (C9) | Accepted |
| ADR-005 | Architecture-fitness — deptrac (A6) | Accepted |
| ADR-006 | Design tooling boundaries (A4) | Accepted |
| ADR-007 | ML / AI tooling (A11) | Accepted |
| ADR-008 | Business-process tooling (C10) | Accepted |
| ADR-009 | Discovery-interview tooling | Accepted |
| ADR-010 | Anthropic dev tooling (authoring / dev-support) | Accepted |
| 012 | Finance tooling (C6/C7) | Accepted |
| 013 | Backend tooling (A1) | Accepted |
| 014 | Infosec tooling (A8) | Accepted |
| 015 | Marketing tooling (C1) | Accepted |
| ADR-017 | Knowledge-graph tooling (graphify) | Accepted |
| ADR-019 | Research tooling (Perplexity Pack #87-89) | Accepted |
Когда заводить ADR
Решение с долгосрочным влиянием на архитектуру, затрагивающее несколько компонентов, с реальными альтернативами и принятыми trade-off'ами, ограничивающее будущие выборы или меняющее существующий паттерн. НЕ для багфиксов, рефакторингов без смены внешнего поведения, конфиг-правок в рамках диапазона и обычных доков.
Supersession
Принятый ADR неизменяем. Изменение решения — новый ADR со ссылкой «Supersedes ADR-XXX» в ## Related Decisions; у старого правится только строка Status (Superseded by ADR-YYY), текст решения не трогается.