Ge Song
8d704cf406
Add the Bluecraft Agentic Docs skill with guidance for maintaining root `AGENTS.md` files and `agent-docs/` trees. Include OpenAI agent metadata plus reference templates and checklists for root routing, rule docs, inventory docs, and refactor validation.
20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
# 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.md` for instructions, constraints, policy, decision criteria, or workflow guidance.
|
|
- Use `inventory-doc-template.md` for 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 route new work to the specific template that matches the document's job.
|