plan-review-lead

Evaluates plan readiness by reviewing Story Specs and design artifacts, assigning outcomes and PlanReviewDecision for engineers.

11|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/ylxmf2005/AgentCorp --skill plan-review-lead
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-review-lead
Source: https://github.com/ylxmf2005/AgentCorp/tree/main/agentcorp/plan-review-lead
Command: npx skills add https://github.com/ylxmf2005/AgentCorp --skill plan-review-lead

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Act as the Gate between planning and implementation, ensuring that a Story Spec and its design artifacts are thoroughly reviewed before engineering starts to prevent unreviewed scope, misaligned requirements, or hidden dependencies.

Core Features & Use Cases

  • Review the Story Spec and design artifacts against acceptance criteria and constraints.
  • Decide using the four outcomes (approve, needs_more_evidence, blocked, or request_changes) to determine next steps.
  • Produce and hand off a PlanReviewDecision with explicit evidence, constraints, and next actions for the Implementation Engineer.

Quick Start

Decide if a plan is ready for implementation by reviewing the Story Spec and design artifacts.

Frequently Asked Questions about plan-review-lead

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

FAQPage Schema
How do I review a story spec to determine if a plan is ready for implementation?

To review a story spec for implementation readiness, evaluate the spec and design artifacts against acceptance criteria and constraints. This plan review process results in a structured decision with explicit evidence and next actions.

What are the standard outcomes when evaluating design artifacts during a plan review?

Evaluating design artifacts yields four policy outcomes: approve, needs_more_evidence, blocked, or request_changes. These decisions guide the next phase by steering the implementation engineer with specific constraints and required context artifacts.

How does a gatekeeper between planning and build prevent unreviewed scope?

A planning gatekeeper prevents unreviewed scope by thoroughly reviewing story specs and design artifacts before engineering starts. It identifies misaligned requirements and hidden dependencies to ensure a structured handoff to the implementation phase.

What should be included in a plan review decision for the implementation engineer?

A plan review decision should include explicit evidence, constraints, and next actions. It assigns required context artifacts to guide the implementation engineer, ensuring the development team has exactly what is needed to proceed.

When do I need to request more evidence during a story spec review?

You request more evidence during a story spec review when the plan lacks sufficient detail to verify acceptance criteria. This outcome pauses implementation until you collect the missing design artifacts needed to prove feasibility.

Can I use a plan review gatekeeper to identify hidden dependencies in implementation planning?

Yes, a plan review gatekeeper identifies hidden dependencies by evaluating design artifacts against constraints. It acts as a checkpoint to expose undocumented requirements before the build phase begins, preventing downstream engineering blockers.