write-milestone-brief

Synthesize conversation and repository context into a milestone brief PRD.

1.0k|92|Updated May 22, 2026
One-click install
npx skills add https://github.com/open-gsd/gsd-pi --skill write-milestone-brief-open-gsd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-milestone-brief
Source: https://github.com/open-gsd/gsd-pi/tree/main/src/resources/skills/write-milestone-brief
Command: npx skills add https://github.com/open-gsd/gsd-pi --skill write-milestone-brief-open-gsd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts ongoing discussions and repository reality into a durable milestone brief (PRD) that downstream agents or humans can act on without additional context.

Core Features & Use Cases

  • Automated PRD generation: Produces a ready-to-use M###-CONTEXT.md consistent with the standard template.
  • Handoff-friendly output: Optionally files a GitHub issue with explicit user confirmation.
  • Non-interview synthesis: Does not re-interview participants; uses only existing information to capture decisions and rationale.

Quick Start

Provide the current discussion and repository context to generate a milestone brief.

Frequently Asked Questions about write-milestone-brief

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

FAQPage Schema
How do I generate a PRD milestone brief from existing conversation context?

To generate a PRD milestone brief, provide the current discussion and repository context. The skill synthesizes existing information into a populated M###-CONTEXT.md file without re-interviewing participants.

Does milestone brief generation require an interview to capture project decisions?

Milestone brief generation does not require an interview. It uses non-interview synthesis, relying solely on existing conversation and repository reality to capture decisions and rationale.

How do I create a ready-to-use PRD that downstream agents can execute?

You create a ready-to-use PRD by feeding the active milestone state and repository context. The skill outputs a durable M###-CONTEXT.md following the standard template, enabling seamless handoff for future agents.

Can I automatically file a GitHub issue after generating a milestone brief?

You can file a GitHub issue after generating a milestone brief. The skill provides this handoff-friendly output option but requires explicit user confirmation before creating the issue.

What is needed to produce an accurate context capture for a milestone brief?

Accurate context capture relies on the active milestone state and the standard template at src/resources/extensions/gsd/templates/context.md. Providing current discussion and repository reality ensures precision.

Are there limitations when using non-interview synthesis for documentation?

A limitation of non-interview synthesis is that it cannot extract new information. It only uses existing conversation and repo data, meaning undocumented decisions outside the current context will not appear in the milestone brief.