dev-review

What problem does it solve?

Ensures project specifications and development artifacts are complete, consistent, and robust by automating a structured adversarial review that surfaces missing requirements, contradictions, vague language, and unhandled edge cases.

Core Features & Use Cases

• Completeness Check: Validates phase-specific checklists and counts required sections to compute a pass threshold.
• Adversarial Review: Challenges assumptions, detects contradictions across files, and replaces vague terms with quantitative recommendations.
• Edge Case Hunter: Enumerates concurrency, empty states, max-length, network failure, permission, and invalid-data scenarios for acceptance criteria and requirements.
• Report & Changelog: Generates a structured review report and appends a summarized entry to the project changelog for traceability.
• Use Case: Run before a handoff or sprint to gate a PRD, user stories, or technical spec and produce actionable remediation steps and a pass/fail decision.

Quick Start

Run an adversarial quality gate on the latest completed phase, generate the review report in specs/technical/review-report.md, and append a summary entry to specs/_changelog.md.