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.
This commit is contained in:
2026-04-20 12:54:30 +08:00
parent 3bf898afab
commit 4fa6e18940
5 changed files with 42 additions and 45 deletions

View File

@@ -1,4 +1,4 @@
# `agent-docs` Linking Patterns
# How To Link Root AGENTS.md And agent-docs
## Preferred Patterns
@@ -7,7 +7,7 @@
Use when the repository has a small set of clearly separate instruction topics.
```md
# Read Required `agent-docs` Before Editing
# Required `agent-docs` Before Editing
- Read and follow `agent-docs/topic-a.md` when ...
- Read and follow `agent-docs/topic-b.md` when ...

View File

@@ -9,11 +9,11 @@ Use this structure for Markdown files inside `agent-docs/` when the document's m
<Opening statement: what this inventory tracks, when it should be used or updated, and that it must be followed in scope.>
## Use This For
## Applies To
- <tasks that require reading or updating this inventory>
## Do Not Use This For
## Does Not Apply To
- <tasks that belong in a rule doc, public docs, or another inventory>

View File

@@ -15,7 +15,7 @@ Use this structure for the `AGENTS.md` at the root of the current Git working tr
- Keep repository-wide rules here.
- Do not repeat topic-specific rules that belong in child docs.
# Read Required `agent-docs` Before Editing
# Required `agent-docs` Before Editing
- List the required `agent-docs` explicitly.
- Use explicit "Read and follow ..." wording.