gsd-ag 1.0.0

package/.gsd/templates/phase-summary.md

@@ -0,0 +1,52 @@
+# Phase {N} Summary
+
+> **Status**: Complete
+> **Completed**: YYYY-MM-DD
+
+## Objective
+{What this phase set out to accomplish.}
+
+## Deliverables
+
+| Deliverable | Status | Notes |
+|-------------|--------|-------|
+| {Deliverable 1} | ✅ | {Any relevant notes} |
+| {Deliverable 2} | ✅ | {Any relevant notes} |
+| {Deliverable 3} | ✅ | {Any relevant notes} |
+
+## Tasks Completed
+
+### Plan {N}.1: {Plan Name}
+- [x] {Task 1}
+- [x] {Task 2}
+
+### Plan {N}.2: {Plan Name}
+- [x] {Task 1}
+- [x] {Task 2}
+
+## Verification Results
+
+| Check | Result | Evidence |
+|-------|--------|----------|
+| {Verification 1} | ✅ Pass | {Command output / screenshot path} |
+| {Verification 2} | ✅ Pass | {Command output / screenshot path} |
+
+## Commits
+
+| Hash | Message |
+|------|---------|
+| `abc123` | feat(phase-N): {description} |
+| `def456` | feat(phase-N): {description} |
+
+## Lessons Learned
+- {What went well}
+- {What could be improved}
+- {Unexpected discoveries}
+
+## Next Steps
+- {What the next phase should address}
+- {Any deferred items}
+
+---
+
+*Completed: YYYY-MM-DD*

package/.gsd/templates/project.md

@@ -0,0 +1,124 @@
+# Project Template
+
+Template for `.gsd/SPEC.md` (or PROJECT.md) — project specification.
+
+---
+
+## File Template
+
+```markdown
+---
+status: DRAFT | FINALIZED
+created: [ISO timestamp]
+finalized: [ISO timestamp when status changed]
+---
+
+# SPEC.md — Project Specification
+
+## Vision
+
+{One paragraph describing what this project is and why it matters}
+
+---
+
+## Goals
+
+1. **{Primary Goal}**
+   {Brief description}
+
+2. **{Secondary Goal}**
+   {Brief description}
+
+3. **{Tertiary Goal}**
+   {Brief description}
+
+---
+
+## Non-Goals (Out of Scope)
+
+Explicitly NOT part of this project:
+
+- {Non-goal 1}
+- {Non-goal 2}
+- {Non-goal 3}
+
+---
+
+## Users
+
+**Primary User:** {Who}
+- {How they'll use it}
+- {What they need}
+
+**Secondary User:** {Who} (if applicable)
+- {How they'll use it}
+
+---
+
+## Constraints
+
+### Technical
+- {Technical constraint 1}
+- {Technical constraint 2}
+
+### Timeline
+- {Timeline constraint}
+
+### Other
+- {Budget, resources, etc.}
+
+---
+
+## Success Criteria
+
+How we know the project is successful:
+
+- [ ] {Measurable outcome 1}
+- [ ] {Measurable outcome 2}
+- [ ] {Measurable outcome 3}
+
+---
+
+## Prior Art
+
+Existing solutions or inspiration:
+
+| Solution | Pros | Cons | Relevance |
+|----------|------|------|-----------|
+| {solution} | {pros} | {cons} | {how it relates} |
+
+---
+
+## Open Questions
+
+Questions to resolve during planning:
+
+- [ ] {Question 1}
+- [ ] {Question 2}
+
+---
+
+## Decisions
+
+Key decisions made during specification:
+
+| Decision | Choice | Rationale | Date |
+|----------|--------|-----------|------|
+| {decision} | {choice} | {why} | {date} |
+```
+
+---
+
+## Status Flow
+
+1. **DRAFT** — Being written, not ready for planning
+2. **FINALIZED** — Approved, planning can begin
+
+**Planning Lock:** Cannot create plans until status is FINALIZED.
+
+## Guidelines
+
+- Keep vision to one paragraph
+- Goals should be achievable in one milestone
+- Non-goals are as important as goals
+- Success criteria must be measurable

package/.gsd/templates/requirements.md

@@ -0,0 +1,92 @@
+# Requirements Template
+
+Template for `.gsd/REQUIREMENTS.md` — formal requirements tracking with traceability.
+
+---
+
+## File Template
+
+```markdown
+---
+milestone: {name}
+updated: [ISO timestamp]
+---
+
+# Requirements
+
+## Overview
+
+Requirements derived from SPEC.md for traceability and coverage tracking.
+
+---
+
+## Functional Requirements
+
+| ID | Requirement | Source | Phase | Status |
+|----|-------------|--------|-------|--------|
+| REQ-01 | {requirement description} | SPEC Goal 1 | 1 | Pending |
+| REQ-02 | {requirement description} | SPEC Goal 1 | 1 | Pending |
+| REQ-03 | {requirement description} | SPEC Goal 2 | 2 | Pending |
+| REQ-04 | {requirement description} | SPEC Goal 2 | 2 | Pending |
+| REQ-05 | {requirement description} | SPEC Goal 3 | 3 | Pending |
+
+---
+
+## Non-Functional Requirements
+
+| ID | Requirement | Category | Phase | Status |
+|----|-------------|----------|-------|--------|
+| NFR-01 | Response time < 200ms | Performance | 4 | Pending |
+| NFR-02 | Mobile responsive | UX | All | Pending |
+| NFR-03 | 99% uptime | Reliability | 4 | Pending |
+
+---
+
+## Constraints
+
+| ID | Constraint | Source | Impact |
+|----|------------|--------|--------|
+| CON-01 | {constraint} | SPEC | {affected areas} |
+| CON-02 | {constraint} | Technical | {affected areas} |
+
+---
+
+## Traceability Matrix
+
+| Requirement | Plans | Tests | Status |
+|-------------|-------|-------|--------|
+| REQ-01 | 1.1, 1.2 | TC-01 | — |
+| REQ-02 | 1.2 | TC-02, TC-03 | — |
+| REQ-03 | 2.1 | TC-04 | — |
+
+---
+
+## Status Definitions
+
+| Status | Meaning |
+|--------|---------|
+| Pending | Not yet started |
+| In Progress | Being implemented |
+| Complete | Implemented and verified |
+| Blocked | Cannot proceed |
+| Deferred | Moved to later milestone |
+```
+
+---
+
+## Guidelines
+
+**Requirement IDs:**
+- REQ-XX: Functional requirements
+- NFR-XX: Non-functional requirements
+- CON-XX: Constraints
+
+**Good requirements are:**
+- Testable
+- Specific
+- Traceable to SPEC goals
+
+**Update when:**
+- Phase completes (mark requirements satisfied)
+- Scope changes (add/defer requirements)
+- Verification passes (update status)

package/.gsd/templates/roadmap.md

@@ -0,0 +1,103 @@
+# Roadmap Template
+
+Template for `.gsd/ROADMAP.md` — phase structure and progress tracking.
+
+---
+
+## File Template
+
+```markdown
+---
+milestone: {name}
+version: {semantic version}
+updated: [ISO timestamp]
+---
+
+# Roadmap
+
+> **Current Phase:** {N} - {name}
+> **Status:** {planning | executing | verifying}
+
+## Must-Haves (from SPEC)
+
+- [ ] {Must-have 1}
+- [ ] {Must-have 2}
+- [ ] {Must-have 3}
+
+---
+
+## Phases
+
+### Phase 1: {Foundation}
+**Status:** ⬜ Not Started | 🔄 In Progress | ✅ Complete
+**Objective:** {What this phase delivers}
+**Requirements:** REQ-01, REQ-02
+
+**Plans:**
+- [ ] Plan 1.1: {name}
+- [ ] Plan 1.2: {name}
+
+---
+
+### Phase 2: {Core Feature}
+**Status:** ⬜ Not Started
+**Objective:** {What this phase delivers}
+**Depends on:** Phase 1
+
+**Plans:**
+- [ ] Plan 2.1: {name}
+- [ ] Plan 2.2: {name}
+
+---
+
+### Phase 3: {Integration}
+**Status:** ⬜ Not Started
+**Objective:** {What this phase delivers}
+**Depends on:** Phase 2
+
+---
+
+### Phase 4: {Polish/Launch}
+**Status:** ⬜ Not Started
+**Objective:** {Final touches and deployment}
+**Depends on:** Phase 3
+
+---
+
+## Progress Summary
+
+| Phase | Status | Plans | Complete |
+|-------|--------|-------|----------|
+| 1 | ⬜ | 0/2 | — |
+| 2 | ⬜ | 0/2 | — |
+| 3 | ⬜ | 0/1 | — |
+| 4 | ⬜ | 0/1 | — |
+
+---
+
+## Timeline
+
+| Phase | Started | Completed | Duration |
+|-------|---------|-----------|----------|
+| 1 | — | — | — |
+| 2 | — | — | — |
+| 3 | — | — | — |
+| 4 | — | — | — |
+```
+
+---
+
+## Status Icons
+
+- ⬜ Not Started
+- 🔄 In Progress
+- ✅ Complete
+- ⏸️ Paused
+- ❌ Blocked
+
+## Guidelines
+
+- 3-5 phases per milestone
+- Each phase has clear deliverable
+- Dependencies flow forward
+- Update status as work progresses

package/.gsd/templates/spec.md

@@ -0,0 +1,51 @@
+# SPEC.md — Project Specification
+
+> **Status**: `DRAFT` | `FINALIZED`
+>
+> ⚠️ **Planning Lock**: No code may be written until this spec is marked `FINALIZED`.
+
+## Vision
+{One paragraph describing what this project is and why it exists.}
+
+## Goals
+1. **{Goal 1}** — {Brief description}
+2. **{Goal 2}** — {Brief description}
+3. **{Goal 3}** — {Brief description}
+
+## Non-Goals (Out of Scope)
+- {What this project explicitly will NOT do}
+- {Features that are intentionally excluded}
+- {Scope boundaries}
+
+## Constraints
+- {Technical constraint 1}
+- {Business constraint 1}
+- {Timeline constraint 1}
+
+## Success Criteria
+- [ ] {Measurable outcome 1}
+- [ ] {Measurable outcome 2}
+- [ ] {Measurable outcome 3}
+- [ ] {Measurable outcome 4}
+
+## User Stories (Optional)
+
+### As a {user type}
+- I want to {action}
+- So that {benefit}
+
+### As a {user type}
+- I want to {action}
+- So that {benefit}
+
+## Technical Requirements (Optional)
+
+| Requirement | Priority | Notes |
+|-------------|----------|-------|
+| {Requirement 1} | Must-have | {Details} |
+| {Requirement 2} | Should-have | {Details} |
+| {Requirement 3} | Nice-to-have | {Details} |
+
+---
+
+*Last updated: <!-- date -->*

package/.gsd/templates/sprint.md

@@ -0,0 +1,57 @@
+# Sprint {N} — {Sprint Name}
+
+> **Duration**: YYYY-MM-DD to YYYY-MM-DD
+> **Status**: In Progress | Complete
+
+## Goal
+{One sentence describing what this sprint aims to achieve.}
+
+## Scope
+
+### Included
+- {Feature/task 1}
+- {Feature/task 2}
+- {Feature/task 3}
+
+### Explicitly Excluded
+- {Out of scope item 1}
+- {Out of scope item 2}
+
+## Tasks
+
+| Task | Assignee | Status | Est. Hours |
+|------|----------|--------|------------|
+| {Task 1} | {who} | ⬜ Todo | {hours} |
+| {Task 2} | {who} | 🔄 In Progress | {hours} |
+| {Task 3} | {who} | ✅ Done | {hours} |
+
+## Daily Log
+
+### Day 1 (YYYY-MM-DD)
+- {What was accomplished}
+- {Blockers encountered}
+
+### Day 2 (YYYY-MM-DD)
+- {What was accomplished}
+- {Blockers encountered}
+
+## Risks & Blockers
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| {Risk 1} | {High/Med/Low} | {What can be done} |
+
+## Retrospective (end of sprint)
+
+### What Went Well
+- {Positive outcome 1}
+
+### What Could Improve
+- {Area for improvement 1}
+
+### Action Items
+- [ ] {Action to take in next sprint}
+
+---
+
+*Last updated: <!-- date -->*

package/.gsd/templates/stack.md

@@ -0,0 +1,62 @@
+# Technology Stack
+
+> Auto-generated by /map on <!-- date -->
+
+## Runtime
+
+| Technology | Version | Purpose |
+|------------|---------|---------|
+| {Language} | {version} | {purpose} |
+| {Framework} | {version} | {purpose} |
+| {Database} | {version} | {purpose} |
+
+## Core Technologies
+
+### {Category 1}
+| Feature | System | Purpose |
+|---------|--------|---------|
+| {Feature} | {System/Location} | {Purpose} |
+
+### {Category 2}
+| Directory | Files | Purpose |
+|-----------|-------|---------|
+| `{path}` | {count} | {purpose} |
+
+## Dependencies
+
+### External Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| {package} | {version} | {purpose} |
+
+### Internal Dependencies
+
+| Component | Depends On | Purpose |
+|-----------|------------|---------|
+| {Component A} | {Component B} | {Why dependency exists} |
+
+## Infrastructure
+
+| Service | Provider | Purpose |
+|---------|----------|---------|
+| {Service} | {Provider} | {Purpose} |
+
+**Repository:** {repository URL}
+
+## Configuration
+
+| Variable | Purpose | Location |
+|----------|---------|----------|
+| {VAR_NAME} | {What it controls} | {Where it's set} |
+
+## File Size Inventory
+
+| Category | Count | Total Lines (approx) |
+|----------|-------|---------------------|
+| {Category} | {count} | {lines} |
+| **Total** | **{total}** | **{total_lines}** |
+
+---
+
+*Last updated: <!-- date -->*

package/.gsd/templates/state.md

@@ -0,0 +1,92 @@
+# State Template
+
+Template for `.gsd/STATE.md` — project memory across sessions.
+
+---
+
+## File Template
+
+```markdown
+---
+updated: [ISO timestamp]
+---
+
+# Project State
+
+## Current Position
+
+**Milestone:** {name}
+**Phase:** {N} - {name}
+**Status:** {planning | executing | verifying | blocked}
+**Plan:** {current plan if executing}
+
+## Last Action
+
+{What was just completed}
+
+## Next Steps
+
+1. {Immediate next action}
+2. {Following action}
+3. {Third action if known}
+
+## Active Decisions
+
+Decisions made that affect current work:
+
+| Decision | Choice | Made | Affects |
+|----------|--------|------|---------|
+| {what} | {choice} | {date} | {phases/plans} |
+
+## Blockers
+
+{None if clear}
+
+- [ ] {Blocker 1}: {resolution approach}
+- [ ] {Blocker 2}: {resolution approach}
+
+## Concerns
+
+Things to watch but not blocking:
+
+- {Concern 1}
+- {Concern 2}
+
+## Session Context
+
+{Any context the next session needs to know}
+```
+
+---
+
+## Update Rules
+
+**Update STATE.md after:**
+- Every completed task
+- Every decision made
+- Any blocker identified
+- Session end/pause
+
+**What to update:**
+- `updated` timestamp
+- Current Position
+- Last Action
+- Next Steps
+
+**Keep it lean:**
+- STATE.md is read frequently
+- Only current context, not history
+- History goes in JOURNAL.md
+
+---
+
+## Resume Protocol
+
+When starting a new session:
+
+1. Read STATE.md first
+2. Understand current position
+3. Check blockers/concerns
+4. Continue from Next Steps
+
+The STATE.md is the "save game" for the project.