dev-phase_reviewer

Reviews development phase deliverables against checklists and generates phase review reports.

1|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/zhizhunbao/textbook-rag --skill dev-phase-reviewer-zhizhunbao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-phase_reviewer
Source: https://github.com/zhizhunbao/textbook-rag/tree/main/.agent/skills/dev-phase_reviewer
Command: npx skills add https://github.com/zhizhunbao/textbook-rag --skill dev-phase-reviewer-zhizhunbao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Development phases often move forward without independent quality gates, letting defects and non-compliant deliverables slip through. This Skill enforces a mandatory review gate for every /dev phase, ensuring a different reviewer validates outputs before the workflow advances. ## Core Features & Use Cases - Phase-based reviewer assignment: Maps each phase (requirements, prd, architecture, stories, database, backend, frontend, testing, review, deployment) to a designated reviewer distinct from the author. - Checklist-driven reviews: Applies document, code, testing, or deployment review checklists from the references directory based on the current phase. - Automated validation and blocking: Runs phase-specific validations (e.g., ruff and pytest for backend) and blocks progression on CRITICAL or HIGH findings, persisting reports to docs/reviews/. - Use Case: After completing the backend phase, run the review gate to execute lint and test checks, verify textbook compliance, and generate docs/reviews/phase-06-backend.md before updating .dev-state.yaml. ## Quick Start Ask the AI to run the phase review gate for the current development phase and generate the review report.

Frequently Asked Questions about dev-phase_reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a phase review gate in a development workflow?▼

Read the current phase from .dev-state.yaml, assign the designated reviewer from the mapping table, run the phase's automatic validation, and execute the matching checklist. Persist results to docs/reviews/phase-{NN}-{phase_key}.md and update state only after the gate passes.

What review checklist applies to each development phase?▼

Document phases (requirements, prd, architecture, stories, database) use document-review.md; backend, frontend, and review use code-review.md; testing uses testing-review.md; deployment uses deployment-review.md. Each checklist defines blocking, high, and medium severity checks.

Can the same person author and review a development phase?▼

No, the reviewer must differ from the author for every phase. The assignment table maps each phase to a specific reviewer role, such as the Architect reviewing the PM's requirements or the Tech Lead reviewing the Architect's stories.

What happens when a phase review finds critical issues?▼

Any CRITICAL or HIGH finding blocks the phase and requires fixes followed by a full re-review. The review report must include a re-review section, and .dev-state.yaml is updated only after the gate passes.

Why is textbook compliance checked during phase reviews?▼

Reviewers must read mapped textbook references before reviewing to ground decisions in established methodology. If textbook lookup was skipped or backfilled late, an entry is appended to docs/process/textbook-compliance-log.md.