Skip to main content
ClaudeWave
Skill0 repo starsupdated yesterday

mindforge-milestone-summary

The mindforge-milestone-summary skill generates a structured project overview by synthesizing completed milestone artifacts (roadmap, requirements, context, summary, and verification files) into a single comprehensive document for team onboarding and review. Use this skill when a project milestone is complete and new team members need to understand what was built, the architectural decisions made, and how to get oriented quickly.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/sairam0424/MindForge /tmp/mindforge-milestone-summary && cp -r /tmp/mindforge-milestone-summary/.agent/skills/mindforge-milestone-summary ~/.claude/skills/mindforge-milestone-summary
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

<objective>
Generate a structured milestone summary for team onboarding and project review. Reads completed milestone artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION files) and produces a human-friendly overview of what was built, how, and why.

Purpose: Enable new team members to understand a completed project by reading one document and asking follow-up questions.
Output: MILESTONE_SUMMARY written to `.planning/reports/`, presented inline, optional interactive Q&A.
</objective>

<execution_context>
@.agent/workflows/mindforge-milestone-summary.md
</execution_context>

<context>
**Project files:**
- `.planning/ROADMAP.md`
- `.planning/PROJECT.md`
- `.planning/STATE.md`
- `.planning/RETROSPECTIVE.md`
- `.planning/milestones/v{version}-ROADMAP.md` (if archived)
- `.planning/milestones/v{version}-REQUIREMENTS.md` (if archived)
- `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)

**User input:**
- Version: $ARGUMENTS (optional — defaults to current/latest milestone)
</context>

<process>
Read and execute the milestone-summary workflow from @.agent/workflows/mindforge-milestone-summary.md end-to-end.
</process>

<success_criteria>
- Milestone version resolved (from args, STATE.md, or archive scan)
- All available artifacts read (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
- Summary document written to `.planning/reports/MILESTONE_SUMMARY-v{version}.md`
- All 7 sections generated (Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, Getting Started)
- Summary presented inline to user
- Interactive Q&A offered
- STATE.md updated
</success_criteria>