mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios.git
synced 2026-06-27 04:51:46 +00:00
b139bcf087
Creates .claude/docs/director-gates.md as a central registry of 18 named gate prompts (CD-*, TD-*, PR-*, LP-*, QL-*, ND-*, AD-*) covering all 7 production stages. Skills now reference gate IDs instead of embedding inline director prompts, eliminating drift when prompts need updating. Updated 15 skills to use gate IDs: brainstorm, map-systems, design-system, architecture-decision, create-architecture, create-epics, create-stories, sprint-plan, milestone-review, playtest-report, prototype, story-done, gate-check, setup-engine, start. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
124 lines
3.7 KiB
Markdown
124 lines
3.7 KiB
Markdown
---
|
|
name: milestone-review
|
|
description: "Generates a comprehensive milestone progress review including feature completeness, quality metrics, risk assessment, and go/no-go recommendation. Use at milestone checkpoints or when evaluating readiness for a milestone deadline."
|
|
argument-hint: "[milestone-name|current]"
|
|
user-invocable: true
|
|
allowed-tools: Read, Glob, Grep, Write
|
|
---
|
|
|
|
## Phase 1: Load Milestone Data
|
|
|
|
Read the milestone definition from `production/milestones/`. If the argument is `current`, use the most recently modified milestone file.
|
|
|
|
Read all sprint reports for sprints within this milestone from `production/sprints/`.
|
|
|
|
---
|
|
|
|
## Phase 2: Scan Codebase Health
|
|
|
|
- Scan for `TODO`, `FIXME`, `HACK` markers that indicate incomplete work
|
|
- Check the risk register at `production/risk-register/`
|
|
|
|
---
|
|
|
|
## Phase 3: Generate the Milestone Review
|
|
|
|
```markdown
|
|
# Milestone Review: [Milestone Name]
|
|
|
|
## Overview
|
|
- **Target Date**: [Date]
|
|
- **Current Date**: [Today]
|
|
- **Days Remaining**: [N]
|
|
- **Sprints Completed**: [X/Y]
|
|
|
|
## Feature Completeness
|
|
|
|
### Fully Complete
|
|
| Feature | Acceptance Criteria | Test Status |
|
|
|---------|-------------------|-------------|
|
|
|
|
### Partially Complete
|
|
| Feature | % Done | Remaining Work | Risk to Milestone |
|
|
|---------|--------|---------------|------------------|
|
|
|
|
### Not Started
|
|
| Feature | Priority | Can Cut? | Impact of Cutting |
|
|
|---------|----------|----------|------------------|
|
|
|
|
## Quality Metrics
|
|
- **Open S1 Bugs**: [N] -- [List]
|
|
- **Open S2 Bugs**: [N]
|
|
- **Open S3 Bugs**: [N]
|
|
- **Test Coverage**: [X%]
|
|
- **Performance**: [Within budget? Details]
|
|
|
|
## Code Health
|
|
- **TODO count**: [N across codebase]
|
|
- **FIXME count**: [N]
|
|
- **HACK count**: [N]
|
|
- **Technical debt items**: [List critical ones]
|
|
|
|
## Risk Assessment
|
|
| Risk | Status | Impact if Realized | Mitigation Status |
|
|
|------|--------|-------------------|------------------|
|
|
|
|
## Velocity Analysis
|
|
- **Planned vs Completed** (across all sprints): [X/Y tasks = Z%]
|
|
- **Trend**: [Improving / Stable / Declining]
|
|
- **Adjusted estimate for remaining work**: [Days needed at current velocity]
|
|
|
|
## Scope Recommendations
|
|
### Protect (Must ship with milestone)
|
|
- [Feature and why]
|
|
|
|
### At Risk (May need to cut or simplify)
|
|
- [Feature and risk]
|
|
|
|
### Cut Candidates (Can defer without compromising milestone)
|
|
- [Feature and impact of cutting]
|
|
|
|
## Go/No-Go Assessment
|
|
|
|
**Recommendation**: [GO / CONDITIONAL GO / NO-GO]
|
|
|
|
**Conditions** (if conditional):
|
|
- [Condition 1 that must be met]
|
|
- [Condition 2 that must be met]
|
|
|
|
**Rationale**: [Explanation of the recommendation]
|
|
|
|
## Action Items
|
|
| # | Action | Owner | Deadline |
|
|
|---|--------|-------|----------|
|
|
```
|
|
|
|
---
|
|
|
|
## Phase 3b: Producer Risk Assessment
|
|
|
|
Before generating the Go/No-Go recommendation, spawn `producer` via Task using gate **PR-MILESTONE** (`.claude/docs/director-gates.md`).
|
|
|
|
Pass: milestone name and target date, current completion percentage, blocked story count, velocity data from sprint reports (if available), list of cut candidates.
|
|
|
|
Present the producer's assessment inline within the Go/No-Go section. The producer's verdict (ON TRACK / AT RISK / OFF TRACK) informs the overall recommendation — do not issue a GO against an OFF TRACK producer verdict without explicit user acknowledgement.
|
|
|
|
---
|
|
|
|
## Phase 4: Save Review
|
|
|
|
Present the review to the user.
|
|
|
|
Ask: "May I write this to `production/milestones/[milestone-name]-review.md`?"
|
|
|
|
If yes, write the file, creating the directory if needed. Verdict: **COMPLETE** — milestone review saved.
|
|
|
|
If no, stop here. Verdict: **BLOCKED** — user declined write.
|
|
|
|
---
|
|
|
|
## Phase 5: Next Steps
|
|
|
|
- Run `/gate-check` for a formal phase gate verdict if this milestone marks a development phase boundary.
|
|
- Run `/sprint-plan` to adjust the next sprint based on the scope recommendations above.
|