18 lines
1.4 KiB
Markdown
18 lines
1.4 KiB
Markdown
# 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.
|