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.