write-milestone-brief

To create a durable milestone brief, synthesize the current planning discussion and repository reality into a populated M###-CONTEXT.md file using a fixed template. This captures project description, rationale, outcomes, acceptance criteria, risks, and open questions.

A milestone brief is a durable document that stabilizes a planning discussion so future agents can act on it with zero additional context. You need it to capture rationale, outcomes, acceptance criteria, risks, and open questions before handing off to execution.

Yes, you can optionally file a GitHub issue from the milestone brief, but it requires explicit user confirmation. The Skill generates the M###-CONTEXT.md file first and only files the issue when explicitly confirmed.

No, the milestone brief generation does not re-interview or ask for additional context. It relies entirely on the known context from the existing conversation to stabilize the plan and hand off to execution.

You should generate a milestone brief once your planning discussion has stabilized. This ensures the synthesize process captures the finalized project description, rationale, outcomes, acceptance criteria, risks, and open questions accurately.