main knowledge / adr / 016-knowledge-stack-clean-setup-protocol-v1.md markdown e8ad09341 # ADR 016: Протокол чистой установки стека (ANM + kb-public → personal) 2 3 **Статус:** Accepted 4 **Дата:** 2026-05-18 5 **Связано:** [009](009-kb-entry-structure-and-pre-open-onboarding.md), [013](013-knowledge-roots-toml-and-chmod-ugo-v1.md), MCP ADR 014/015 6 7 --- 8 9 ## Контекст 10 11 Новый пользователь скачивает **agent-notes-mcp** и **kb-public**, но без **personal** канона агент не имеет единого чеклиста: README ANM описывает сборку, ADR 009 — вход в уже существующую KB, `map-kb-three-contours` — куда писать после того, как контуры есть. Пробел: **пошаговый onboarding** и контракт поведения агента («скажи 1, 2, 3» / сделай за меня шаблоны). 12 13 ## Решение 14 15 1. Канонический playbook: **`knowledge/domains/agent-operations/playbook-knowledge-stack-clean-setup-v1.md`** (фазы 0–5, DoD, chmod ugo). 16 2. Маршрутизация: секция **`router-clean-setup`** в `index-knowledge-router-supplement-v1.md`. 17 3. Опциональный hot: **`clean-setup-routing-v1`** (шаблон `work/local/hot-section-clean-setup-routing-v1.example.md`). 18 4. Тонкий вход: ссылка в **`00-entry-kb-v1.md`**. 19 20 ## Последствия 21 22 - После `build-public-kb` playbook доступен в kb-public — агент может вести пользователя до появения personal (TOML `primary=public` временно). 23 - TOML и реальные пути остаются **вне** git канона (`work/local/`, диск). 24 25 ## Не в scope v1 26 27 - Автоматический setup wizard в ANM (CLI). 28 - `route_context` overlay для onboarding (достаточно router + hot). 29 **v1.1 (2026-05-18):** шаблоны перенесены в **`knowledge/templates/template-clean-setup-*`** (корзина `templates/` по таксономии); каталог `domains/agent-operations/clean-setup-templates-v1/` снят. 30 **v1.2 (2026-05-18):** подкаталоги `templates/cards/` и `templates/newcomer/`; корень `templates/` — только README-индекс. 31
View only · write via MCP/CIDE