42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
---
|
|
name: agent-docs-consistency
|
|
description: Use when checking the AGENTS.md and agent-docs graph for reachability, cycles, depth, duplicate authority, routing clarity, or rule-doc versus inventory-doc consistency.
|
|
---
|
|
|
|
# Agent Docs Consistency
|
|
|
|
## Overview
|
|
|
|
Use this skill for structural consistency checks across AGENTS and `agent-docs`. It focuses on the document graph and authority model, not repository behavior.
|
|
|
|
## When to Use
|
|
|
|
- The user asks whether there are cycles
|
|
- The user asks for document depth or routing structure
|
|
- The user asks whether two docs both own the same rule
|
|
- The user asks whether a doc has become a secondary router or mixed-shape document
|
|
|
|
## Workflow
|
|
|
|
1. Read the root `AGENTS.md`.
|
|
2. Read the active child docs in scope.
|
|
3. Read `../agent-docs/references/consistency-checklist.md`.
|
|
4. Inspect:
|
|
- root reachability
|
|
- shortest routing depth
|
|
- direct cycles and high-noise cross-links
|
|
- duplicate authority candidates
|
|
- out-degree hotspots
|
|
- rule-doc vs inventory-doc shape mismatches
|
|
5. Distinguish:
|
|
- blocking or high-noise structural problems
|
|
- acceptable cross-references
|
|
6. Report the structural findings without drifting into repository implementation review. Use `agent-docs-repo-alignment` for repo-fact comparison.
|
|
|
|
## Output
|
|
|
|
- Reachability summary
|
|
- Cycle summary
|
|
- Duplicate-authority or shape findings
|
|
- Residual risk assessment
|