verify-workstream

To verify workstream documentation aligns with the codebase, cross-reference frontmatter goals and acceptance criteria with actual files. This validation checks that declared scope_files exist and implementation matches documented patterns.

Frontmatter validation ensures required metadata exists and aligns with repository reality. It checks that declared scope_files are accessible and match the actual codebase, reducing drift between planned scope and implementation.

Run a pre-build validation to check if declared scope_files exist and are accessible. This process cross-references workstream documentation against the codebase to ensure the implementation matches documented patterns.

A documentation vs reality comparison table includes a severity score, recommended action, and discrepancy reporting. It maps workstream documentation against the codebase to guide remediation efforts directly.

You should validate workstream documentation during pre-build and pre-run stages. Applying validation at these stages verifies declared scope_files exist and ensures the actual implementation matches the documented patterns.

If workstream documentation does not match the codebase implementation, review the structured output containing a severity score and comparison table. Use the provided remediation guidance and recommended actions to resolve the discrepancies.