Consistency Enforcement Skill

Layer 4 Defense Against Documentation Drift

Auto-activates to maintain documentation consistency when working on docs, skills, agents, or commands.

See: workflow.md for step-by-step scenarios See: templates.md for checklists and commands

When This Activates

Keywords: "readme", "documentation", "docs", "commit", "sync", "update", "skill", "agent", "command", "count", "marketplace", "consistency", "drift"

Critical Consistency Rules

Rule 1: README.md is Source of Truth

All counts must match reality:

# Count actual resources
ls -d plugins/autonomous-dev/skills/*/ | wc -l   # Skills
ls plugins/autonomous-dev/agents/*.md | wc -l    # Agents
ls plugins/autonomous-dev/commands/*.md | wc -l  # Commands

Rule 2: All Docs Must Match README.md

These files MUST show the same counts:

• README.md

  (primary source)

• docs/SYNC-STATUS.md

• docs/UPDATES.md

• INSTALL_TEMPLATE.md

• .claude-plugin/marketplace.json

  (metrics)

Rule 3: Never Reference Non-Existent Skills

# Verify skill exists before referencing
ls -1 plugins/autonomous-dev/skills/

Rule 4: marketplace.json Matches Reality

{
  "metrics": {
    "agents": 8,
    "skills": 12,
    "commands": 21
  }
}

4-Layer Defense System

tests/test_documentation_consistency.py

agents/doc-master.md

hooks/validate_docs_consistency.py

Run Tests

pytest tests/test_documentation_consistency.py -v

Quick Workflow

When adding/removing skills, agents, or commands:

1. Update README.md count
2. Update cross-reference files (SYNC-STATUS.md, UPDATES.md, etc.)
3. Update marketplace.json metrics
4. Run consistency tests
5. Commit

See: workflow.md for detailed scenarios

Why This Matters

Documentation drift causes user confusion:

• README shows "9 Skills" but plugin has 12
• README mentions skill that doesn't exist
• User tries to use non-existent feature

With 4-layer defense:

• Layer 1: Tests fail in CI/CD
• Layer 2: doc-master catches before docs.json
• Layer 3: Pre-commit hook blocks commit
• Layer 4: This skill reminds during work

Result: Documentation always matches reality

Integration

Works with:

• documentation-guide: HOW to write docs
• git-workflow: HOW to commit changes
• project-management: PROJECT.md consistency

Related Files

• workflow.md - Step-by-step scenarios
• templates.md - Checklists and commands