Documentation Traceability Validator Skill

Validate and maintain accurate traceability between code annotations (@implements FEATXXXX) and documentation registries (features.md, business_rules.md, use_cases.md). This skill detects gaps, collisions, and broken cross-references that compromise documentation accuracy.

When to use

Use this skill when you need to:

• Audit documentation accuracy: Verify all code features are documented
• Detect ID collisions: Find duplicate FEAT/BR/UC IDs before they break traceability
• Find undocumented features: Discover @implements annotations missing from registries
• Validate cross-references: Ensure FEAT↔BR↔UC links are valid
• Enforce namespace allocation: Verify features use correct ID ranges
• Generate registry entries: Auto-create documentation from code annotations
• CI/CD quality gates: Block PRs with documentation gaps
• Track documentation coverage: Monitor doc completeness over time

Core concepts