# Docs

Здесь живут as-built факты, проектные решения и общие engineering conventions.
Работай напрямую по задаче пользователя; обязательного SDD lifecycle нет.

Для поиска проектного источника начни с [AI_INDEX](AI_INDEX.md). Если задача
уже указывает точный документ (например, правка опечатки), читай его напрямую.
Architecture/features описывают текущее поведение,
ADR сохраняют rationale; audits и прежнее Completion Evidence — история.
Изменение утверждённого архитектурного решения фиксируется successor ADR,
но не требует создания OpenSpec artifacts.

Перед Node-командами: `nvm use --silent`. После `npm ci` запускай
`npm run verify` (Markdown lint + `git diff --check`, без auto-fix).
Проверь links/anchors затронутых документов отдельно. Новые документы должны
быть доступны через соответствующий index. Runtime facts сверяй с code/config;
не копируй framework docs, secrets или один контракт в несколько owners.