mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios.git
synced 2026-06-27 04:51:46 +00:00
Release v0.4.0: UX pipeline, game-dev improvements
## New Skills (9) - /quick-design: lightweight spec path for small changes (bypasses full GDD pipeline) - /story-readiness: validates stories are implementation-ready before pickup - /story-done: end-of-story completion review (criteria verification, deviation check, status update) - /sprint-status: fast 30-line sprint snapshot, read-only - /ux-design: guided section-by-section UX spec authoring (screen/flow/HUD/patterns) - /ux-review: UX spec validation with APPROVED/NEEDS REVISION/MAJOR REVISION verdict - /architecture-review, /create-architecture, /create-control-manifest, /create-epics-stories, /propagate-design-change, /review-all-gdds (pipeline completion) ## New Templates (7) - player-journey.md: 6-phase emotional arc, critical moments, retention hooks - difficulty-curve.md: difficulty axes, onboarding ramp, cross-system interactions - ux-spec.md: per-screen UX spec with states, interaction map, data requirements, events - hud-design.md: whole-game HUD with philosophy, info architecture, element specs - accessibility-requirements.md: project-wide accessibility tier commitment and audit - interaction-pattern-library.md: 26 standard + game-specific patterns with full state specs - architecture-traceability.md: GDD requirements to ADR coverage matrix ## Updated Skills & Templates - gate-check: Vertical Slice hard gate, playtesting strengthened, UX artifacts required - team-ui: full UX pipeline integration (/ux-design + /ux-review + accessibility-specialist) - game-design-document: Game Feel section (input latency, animation frames, impact moments) - implementation-agent-protocol: /story-done as explicit final step of every story - architecture-decision, design-system: pipeline completion updates Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Donchitos
167
.claude/skills/sprint-status/SKILL.md
Normal file
167
.claude/skills/sprint-status/SKILL.md
Normal file
@@ -0,0 +1,167 @@
|
||||
---
|
||||
name: sprint-status
|
||||
description: "Fast sprint status check. Reads the current sprint plan, scans story files for status, and produces a concise progress snapshot with burndown assessment and emerging risks. Run at any time during a sprint for quick situational awareness."
|
||||
argument-hint: "[sprint-number or blank for current]"
|
||||
user-invocable: true
|
||||
allowed-tools: Read, Glob, Grep
|
||||
---
|
||||
|
||||
# Sprint Status
|
||||
|
||||
This is a fast situational awareness check, not a sprint review. It reads the
|
||||
current sprint plan and story files, scans for status markers, and produces a
|
||||
concise snapshot in under 30 lines. For detailed sprint management, use
|
||||
`/sprint-plan update` or `/milestone-review`.
|
||||
|
||||
**This skill is read-only.** It never proposes changes, never asks to write
|
||||
files, and makes at most one concrete recommendation.
|
||||
|
||||
---
|
||||
|
||||
## 1. Find the Sprint
|
||||
|
||||
- If an argument is given (e.g., `/sprint-status 3`), search
|
||||
`production/sprints/` for a file matching `sprint-03.md`, `sprint-3.md`,
|
||||
or similar. Report which file was found.
|
||||
- If no argument is given, find the most recently modified file in
|
||||
`production/sprints/` and treat it as the current sprint.
|
||||
- If `production/sprints/` does not exist or is empty, report: "No sprint
|
||||
files found. Start a sprint with `/sprint-plan new`." Then stop.
|
||||
|
||||
Read the sprint file in full. Extract:
|
||||
- Sprint number and goal
|
||||
- Start date and end date
|
||||
- All story or task entries with their priority (Must Have / Should Have /
|
||||
Nice to Have), owner, and estimate
|
||||
|
||||
---
|
||||
|
||||
## 2. Calculate Days Remaining
|
||||
|
||||
Using today's date and the sprint end date from the sprint file, calculate:
|
||||
- Total sprint days (end minus start)
|
||||
- Days elapsed
|
||||
- Days remaining
|
||||
- Percentage of time consumed
|
||||
|
||||
If the sprint file does not include explicit dates, note "Sprint dates not
|
||||
found — burndown assessment skipped."
|
||||
|
||||
---
|
||||
|
||||
## 3. Scan Story Status
|
||||
|
||||
For each story or task referenced in the sprint plan:
|
||||
|
||||
1. If the entry references a story file path, check if the file exists.
|
||||
Read the file and scan for status markers: DONE, COMPLETE, IN PROGRESS,
|
||||
BLOCKED, NOT STARTED (case-insensitive).
|
||||
2. If the entry has no file path (inline task in the sprint plan), scan the
|
||||
sprint plan itself for status markers next to that entry.
|
||||
3. If no status marker is found, classify as NOT STARTED.
|
||||
4. If a file is referenced but does not exist, classify as MISSING and note it.
|
||||
|
||||
Optionally (fast check only — do not do a deep scan): grep `src/` for a
|
||||
directory or file name that matches the story's system slug to check for
|
||||
implementation evidence. This is a hint only, not a definitive status.
|
||||
|
||||
---
|
||||
|
||||
## 4. Burndown Assessment
|
||||
|
||||
Calculate:
|
||||
- Tasks complete (DONE or COMPLETE)
|
||||
- Tasks in progress (IN PROGRESS)
|
||||
- Tasks blocked (BLOCKED)
|
||||
- Tasks not started (NOT STARTED or MISSING)
|
||||
- Completion percentage: (complete / total) * 100
|
||||
|
||||
Assess burndown by comparing completion percentage to time consumed percentage:
|
||||
|
||||
- **On Track**: completion % is within 10 points of time consumed % or ahead
|
||||
- **At Risk**: completion % is 10-25 points behind time consumed %
|
||||
- **Behind**: completion % is more than 25 points behind time consumed %
|
||||
|
||||
If dates are unavailable, skip the burndown assessment and report "On Track /
|
||||
At Risk / Behind: unknown — sprint dates not found."
|
||||
|
||||
---
|
||||
|
||||
## 5. Output
|
||||
|
||||
Keep the total output to 30 lines or fewer. Use this format:
|
||||
|
||||
```markdown
|
||||
## Sprint [N] Status — [Today's Date]
|
||||
**Sprint Goal**: [from sprint plan]
|
||||
**Days Remaining**: [N] of [total] ([% time consumed])
|
||||
|
||||
### Progress: [complete/total] tasks ([%])
|
||||
|
||||
| Story / Task | Priority | Status | Owner | Blocker |
|
||||
|----------------------|------------|-------------|---------|----------------|
|
||||
| [title] | Must Have | DONE | [owner] | |
|
||||
| [title] | Must Have | IN PROGRESS | [owner] | |
|
||||
| [title] | Must Have | BLOCKED | [owner] | [brief reason] |
|
||||
| [title] | Should Have| NOT STARTED | [owner] | |
|
||||
|
||||
### Burndown: [On Track / At Risk / Behind]
|
||||
[1-2 sentences. If behind: which Must Haves are at risk. If on track: confirm
|
||||
and note any Should Haves the team could pull.]
|
||||
|
||||
### Must-Haves at Risk
|
||||
[List any Must Have stories that are BLOCKED or NOT STARTED with less than
|
||||
40% of sprint time remaining. If none, write "None."]
|
||||
|
||||
### Emerging Risks
|
||||
[Any risks visible from the story scan: missing files, cascading blockers,
|
||||
stories with no owner. If none, write "None identified."]
|
||||
|
||||
### Recommendation
|
||||
[One concrete action, or "Sprint is on track — no action needed."]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Fast Escalation Rules
|
||||
|
||||
Apply these rules before outputting, and place the flag at the TOP of the
|
||||
output if triggered (above the status table):
|
||||
|
||||
**Critical flag** — if Must Have stories are BLOCKED or NOT STARTED and
|
||||
less than 40% of the sprint time remains:
|
||||
|
||||
```
|
||||
SPRINT AT RISK: [N] Must Have stories are not complete with [X]% of sprint
|
||||
time remaining. Recommend replanning with `/sprint-plan update`.
|
||||
```
|
||||
|
||||
**Completion flag** — if all Must Have stories are DONE:
|
||||
|
||||
```
|
||||
All Must Haves complete. Team can pull from Should Have backlog.
|
||||
```
|
||||
|
||||
**Missing stories flag** — if any referenced story files do not exist:
|
||||
|
||||
```
|
||||
NOTE: [N] story files referenced in the sprint plan are missing.
|
||||
Run `/story-readiness sprint` to validate story file coverage.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Collaborative Protocol
|
||||
|
||||
This skill is read-only. It reports observed facts from files on disk.
|
||||
|
||||
- It does not update the sprint plan
|
||||
- It does not change story status
|
||||
- It does not propose scope cuts (that is `/sprint-plan update`)
|
||||
- It makes at most one recommendation per run
|
||||
|
||||
For more detail on a specific story, the user can read the story file directly
|
||||
or run `/story-readiness [path]`.
|
||||
|
||||
For sprint replanning, use `/sprint-plan update`.
|
||||
For end-of-sprint retrospective, use `/milestone-review`.
|
||||
Reference in New Issue
Block a user