teamspec 3.2.0

package/teamspec-core/templates/refinement-notes-template.md

@@ -0,0 +1,133 @@
+# Refinement Agenda: [Date]
+
+<!-- 
+  ⚠️ REFINEMENT RULES
+  
+  All refinement decisions affecting behavior must be synced to Feature Canon.
+  
+  RULES:
+  1. Stories must link to features
+  2. Impact type must be determined
+  3. If behavior changes, Canon sync is scheduled
+  4. No orphan stories allowed
+-->
+
+> **Template Version**: 2.0  
+> **Last Updated**: 2026-01-07
+
+---
+
+**Document Owner:** FA (Functional Analyst)  
+**Artifact Type:** Meeting Notes  
+**Lifecycle:** Historical after refinement
+
+---
+
+**Attendees**: [List]  
+**Date**: YYYY-MM-DD  
+**Facilitator**: [FA Name]
+
+---
+
+## Stories to Refine
+
+| Story ID | Title | Feature(s) | Impact Type | Est | Ready? |
+|:---------|:------|-----------|-------------|:---:|:------:|
+| S-XXX | [Title] | F-XXX | Adds/Changes/Fixes/Tech | ? | [ ] |
+| S-YYY | [Title] | F-YYY | Adds/Changes/Fixes/Tech | ? | [ ] |
+
+**Column Definitions**:
+- **Feature(s)**: Which Feature ID(s) from `/features/features-index.md`
+- **Impact Type**: Adds Behavior / Changes Behavior / Fixes Defect / Technical Only
+- **Est**: Estimate in points
+- **Ready?**: Passes DoR checklist
+
+---
+
+## Discussion Notes
+
+### S-XXX: [Story Title]
+
+**Discussion**:
+- [Key point 1]
+- [Key point 2]
+
+**Decisions**:
+- [Decision made]
+
+**Questions for BA/Stakeholders**:
+- [ ] [Open question]
+
+**Estimate**: {N} points
+
+---
+
+### S-YYY: [Story Title]
+
+**Discussion**:
+- [Key point 1]
+
+**Decisions**:
+- [Decision made]
+
+**Estimate**: {N} points
+
+---
+
+## Decisions Made
+
+| Decision | Feature Impact | Follow-up |
+|----------|----------------|-----------|
+| [Decision 1] | F-XXX: [What changes] | FA will sync to Feature Canon |
+| [Decision 2] | F-YYY: [What changes] | FA will sync to Feature Canon |
+
+---
+
+## Feature Canon Sync Notes (MANDATORY)
+
+> ⚠️ Any decision that **changes system behavior** MUST be synced to the Feature Canon.
+
+For each story with impact "Adds Behavior" or "Changes Behavior":
+
+| Story | Feature | Canon Current? | Sync Needed? | Assigned To |
+|-------|---------|----------------|--------------|-------------|
+| S-XXX | F-XXX | [ ] | [ ] | [FA Name] |
+| S-YYY | F-YYY | [ ] | [ ] | [FA Name] |
+
+---
+
+## Action Items
+
+- [ ] [Who] to check [What] by [Date]
+- [ ] FA to run `ts:fa sync` after [Story] is complete
+- [ ] Verify Feature Canon updated before sprint close
+
+---
+
+## Refinement Quality Gate
+
+Before approving stories to "Ready":
+
+- [ ] All stories linked to Feature ID(s)
+- [ ] Feature files exist for all linked features
+- [ ] Impact type marked (not "unknown")
+- [ ] If behavior changes, Feature Canon update is scheduled
+- [ ] No orphan stories (all have feature links)
+- [ ] Estimates assigned
+- [ ] Acceptance Criteria complete
+
+---
+
+## Stories Ready to Move
+
+| Story | From | To | FA Approved |
+|-------|------|----|-------------|
+| S-XXX | backlog | ready-to-refine | [ ] |
+| S-YYY | ready-to-refine | ready-for-development | [ ] |
+
+---
+
+## Next Refinement
+
+**Date**: YYYY-MM-DD  
+**Stories to prepare**: [List]

package/teamspec-core/templates/sprint-goal-template.md

@@ -0,0 +1,129 @@
+# Sprint {N} Goal
+
+> **Template Version**: 2.0  
+> **Last Updated**: 2026-01-07  
+> **Sprint Duration**: {YYYY-MM-DD} to {YYYY-MM-DD}  
+> **Status**: Planning | Active | Closed
+
+---
+
+**Document Owner:** SM (Scrum Master)  
+**Artifact Type:** Operational (Sprint-bound)  
+**Location:** `sprints/sprint-{N}/sprint-goal.md`
+
+---
+
+## Sprint Goal
+
+> {One clear, measurable objective that the team commits to achieving this sprint}
+
+**Success Criteria**:
+- [ ] {Specific, measurable outcome 1}
+- [ ] {Specific, measurable outcome 2}
+- [ ] {Specific, measurable outcome 3}
+
+---
+
+## Sprint Metadata
+
+| Field | Value |
+|-------|-------|
+| **Sprint Number** | {N} |
+| **Start Date** | {YYYY-MM-DD} |
+| **End Date** | {YYYY-MM-DD} |
+| **Capacity** | {N} points |
+| **Scrum Master** | @{sm} |
+
+---
+
+## Committed Stories
+
+| Story ID | Title | Points | Dev Plan | Owner | Status |
+|----------|-------|--------|----------|-------|--------|
+| [S-XXX](../../stories/ready-for-development/S-XXX-*.md) | {Title} | {N} | [Plan](../../dev-plans/story-XXX-tasks.md) | @{dev} | Not Started |
+
+**Total Committed**: {N} points
+
+---
+
+## Sprint Scope
+
+### In Scope
+- {Feature/capability being delivered}
+- {Feature/capability being delivered}
+
+### Out of Scope
+- {Explicitly excluded items}
+- {Deferred to future sprint}
+
+### Dependencies
+- {External dependency or blocker}
+
+---
+
+## Acceptance Criteria for Sprint Goal
+
+**Given** the sprint is complete  
+**When** we review the deliverables  
+**Then**:
+- [ ] {Goal criterion 1 is met}
+- [ ] {Goal criterion 2 is met}
+- [ ] All committed stories meet Definition of Done
+- [ ] Feature Canon updated for all behavior-changing stories
+
+---
+
+## Daily Progress
+
+| Day | Date | Remaining Pts | Notes |
+|-----|------|---------------|-------|
+| 1 | {YYYY-MM-DD} | {N} | Sprint started |
+
+---
+
+## Blockers & Risks
+
+| Issue | Impact | Owner | Status |
+|-------|--------|-------|--------|
+| _None_ | | | |
+
+---
+
+## Canon Sync Tracking
+
+| Story | Impact Type | Canon Updated? | FA Verified |
+|-------|-------------|----------------|-------------|
+| S-XXX | Adds/Changes | [ ] | [ ] |
+
+---
+
+## Sprint Review Notes
+
+_To be filled at sprint review_
+
+### Demo Items
+- [ ] {Story/feature to demo}
+
+### Stakeholder Feedback
+- {Feedback item}
+
+---
+
+## Retrospective Actions
+
+_To be filled at retrospective_
+
+| What went well | What to improve | Action item |
+|----------------|-----------------|-------------|
+| | | |
+
+---
+
+## Sprint Closure
+
+| Metric | Value |
+|--------|-------|
+| Velocity | _TBD_ |
+| Completion Rate | _TBD_ |
+| Canon Sync Complete | [ ] |
+| Closed Date | _TBD_ |

package/teamspec-core/templates/sprint-template.md

@@ -0,0 +1,175 @@
+# Sprint {N}
+
+<!-- 
+  ⚠️ SPRINT ≠ SCOPE DEFINITION
+  
+  This sprint is a TIME-BOXED execution snapshot.
+  
+  RULES:
+  1. Sprint does not define scope (Features do)
+  2. Sprint does not change priority (BA does)
+  3. Only SM can modify sprint contents
+  4. Scope changes require explicit Decision Log entry
+  
+  After sprint commitment, scope changes must be logged in /decisions/
+-->
+
+> **Template Version**: 2.0  
+> **Last Updated**: 2026-01-07  
+> **Location**: `sprints/sprint-{N}/sprint-goal.md`
+
+---
+
+**Document Owner:** SM (Scrum Master)  
+**Artifact Type:** Operational (Sprint-bound)  
+**Lifecycle:** Active during sprint, archived after close
+
+---
+
+## Sprint Goal
+
+> {One-sentence sprint objective that describes what value will be delivered}
+
+---
+
+## Metadata
+
+| Field | Value |
+|-------|-------|
+| Sprint | {N} |
+| Start Date | {YYYY-MM-DD} |
+| End Date | {YYYY-MM-DD} |
+| Status | 🟡 Planning / 🟢 Active / ✅ Closed |
+| Capacity | {N} points |
+| Scrum Master | @{sm} |
+
+---
+
+## Success Criteria
+
+- [ ] {Measurable outcome 1}
+- [ ] {Measurable outcome 2}
+- [ ] {Measurable outcome 3}
+
+---
+
+## Scope Freeze Notice
+
+**Sprint Committed:** [ ] Yes / [ ] No  
+**Commitment Date:** ________________
+
+> ⚠️ After commitment, any scope change requires:
+> 1. SM to facilitate discussion
+> 2. BA to approve scope change
+> 3. Decision logged in /decisions/DEC-XXX.md
+> 4. Story removed/added with explicit note
+
+---
+
+## Committed Stories
+
+<!-- TEAMSPEC RULE: TS-DEVPLAN-001 - Dev plan required before implementation -->
+
+| Story ID | Title | Points | Dev Plan | Owner | Status |
+|----------|-------|--------|----------|-------|--------|
+| [S-XXX](../../stories/ready-for-development/S-XXX-*.md) | {Title} | {N} | [Plan](../../dev-plans/story-XXX-tasks.md) | @dev | ⚪ Not Started |
+
+> ⚠️ All committed stories must have a Dev Plan before implementation starts.
+
+**Total Committed**: {N} points
+
+**Status Legend**: 🟢 Done | 🟡 In Progress | ⚪ Not Started | 🔴 Blocked
+
+---
+
+## Burndown
+
+| Metric | Value |
+|--------|-------|
+| **Total** | {N} points |
+| **Completed** | {N} points |
+| **Remaining** | {N} points |
+| **Progress** | {N}% |
+
+```
+[░░░░░░░░░░░░░░░░░░░░] 0%
+```
+
+---
+
+## Scope Changes
+
+> ⚠️ All scope changes after commitment must be documented here.
+
+| Date | Change | Story | Reason | Decision | Approved By |
+|------|--------|-------|--------|----------|-------------|
+| _None_ | | | | | |
+
+---
+
+## Blockers
+
+| Story | Blocker | Days Blocked | Escalated To |
+|-------|---------|--------------|--------------|
+| _None_ | | | |
+
+---
+
+## Daily Progress
+
+| Date | Completed | Notes |
+|------|-----------|-------|
+| {YYYY-MM-DD} | — | Sprint kickoff |
+
+---
+
+## Canon Sync Verification
+
+> ⚠️ Before sprint close, verify Feature Canon is updated for all behavior-changing stories.
+
+| Story | Impact Type | Canon Updated? | FA Verified |
+|-------|-------------|----------------|-------------|
+| S-XXX | Adds/Changes | [ ] | [ ] |
+
+---
+
+## Review Notes
+
+_Sprint review observations and stakeholder feedback._
+
+### Demo Items
+
+- [ ] {Story/feature to demo}
+
+### Stakeholder Feedback
+
+- {Feedback item}
+
+---
+
+## Retrospective Actions
+
+- [ ] {Action item from retrospective}
+
+---
+
+## Closure
+
+| Metric | Value |
+|--------|-------|
+| Velocity | _TBD_ |
+| Completion Rate | _TBD_ |
+| Bugs Found | _TBD_ |
+| Bugs Fixed | _TBD_ |
+| Canon Sync Complete | [ ] Yes |
+| Closed Date | _TBD_ |
+
+---
+
+## Linter Rules Enforced
+
+| Rule | Description |
+|------|-------------|
+| TS-STORY-004 | Only SM can assign stories to sprint |
+| TS-DEVPLAN-001 | Dev plan required before implementation |
+| TS-DOD-001 | Canon sync required before sprint close |

package/teamspec-core/templates/sprints-index-template.md

@@ -0,0 +1,67 @@
+# Sprints Index
+
+> **Template Version**: 2.0  
+> **Last Updated**: 2026-01-07  
+> **Note**: This index provides an overview of all sprints. See [active-sprint.md](active-sprint.md) for live status.
+
+---
+
+**Document Owner:** SM (Scrum Master)  
+**Artifact Type:** Index (Living)  
+**Location:** `sprints/sprints-index.md`
+
+---
+
+## Active Sprint
+
+| Sprint | Goal | Status | Progress |
+|--------|------|--------|----------|
+| [Sprint {N}](sprint-{N}/sprint-goal.md) | {Goal summary} | 🟢 Active | {N}% |
+
+---
+
+## Sprint History
+
+| Sprint | Goal | Velocity | Canon Sync | Status | Dates |
+|--------|------|----------|------------|--------|-------|
+| [Sprint {N-1}](sprint-{N-1}/sprint-goal.md) | {Goal} | {N} pts | ✅ | ✅ Closed | {Start} - {End} |
+| [Sprint {N-2}](sprint-{N-2}/sprint-goal.md) | {Goal} | {N} pts | ✅ | ✅ Closed | {Start} - {End} |
+
+---
+
+## Velocity Trend
+
+| Sprint | Committed | Completed | Velocity | Canon Items |
+|--------|-----------|-----------|----------|-------------|
+| Sprint {N-1} | {N} pts | {N} pts | {N} pts | {N} |
+| Sprint {N-2} | {N} pts | {N} pts | {N} pts | {N} |
+
+**Average Velocity**: {N} pts
+
+---
+
+## Folder Structure
+
+```
+sprints/
+├── active-sprint.md           # Living doc - current sprint status
+├── sprints-index.md           # This file - sprint history
+├── sprint-1/
+│   └── sprint-goal.md
+├── sprint-2/
+│   └── sprint-goal.md
+└── archive/                   # Optional: archived sprints
+    └── sprint-0/
+        └── sprint-goal.md
+```
+
+---
+
+## Quick Links
+
+- [Active Sprint](active-sprint.md)
+- [Definition of Ready](../.teamspec/definitions/definition-of-ready.md)
+- [Definition of Done](../.teamspec/definitions/definition-of-done.md)
+- [Feature Canon](../features/)
+- [Stories Backlog](../stories/backlog/)
+- [Ready for Development](../stories/ready-for-development/)