30 lines
1.9 KiB
Markdown
30 lines
1.9 KiB
Markdown
# Rule: Use Document Templates From Fixed Paths
|
|
|
|
Агент должен создавать и обновлять техническую документацию только с опорой на шаблоны документов, расположенные в `.analysis/rules`.
|
|
|
|
Если агент формирует новый документ, он обязан:
|
|
|
|
- определить тип документа;
|
|
- выбрать соответствующий шаблон по фиксированному пути;
|
|
- сохранить структуру секций и базовых метаданных из шаблона;
|
|
- заполнять только те секции, которые подтверждены кодом и артефактами;
|
|
- не придумывать новые произвольные форматы, если для типа уже существует шаблон.
|
|
|
|
Пути к базовым шаблонам:
|
|
|
|
- `.analysis/rules/legacy/template_ui_page.md`
|
|
- `.analysis/rules/legacy/template_api_method.md`
|
|
- `.analysis/rules/legacy/template_logic_block.md`
|
|
|
|
Правило выбора шаблона:
|
|
|
|
- для документа типа `ui_page` использовать `.analysis/rules/legacy/template_ui_page.md`
|
|
- для документа типа `api_method` использовать `.analysis/rules/legacy/template_api_method.md`
|
|
- для документа типа `logic_block` использовать `.analysis/rules/legacy/template_logic_block.md`
|
|
|
|
Если для нужного типа шаблон отсутствует, агент должен:
|
|
|
|
1. использовать ближайший подходящий существующий шаблон как временную основу;
|
|
2. явно сохранить тип документа в `YAML frontmatter`;
|
|
3. не смешивать в одном документе несколько независимых сущностей.
|