Ge Song
3bf898afab
Update skill definition and templates to use "references" instead of "routing" throughout, clarify the root AGENTS.md as the entry document for agent-docs, and add explicit linking patterns guidance. Improve template wording to emphasize directional, explicit references and minimal reference depth. - Rename and expand linking patterns reference - Update SKILL.md trigger conditions and core rules - Refine child doc template compatibility note - Update refactor checklist to focus on reference depth - Simplify root AGENTS.md template structure
1.1 KiB
1.1 KiB
Child agent-docs/ Template Chooser
Use this reference when you know you are editing a Markdown file inside agent-docs/, but you still need to decide which child template fits.
Choose The Smallest Matching Template
- Use
rule-doc-template.mdfor instructions, constraints, policy, decision criteria, or workflow guidance. - Use
inventory-doc-template.mdfor maintained lists, media plans, registries, page-by-page backlogs, or cleanup queues. - Split the document if one file tries to serve both purposes and the split would reduce ambiguity.
Quick Tests
- If the document mainly tells maintainers what to do and what to avoid, use the rule template.
- If the document mainly tracks entries that need to be updated over time, use the inventory template.
- If the document has a long list of repeated entries under one governing policy, keep the policy brief and let the inventory structure carry the list.
Compatibility Note
Older repositories may still refer to references/child-doc-template.md as the default child template. Keep this file as the entrypoint, but point new work to the specific template that matches the document's job.