plan-reviewer

Automate evaluation of implementation plans and PR specs for testable acceptance criteria.

36|6|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/KjellKod/quest --skill plan-reviewer-kjellkod
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-reviewer
Source: https://github.com/KjellKod/quest/tree/main/.skills/plan-reviewer
Command: npx skills add https://github.com/KjellKod/quest --skill plan-reviewer-kjellkod

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams ensure that plans, PR specifications, and feature documentation are concrete, testable, and ready for coding by surfacing gaps before implementation begins.

Core Features & Use Cases

  • Acceptance Criteria Testability: Verifies each criterion is specific, measurable, and linkable to validations.
  • Validation Planning: Ensures both manual validation steps and automated test intents are defined.
  • Integration Awareness: Identifies touchpoints, data flows, and potential impact on systems early.
  • Open Questions & Risks: Documents ambiguities as decisions and highlights top risks with mitigations.

Quick Start

Use the plan-reviewer on a project plan, PR spec, or feature document to generate a delta of actionable improvements before coding begins.

Frequently Asked Questions about plan-reviewer

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

FAQPage Schema
How do I ensure my PR specs have testable acceptance criteria before coding begins?

To ensure PR specs have testable acceptance criteria, you need to evaluate implementation plans to verify each criterion is specific, measurable, and linkable to validation steps. This surfaces gaps in feature documentation before development starts.

What is the best way to document integration touchpoints and risks in a feature plan?

Documenting integration touchpoints and risks in a feature plan requires identifying data flows and system impacts early. You must explicitly record top risks alongside their mitigations and capture open questions as formal decisions within the plan.

How do I add automated test intents and manual validation steps to a project plan?

Adding automated test intents and manual validation steps to a project plan involves defining a complete validation strategy. You must document both the manual validation procedures and the intended automated tests to support the acceptance criteria.

Can I use plan review for feature docs across different software teams?

Yes, plan review can be applied to software projects across different teams. It automates the evaluation of feature docs and implementation plans to ensure validation planning and acceptance criteria are consistently documented regardless of the team.

Why does my implementation plan fail validation planning checks?

Implementation plans fail validation planning checks when manual validation steps or automated test intents are missing. The review process requires explicit documentation of both validation methods to ensure all acceptance criteria are fully supported.

When should I not use automated plan review for feature documentation?

You should not use automated plan review for feature documentation if your project lacks initial acceptance criteria or implementation specs. The review requires existing plan details to evaluate testability, integration touchpoints, and risk mitigations effectively.