performing-milestone-reviews

Structure and validate design document milestones with acceptance criteria and demos.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cyarie/cyarie-claude-plugin --skill performing-milestone-reviews
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: performing-milestone-reviews
Source: https://github.com/cyarie/cyarie-claude-plugin/tree/main/skills/performing-milestone-reviews
Command: npx skills add https://github.com/cyarie/cyarie-claude-plugin --skill performing-milestone-reviews

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Milestones are often vague and under-specified, leading to misaligned expectations, unclear success criteria, and wasted development cycles. This skill provides a repeatable workflow to define, review, and validate milestones so teams can make design intent observable and verifiable.

Core Features & Use Cases

  • Supports a formal milestone template with Job Story, Description, Acceptance Criteria, and Demo to ensure completeness.
  • Guides interactive review one milestone at a time, with explicit approvals before proceeding.
  • Includes pressure-testing milestones to surface scope, dependency, and design gaps early.
  • Produces a clear handoff path to work planning, enabling downstream task decomposition and execution.
  • Applies well in design-to-implementation workflows for features, modules, or architecture changes.

Quick Start

Invoke the /start-milestone-review flow to begin parsing a design document and iteratively refine milestones.

Frequently Asked Questions about performing-milestone-reviews

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

FAQPage Schema
How do I structure and validate milestones within a design document?▼

To validate milestones within a design document, use a structured review process that applies a formal template covering job stories, descriptions, acceptance criteria, and demos. This approach pressure-tests each milestone individually to surface scope and dependency gaps before development.

What is the best way to define success criteria for feature milestones?▼

Defining success criteria for feature milestones requires enforcing a formal template with job stories, descriptions, and acceptance criteria. Interactive reviews verify each milestone individually, ensuring design intent remains observable and verifiable before proceeding to work planning.

Can I pressure-test design milestones to surface dependency gaps early?▼

Yes, you can pressure-test design milestones to surface dependency gaps early. The milestone review workflow includes explicit conflict checks and pressure-testing steps for each milestone, requiring formal approval before moving to the next phase.

How do I review design-to-implementation workflows one milestone at a time?▼

Reviewing design-to-implementation workflows involves parsing the design document and iteratively refining milestones one at a time. The process enforces explicit approvals after each milestone review, completing validation before proceeding to task decomposition.

Does the milestone review process include a handoff path to work planning?▼

Yes, the milestone review process includes a clear handoff path to work planning. After validating milestones through the template and pressure-testing phases, the workflow produces a structured output enabling downstream task decomposition and execution.

When do I need a formal milestone template for architecture changes?▼

You need a formal milestone template for architecture changes when milestones risk being under-specified, leading to misaligned expectations. Applying a template with job stories and acceptance criteria makes design intent observable and prevents wasted development cycles.