doc-validator

The doc-validator is a quality assurance agent skill designed for Specification-Driven Development (SDD) frameworks. It performs comprehensive cross-document analysis to ensure structural and logical integrity across the documentation lifecycle, spanning layers from BRD and PRD to Technical Specifications (SPEC) and Implementation Plans. By traversing the document graph, it identifies orphaned artifacts, verifies bidirectional link consistency, and detects duplicate requirements IDs that threaten project stability. It serves as an essential gatekeeper before major releases, ensuring that the cumulative tagging hierarchy and traceability matrices are complete and accurate.

• Identifies broken cross-references and orphan documents within the project directory.

• Validates bidirectional link consistency to ensure all upstream dependencies are satisfied.

• Detects duplicate element IDs across multiple SDD layers and artifacts.

• Checks cumulative tagging hierarchy and traceability matrix completeness.

• Orchestrates specialized validators for links, diagrams, terminology, and requirement counts.

• Monitors project-wide consistency using local file-system graph traversal.

• Ideal for use by AI agents managing complex SDD documentation sets to prevent architectural drift.

• Not intended for single-document structure or metadata validation; rely on {TYPE}_VALIDATION_RULES.md for those tasks.

• Inputs include a mandatory documentation directory path and optional parameters for strictness and scope (cross-document, traceability, or full).

• Provides standardized error codes for efficient debugging and remediation.

• Minimal resource overhead (200-500MB RAM) for typical projects (100-200 documents) with zero network dependency.

• Supports auto-fix functionality for specific categories like terminology, section counts, and content indexing.