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:
@@ -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 ...
|
||||
@@ -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>
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user