doc-structurelisted

# Skill — Структура дерева документации ## Когда подгружается Импорт чужого репозитория, разбор Инбокса, переименование и слияние документов, вопрос «куда это положить». Не подгружается ради правки прозы внутри одного документа — это [[doc-style]]. ## Что здесь дерево Хранимая сущность, а не вёрстка экрана: таблица `doc_node` (ключ, название, `intent`, порядок, `parent_id`) плюс `document.node_id`. До ADO-116 дерево строилось в вебе из `doc_key.split("/")`, то есть показывало файловую кучу: на корпусе cod-doc это 14 папок `cod_doc/skills/*` с одним файлом внутри каждой и узел `audit` на 42 документа. Отсюда первое правило: **каталог на диске и раздел в дереве — разные вещи**. Раскладка меняет `node_id` в БД и не двигает markdown. Файлы перекладывают только по явной просьбе человека (инвариант `project-onboarding`). ## Роли разделов | Раздел | Что лежит | Чего не лежит | |---|---|---| | `entry` | Навигаторы и точки входа: MASTER, README, гид контрибьютора | Всё, у чего есть свой раздел | | `vision` | Зачем проект существует, для кого, чем ограничен | Как он устроен | | `architecture` | Слои, границы, компоненты и их взаимодействие | Спека одного модуля | | `data-model` | Сущности домена, схема, инварианты | Миграции как таковые | | `capabilities` | Что система умеет — по способностям | Разбивка по модулям кода | | `scenarios` | Наборы сценариев поведения | Вердикты покрытия — это доказательства producer'а | | `standards` | Соглашения: код, документация, процесс | Разовы