skills.rest
jmgirard
jmgirardCOMMUNITY
Explore all skills by this author →
Website𝕏@jeffreymgirardGitHub

milestone-plan

Plans scoped milestones with acceptance criteria and registers them in a project ROADMAP.

4|Updated Jul 11, 2026
Search Tags:#scoping#git workflow#claude code#roadmap#acceptance criteria#project tracking#milestone planning
One-click install
npx skills add https://github.com/jmgirard/cairn --skill milestone-plan-jmgirard
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: milestone-plan
Source: https://github.com/jmgirard/cairn/tree/main/skills/milestone-plan
Command: npx skills add https://github.com/jmgirard/cairn --skill milestone-plan-jmgirard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a vague feature idea into a concrete, reviewable plan is error-prone: scopes balloon, prior decisions get ignored, and acceptance criteria end up untestable. This Skill investigates the codebase, audits drafted criteria, and registers well-formed milestones in the cairn ROADMAP so any later session can pick the work up from the files alone. ## Core Features & Use Cases - Investigation and collision check: Reads code, DECISIONS.md, LESSONS.md, the ROADMAP, and open GitHub issues/PRs to surface prior art, rejections, and overlapping work before planning. - Criteria audit scaled to stakes: Classifies each milestone as user-facing or internal, then runs a full or reduced fresh-context audit of acceptance criteria for satisfiability, bounded promises, and proportionality. - Structured milestone files: Writes milestone files with positional AC/T labels, a coverage map, principles-touched and resolves slots, then commits plan and ROADMAP rows atomically. - Use Case: You ask "what would it take to add OAuth login?" The Skill investigates the auth code, checks for prior decisions, asks a batched question gate about scope and acceptance bar, then commits a planned milestone with verifiable criteria and a coverage map. ## Quick Start Ask the agent to plan a new milestone for the feature or idea you describe, for example by saying "plan a milestone to add CSV export to the reports page".

Frequently Asked Questions about milestone-plan

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

FAQPage Schema
How do I plan a new milestone with cairn?▼

Invoke /milestone-plan with a title or description of the work. The skill investigates the code and decision log, runs a question gate on scope and acceptance criteria, then writes milestone files and commits them with updated ROADMAP rows.

What makes a good acceptance criterion in milestone planning?▼

A criterion must be verifiable with evidence and make only bounded promises: any universal claim must name a procedure that enumerates its domain. The skill audits drafted criteria for satisfiability, instrument-binding, and proportionality to the milestone's surface tier before they are written.

Does milestone-plan check GitHub issues and pull requests?▼

Yes, it sweeps open issues and PRs with the gh CLI, filters out cairn's own in-flight branches, and poses overlapping items at the question gate as Resolves entries or candidate rows. If gh is missing or unauthenticated, it skips the sweep and continues planning.

What happens if my idea overlaps an existing milestone or rejected decision?▼

The collision check surfaces the overlap verbatim at the question gate. Planned milestones get amended or cross-referenced, archived work is referenced for extensions, and standing rejections must be superseded with a new decision entry before planning proceeds.

When does milestone-plan split work into multiple milestones?▼

When sizing tripwires fire, the skill creates multiple milestone files in one run rather than shrinking the scope. Deferred chunks that are not yet plannable become candidate rows in the ROADMAP, and a remainder ledger accounts for everything originally requested.

Related Skills

Explore More Software Engineering Skills→
DuySeuDuySeu
1

gsd-add-backlog

Capture and stage backlog ideas as 999.x phases with ROADMAP.md updates.

Community
Intermediate
giovannimnzgiovannimnz

gsd-verify-work

Evaluate phase acceptance criteria and definition of done to output READY or NEEDS_WORK status.

Community
Intermediate
ISmarshISmarsh

review-lessons

Audit memory files and project instructions to categorize lessons for template promotion.

Community
Intermediate
chohra-medchohra-med
28

spec-harness-tickets

Convert ticket tracker issues and ad-hoc plans into structured spec documents.

Community
Advanced