milestone-implement

Implements a planned milestone on its own git branch with tests-first tasks and checkpoint commits.

4|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/jmgirard/cairn --skill milestone-implement-jmgirard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: milestone-implement
Source: https://github.com/jmgirard/cairn/tree/main/skills/milestone-implement
Command: npx skills add https://github.com/jmgirard/cairn --skill milestone-implement-jmgirard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns a planned milestone in a cairn-tracked repository into completed, verified code by driving the full implementation phase: branching, question gates, tests-first task execution, checkpoint commits, and status transitions, all recorded in the repo's markdown tracking files. ## Core Features & Use Cases - Branch and session management: Cuts or resumes a milestone branch from the synced default branch, handling both owner and guest (fork) collaboration modes with merge or rebase sync. - Tests-first autonomous task execution: Works tasks in order with tests first, runs the active toolchain profile's verify slot, and checkpoint-commits each task together with its milestone file update. - Gated plan amendments and audits: Handles minor and substantive plan amendments through question gates, runs fresh-context re-audits of amended acceptance criteria, and performs a claim audit of user-facing prose before review. - Use Case: A developer says "work on M107" and the skill resumes the milestone branch, runs the open question gate, implements remaining tasks with tests, and closes with a status table and the next command /milestone-review M107. ## Quick Start Ask the assistant to start or resume implementing a planned milestone by its ID, for example "work on M107" or "resume the milestone".

Frequently Asked Questions about milestone-implement

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

FAQPage Schema
How do I start implementing a milestone in a cairn repo?

Run /milestone-implement with the milestone ID, for example /milestone-implement M107. The skill verifies the milestone status is planned, syncs the default branch, cuts a new branch, and begins working tasks in order with tests first.

How do I resume a milestone that was blocked or left in progress?

Invoke the skill with the same milestone ID; it checks out the existing branch, merges or rebases the default branch if it has moved, re-runs the profile's verify slot, and continues from the unchecked tasks in the milestone file.

Can two milestones be in progress at the same time?

No. The skill enforces at most one in-progress milestone per repo. If another milestone is already in progress, it stops and routes you there or asks how to proceed before doing any work.

What happens if the plan needs to change during implementation?

Minor changes like reordering tasks are edited directly with a work-log line. Substantive changes to scope or acceptance criteria go through a mini question gate, and amended criteria are re-audited by a fresh-context reader before being written.

When is the claim audit step required?

The claim audit runs only when the milestone's surface tier is user-facing and the branch diff adds lines outside the cairn directory. A fresh-context reader checks every added claim about artifact behavior against the code before review.

What are the limitations of the guest collaboration mode?

In guest mode the default branch is never pushed, checkpoint commits carry code only without cairn tracking files, and resume uses rebase with force-with-lease push instead of merge. The commit guard denies staging any cairn path.