SKILL.md
Sprint Perspectives
Generate a per-sprint PERSPECTIVES.md plus a card-style HTML/PDF report by:
- summarizing sprint anchor docs inside
docs/sprints/<sprint>/, and - using git history to discover which other docs/files were co-updated while those sprint docs were edited.
Quickstart
- Single sprint:
python skills/sprint-perspectives/scripts/generatesprintperspectives.py --sprint sprint-11 --no-pdf - All sprints:
python skills/sprint-perspectives/scripts/generatesprintperspectives.py --all --no-pdf
Optional Dev Graph (enrichment + visuals)
- Add window/subgraph receipts (requires Dev Graph API):
python skills/sprint-perspectives/scripts/generatesprintperspectives.py --sprint sprint-11 --dev-graph-api http://localhost:8080 --no-pdf - Embed visuals (drop SVG/PNG into the sprint folder first):
- Put files under: docs/sprints/sprint-11/devgraphvisuals/ - Then run: python skills/sprint-perspectives/scripts/generatesprint_perspectives.py --sprint sprint-11 --no-pdf
Outputs (per sprint folder)
docs/sprints/<sprint>/PERSPECTIVES.mddocs/sprints/<sprint>/linkeddocs.json(docs only)docs/sprints/<sprint>/cochangedfiles.json(all files)docs/sprints/<sprint>/SPRINTPERSPECTIVESCARDS.pdf(whenweasyprintis installed; otherwise HTML is left next to the intended PDF path)
Notes
- Works git-first (no Dev Graph required). When provided,
--dev-graph-apiadds sprint-window receipts and basic subgraph counts. - The main protagonist is documentation evidence (
.md/.txt/.pdf), but code-change metrics are included as supportive context.