1.9 KiB
1.9 KiB
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
Если для нужного типа шаблон отсутствует, агент должен:
- использовать ближайший подходящий существующий шаблон как временную основу;
- явно сохранить тип документа в
YAML frontmatter; - не смешивать в одном документе несколько независимых сущностей.