zaileys 2.2.7 → 3.0.0

package/.gsd/templates/discovery.md

@@ -0,0 +1,122 @@
+# Discovery Template
+
+Template for `.gsd/phases/{N}/DISCOVERY.md` — shallow research for library/option decisions.
+
+**Purpose:** Answer "which library/option should we use" questions during planning.
+
+For deep ecosystem research, use `/research-phase` which produces RESEARCH.md.
+
+---
+
+## File Template
+
+```markdown
+---
+phase: {N}
+type: discovery
+topic: [discovery-topic]
+---
+
+<discovery_objective>
+Discover [topic] to inform [phase name] implementation.
+
+Purpose: [What decision/implementation this enables]
+Scope: [Boundaries]
+Output: DISCOVERY.md with recommendation
+</discovery_objective>
+
+<discovery_scope>
+<include>
+- [Question to answer]
+- [Area to investigate]
+- [Specific comparison if needed]
+</include>
+
+<exclude>
+- [Out of scope for this discovery]
+- [Defer to implementation phase]
+</exclude>
+</discovery_scope>
+
+<discovery_protocol>
+
+**Source Priority:**
+1. **Official Docs** — Authoritative, current
+2. **Web Search** — For comparisons, trends (verify findings)
+3. **GitHub** — For real usage patterns
+
+**Quality Checklist:**
+- [ ] All claims have authoritative sources
+- [ ] Negative claims verified with official docs
+- [ ] Alternative approaches considered
+- [ ] Recent updates checked for breaking changes
+
+**Confidence Levels:**
+- HIGH: Official docs confirm
+- MEDIUM: Multiple sources confirm
+- LOW: Single source or training knowledge only
+
+</discovery_protocol>
+```
+
+---
+
+## Output Structure
+
+Create `.gsd/phases/{N}/DISCOVERY.md`:
+
+```markdown
+# [Topic] Discovery
+
+## Summary
+[2-3 paragraph executive summary]
+
+## Primary Recommendation
+[What to do and why — specific and actionable]
+
+## Alternatives Considered
+[What else was evaluated and why not chosen]
+
+## Key Findings
+
+### [Category 1]
+- [Finding with source URL]
+
+### [Category 2]
+- [Finding with relevance]
+
+## Code Examples
+[Relevant patterns if applicable]
+
+## Metadata
+
+<confidence level="high|medium|low">
+[Why this confidence level]
+</confidence>
+
+<sources>
+- [Primary sources used]
+</sources>
+
+<open_questions>
+[What needs validation during implementation]
+</open_questions>
+```
+
+---
+
+## When to Use
+
+**Use discovery when:**
+- Technology choice unclear (library A vs B)
+- Best practices needed for unfamiliar integration
+- API/library investigation required
+
+**Don't use when:**
+- Established patterns (CRUD, auth with known library)
+- Questions answerable from project context
+
+**Use RESEARCH.md instead when:**
+- Niche/complex domains (3D, games, audio)
+- Need ecosystem knowledge, not just library choice
+- "How do experts build this" questions

package/.gsd/templates/journal.md

@@ -0,0 +1,46 @@
+# JOURNAL.md — Session Log
+
+> **Purpose**: Chronicle of work sessions for context continuity.
+
+---
+
+## Sessions
+
+## Session: YYYY-MM-DD HH:MM
+
+### Objective
+{What you set out to accomplish this session.}
+
+### Accomplished
+- ✅ {Task 1 completed}
+- ✅ {Task 2 completed}
+  - {Sub-detail if needed}
+- ✅ {Task 3 completed}
+
+### Verification
+- [x] {Verification check 1}
+- [x] {Verification check 2}
+- [ ] {Verification pending}
+
+### Blockers Encountered
+- {Blocker 1 and how it was resolved}
+- {Blocker 2 — still open}
+
+### Handoff Notes
+- {Important context for next session}
+- {Files that need attention}
+- {Decisions that need to be made}
+
+---
+
+## Session: YYYY-MM-DD HH:MM
+
+### Objective
+{Previous session objective.}
+
+### Accomplished
+- ✅ {Completed items}
+
+---
+
+*Last updated: <!-- date -->*

package/.gsd/templates/milestone.md

@@ -0,0 +1,91 @@
+# Milestone Template
+
+Template for `.gsd/milestones/{name}/MILESTONE.md` — milestone definition and tracking.
+
+---
+
+## File Template
+
+```markdown
+---
+name: {milestone-name}
+version: {semantic version, e.g., v1.0}
+status: planning | active | complete | archived
+created: [ISO timestamp]
+target_date: [optional target]
+---
+
+# Milestone: {name}
+
+## Vision
+
+{What this milestone achieves — one paragraph}
+
+## Must-Haves
+
+Non-negotiable deliverables for this milestone:
+
+- [ ] {Must-have 1}
+- [ ] {Must-have 2}
+- [ ] {Must-have 3}
+
+## Nice-to-Haves
+
+If time permits:
+
+- [ ] {Nice-to-have 1}
+- [ ] {Nice-to-have 2}
+
+## Phases
+
+| Phase | Name | Status | Objective |
+|-------|------|--------|-----------|
+| 1 | {name} | ⬜ Not Started | {objective} |
+| 2 | {name} | ⬜ Not Started | {objective} |
+| 3 | {name} | ⬜ Not Started | {objective} |
+
+## Success Criteria
+
+How we know milestone is complete:
+
+- [ ] {Measurable criterion 1}
+- [ ] {Measurable criterion 2}
+
+## Architecture Decisions
+
+Key technical decisions for this milestone:
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+| {decision} | {choice} | {why} |
+
+## Risks
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|------------|--------|------------|
+| {risk} | Low/Med/High | Low/Med/High | {action} |
+
+## Progress Log
+
+| Date | Event | Notes |
+|------|-------|-------|
+| {date} | Milestone started | — |
+```
+
+---
+
+## Lifecycle
+
+1. **Creation:** `/new-milestone` creates this file
+2. **Active:** Updated as phases complete
+3. **Complete:** `/complete-milestone` moves to archive
+4. **Archived:** Read-only reference
+
+---
+
+## Guidelines
+
+- One active milestone at a time
+- 3-5 phases per milestone
+- Must-haves should be testable
+- Success criteria should be measurable

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 -->*