validate-idea

To validate project documentation readiness, check that required artifacts like README.md and project-brief.md exist and maintain alignment. Phase-aware validation ensures the correct concept, planning, and development files are present before progressing to execution.

Verifying project alignment requires README.md, project-brief.md, specs, issues, and ADRs. Consistency checks flag missing links or mismatches among these files to ensure structural completeness across the project lifecycle.

No external dependencies are needed to check project-brief and README consistency. The validation process enforces phase-appropriate artifacts and performs structural checks natively without requiring additional tools or packages.

You need to validate phase-specific files like critique.md and issues when transitioning between concept, planning, and development phases. Phase-aware validation ensures the required artifacts for each specific lifecycle stage exist and are correctly aligned.

The best way to assess ADR and spec alignment with a project brief is through consistency checks that verify links and dependencies. This validation flags mismatches between architectural decisions, specifications, and the core project description.

Idea documentation fails validation for missing ADRs or specs because phase-aware checks enforce required artifacts. The validator flags missing links or structural mismatches to prevent incomplete documentation from progressing to execution.