# 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-000-adr-process.md) | ADR process | Accepted |

### Governance / Process

| ADR | Заголовок | Status |
|-----|-----------|--------|
| [ADR-011](ADR-011-brain-governance.md) | Brain governance (observer / router-procedure / контролёры) | Accepted |
| [ADR-016](ADR-016-section17-universal-skill-coverage.md) | §17 universal skill-coverage (classifier-driven default-deny) | Accepted |
| [ADR-020](ADR-020-split-control-layer-into-claude-brain.md) | Split control layer into dedicated `claude-brain` repo | Accepted (2026-06-15) |

### Off-phase tooling

| ADR | Заголовок | Status |
|-----|-----------|--------|
| [ADR-003](ADR-003-audit-risk-tooling.md) | Audit / risk tooling (D3) | Accepted |
| [ADR-004](ADR-004-project-management-tooling.md) | Project-management tooling (C9) | Accepted |
| [ADR-005](ADR-005-architecture-fitness-deptrac.md) | Architecture-fitness — deptrac (A6) | Accepted |
| [ADR-006](ADR-006-a4-design-tooling-boundaries.md) | Design tooling boundaries (A4) | Accepted |
| [ADR-007](ADR-007-ml-ai-tooling.md) | ML / AI tooling (A11) | Accepted |
| [ADR-008](ADR-008-business-process-tooling.md) | Business-process tooling (C10) | Accepted |
| [ADR-009](ADR-009-discovery-interview-tooling.md) | Discovery-interview tooling | Accepted |
| [ADR-010](ADR-010-anthropic-dev-tooling.md) | Anthropic dev tooling (authoring / dev-support) | Accepted |
| [012](012-finance-tooling.md) | Finance tooling (C6/C7) | Accepted |
| [013](013-backend-tooling.md) | Backend tooling (A1) | Accepted |
| [014](014-infosec-tooling.md) | Infosec tooling (A8) | Accepted |
| [015](015-marketing-tooling.md) | Marketing tooling (C1) | Accepted |
| [ADR-017](ADR-017-knowledge-graph-tooling.md) | Knowledge-graph tooling (graphify) | Accepted |
| [ADR-019](ADR-019-research-tooling.md) | Research tooling (Perplexity Pack #87-89) | Accepted |

## Когда заводить ADR

Решение с долгосрочным влиянием на архитектуру, затрагивающее несколько компонентов, с реальными альтернативами и принятыми trade-off'ами, ограничивающее будущие выборы или меняющее существующий паттерн. НЕ для багфиксов, рефакторингов без смены внешнего поведения, конфиг-правок в рамках диапазона и обычных доков.

## Supersession

Принятый ADR неизменяем. Изменение решения — новый ADR со ссылкой «Supersedes ADR-XXX» в `## Related Decisions`; у старого правится только строка Status (`Superseded by ADR-YYY`), текст решения не трогается.