ADR 0077: TECH — центр принципов (связный текст из канона)¶
Статус: Proposed
Дата: 2026-04-20
Назначение: один входной ADR для читателя: как мы думаем про технику — границы модулей, контракты с внешним миром, агент, отладку и инфраструктуру репозитория — без обхода десятков записей. Детали и таблицы исключений — в исходных ADR и в architecture-policy.md.
Канон текста ниже — файлы в snippets/tech/; правки формулировок делаются там, этот ADR задаёт структуру и статус Proposed/Accepted для «центра» TECH.
Связанные ADR¶
| ADR | Роль |
|---|---|
| 0006 | слои и срезы |
| 0008 | Стабильные контракты MCP и тестируемая инфраструктура |
Вне ADR¶
| Документ | Роль |
|---|---|
| TECH/README.md | указатель TECH/ |
| TECH/principles.md | TECH/principles |
Сборка: в GitHub сырые {{ INCLUDE }} не раскрываются — для чтения «как книга»: dotnet script build-adr.csx (развёрнутый 0077 попадёт в общую книгу) или точечно собери HTML из корня docs/adr после включения 0077 в свой adr-book.md. |
Введение¶
Цель — не «всё в одном монолите» и не «каждый сам по себе»: согласованные границы между UI, сценариями и внешним миром, плюс честный контур для человека и агента (отладка, транспорт, контракты). Ниже — два блока: контракты и инфраструктура, затем агент, отладка и наблюдаемость.
{{ INCLUDE: snippets/tech/0077-boundaries-contracts-and-infra.md }}
{{ INCLUDE: snippets/tech/0077-agent-debug-and-observability.md }}
Последствия¶
- Онбординг и ревью могут ссылаться «начни с 0077», затем переходить по ссылкам в полные ADR.
- Расширение «центра» — новые секции в
snippets/tech/+ новыеINCLUDEздесь; дублировать длинный текст в нескольких ADR без нужды не требуется.
Отклонённые альтернативы¶
- Только таблица ссылок — недостаточно для читателя, который хочет один связный текст (см. TECH/principles.md как карту, не как замену этого ADR).
- Дублировать норматив целиком из 0008/0002 в этом файле — рассинхрон; канон остаётся в исходных ADR + сниппетах.