milestone-brief

Escalates hard technical questions to Fable-level review via self-contained review briefs and ingests the resulting reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a milestone hits a question the current session cannot settle—statistical correctness, high-stakes design decisions—this Skill provides a governed escalation path: it drafts a self-contained Review Brief (RB), gates spawning a stronger Fable model behind explicit user approval, and ingests the resulting Review Report (RR) back into project tracking files. ## Core Features & Use Cases - Review Brief creation: Generates a fully self-contained RB file in cairn/reviews/ with background, exact files/lines, numbered questions, and constraints, assuming zero conversation context. - Approval-gated Fable escalation: Presents scope and token-cost estimates through an approval gate before spawning a Fable subagent, or emits a copyable prompt for manual handoff. - RR ingestion: Records review answers as dated decision entries, promotes cross-cutting findings to cairn/DECISIONS.md, ingests binding criteria verbatim into milestone acceptance criteria, and archives the RB/RR pair. - Use Case: A milestone is blocked on whether a statistical method is correct. Run the skill to draft RB07, get user approval, spawn a Fable review, then ingest RR07 so its binding criteria become numbered acceptance criteria on the milestone. ## Quick Start Ask the agent to escalate the current blocking question by running /milestone-brief with the milestone id and topic, for example to request a Fable review of a statistical design decision.

Frequently Asked Questions about milestone-brief

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

FAQPage Schema
How do I escalate a technical question to a stronger model review?

Run /milestone-brief with the milestone id and topic. It drafts a self-contained Review Brief in cairn/reviews/, then asks for explicit approval before spawning a Fable subagent or giving you a copyable prompt for a manual session.

What is a Review Brief and Review Report in cairn?

A Review Brief (RB) is a self-contained markdown file with background, exact files and lines, and numbered questions. A Review Report (RR) is the Fable model's written response, which gets ingested into milestone decisions and acceptance criteria.

Does spawning a Fable review require user approval?

Yes, every Fable spawn requires explicit per-instance user approval through an AskUserQuestion gate showing scope and token-cost estimates. There is no standing default, and the skill never spawns Fable without this gate.

What happens when a Review Report contains binding criteria?

Binding criteria are ingested verbatim into the milestone's acceptance criteria as numbered items with trace tags, after a fresh-context audit checks them for satisfiability. Any departure is recorded in a Deviations table, and validation string-compares the criteria against the report.

What if the Review Report does not answer the brief's questions?

The report is marked unresolved and a fresh brief with a new number is drafted rather than re-ingesting the bad artifact. Pasted review content is normalized into a proper RR file and ingested normally.