Files
bluecraft/skills/bluecraft-agentic-docs/references/root-agents-template.md
Ge Song 4fa6e18940 docs(bluecraft-agentic-docs): document explicit linking patterns and update skill rules
Add dedicated reference for root AGENTS.md to agent-docs linking patterns with
anti-patterns and explicit reference requirements. Update SKILL.md core rules to
emphasize directional, explicit references and minimal reference depth. Refine
template structures in inventory-doc-template.md and root-agents-template.md to
enforce clearer scope sections and required reading lists. Update agent interface
metadata to reflect focused maintenance scope.
2026-04-20 12:54:30 +08:00

926 B

Root AGENTS.md Template

Use this structure for the AGENTS.md at the root of the current Git working tree.

# Root Entry

- State that this file is the root entry for the repository's `agent-docs`.
- Define the default path basis.

# Common Constraints

- Keep repository-wide rules here.
- Do not repeat topic-specific rules that belong in child docs.

# Required `agent-docs` Before Editing

- List the required `agent-docs` explicitly.
- Use explicit "Read and follow ..." wording.

Notes

  • Keep this file short.
  • Treat this file as an instruction document, not a passive index.
  • Reference child docs only when they are actually needed.
  • When referring to child docs, write repository-relative paths in backticks such as agent-docs/example.md, not Markdown links or machine-local absolute filesystem paths.
  • Do not turn the root file into a dump of all topic-specific rules.