doc-adr-validator

Validate ADR documents by checking them against Layer 5 schema requirements, which enforce the four-part structure (context, decision, consequences, architecture flow), required metadata fields, tag validation, Mermaid diagrams, and SYS-Ready scoring to ensure governance compliance.

ADRs must trace upstream to BRD, PRD, EARS, or BDD artifacts to establish decision context and dependencies. The validator checks these traceability links are present and properly documented within the ADR structure.

Yes, the validator applies at any stage—during initial creation, modification, or peer review—to catch structural and metadata gaps early and guide ADR readiness before approval in governance-controlled environments.

Validation identifies which required sections, metadata fields, tags, or traceability links are missing or malformed, providing readiness feedback so you can address gaps before the ADR meets compliance standards.

Yes, Mermaid architecture diagrams are a mandatory component of Layer 5 ADR schema. The validator enforces their presence as part of the structural requirements for ADR compliance.

SYS-Ready scoring is a validation metric within Layer 5 schema that rates ADR completeness and governance readiness. The validator calculates this score to indicate whether an ADR is ready for organizational decision tracking and traceability.