project-onboardinglisted

# Skill — Project onboarding ## Когда подгружается Задачи, в которых **существующий репозиторий** (не cod-doc) заводится под COD-DOC. Триггер-keywords: `onboard`, `project add`, `project init`, `import docs`, `bootstrap`, «завести проект», «подключить проект», «начать использовать». Не для создания документации с нуля — это [`docs/cod-doc-guide.md`](../../../docs/cod-doc-guide.md). ## Инвариант, который нельзя нарушать **Импорт не переписывает markdown пользователя.** `import docs` только читает файлы и заводит `Document`-записи; исходники остаются нетронутыми до первого явного `doc export`. Пока пользователь не попросил экспорт — БД догоняет файлы, а не наоборот. Отсюда правило: **onboarding всегда начинается с `--dry-run`.** ## Канонический порядок ```bash # 1. Глобальный реестр ~/.cod-doc/config.yaml: путь + имя (slug из --name). # Шаг ОБЯЗАТЕЛЕН (ADO-029): без него CLI резолвит проект только из cwd — # cron/routines и любой запуск вне каталога репозитория упадут с # «Project not found» (живой случай: первый cron-тик ADO-024 на пилоте). cod-doc project add /path/to/repo --name my-app # 2. Локальное состояние: .cod-doc/state.db + миграции cod-doc project init my-app # 3. Разведка: что вообще попадёт в БД (--dry-run печатает итоговый список) cod-doc import docs my-app --dry-run # 3b. Увидел мусор — отсеки и посмотри снова, до записи в БД cod-doc import docs my-app --exclude 'experiments/stand*' --exclude '*/_archive' --dry-run # 4. Импорт (по умолчанию c