zaileys 2.2.7 → 3.0.0

package/.gsd/templates/RESEARCH.md

@@ -0,0 +1,75 @@
+# RESEARCH.md Template
+
+> Copy this template when documenting phase research.
+
+```markdown
+---
+phase: {N}
+researched_at: {YYYY-MM-DD}
+discovery_level: 1 | 2 | 3
+---
+
+# Phase {N} Research
+
+## Objective
+{What question is this research answering?}
+
+## Discovery Level
+**Level {1|2|3}** — {Quick verification | Standard research | Deep dive}
+
+## Key Decisions
+
+### Decision 1: {Topic}
+**Question:** {What needed to be decided?}
+**Options Considered:**
+1. {Option A}: {pros/cons}
+2. {Option B}: {pros/cons}
+3. {Option C}: {pros/cons}
+
+**Decision:** {Which option and why}
+**Confidence:** {High | Medium | Low}
+
+### Decision 2: {Topic}
+...
+
+## Findings
+
+### {Topic 1}
+{What was learned}
+
+**Sources:**
+- {URL or reference}
+- {URL or reference}
+
+### {Topic 2}
+{What was learned}
+
+## Patterns to Follow
+- {Pattern 1}: {How to apply it}
+- {Pattern 2}: {How to apply it}
+
+## Anti-Patterns to Avoid
+- {Anti-pattern 1}: {Why to avoid}
+- {Anti-pattern 2}: {Why to avoid}
+
+## Dependencies Identified
+| Package | Version | Purpose |
+|---------|---------|---------|
+| {pkg} | {ver} | {why needed} |
+
+## Risks
+- **{Risk 1}:** {Impact and mitigation}
+- **{Risk 2}:** {Impact and mitigation}
+
+## Recommendations for Planning
+1. {Recommendation 1}
+2. {Recommendation 2}
+```
+
+## Discovery Levels
+
+| Level | Time | Use When |
+|-------|------|----------|
+| 1 | 2-5 min | Single known library, confirming syntax |
+| 2 | 15-30 min | Choosing between options, new integration |
+| 3 | 1+ hour | Architectural decision, novel problem |

package/.gsd/templates/SUMMARY.md

@@ -0,0 +1,103 @@
+# Summary Template
+
+Template for `.gsd/phases/{N}/{plan}-SUMMARY.md` — execution summary after plan completion.
+
+---
+
+## File Template
+
+```markdown
+---
+phase: {N}
+plan: {M}
+completed_at: [ISO timestamp]
+duration_minutes: {N}
+status: complete | partial | failed
+---
+
+# Summary: {Plan Name}
+
+## Results
+
+- **Tasks:** {N}/{M} completed
+- **Commits:** {N}
+- **Verification:** {passed | failed}
+
+---
+
+## Tasks Completed
+
+| Task | Description | Commit | Status |
+|------|-------------|--------|--------|
+| 1 | {task name} | {hash} | ✅ Complete |
+| 2 | {task name} | {hash} | ✅ Complete |
+| 3 | {task name} | — | ❌ Blocked |
+
+---
+
+## Files Changed
+
+| File | Change Type | Description |
+|------|-------------|-------------|
+| {path} | Created | {what it does} |
+| {path} | Modified | {what changed} |
+| {path} | Deleted | {why removed} |
+
+---
+
+## Deviations Applied
+
+{If none: "None — executed as planned."}
+
+### Rule 1 — Bug Fixes
+- {description of bug fixed}
+
+### Rule 2 — Missing Critical
+- {description of functionality added}
+
+### Rule 3 — Blocking Issues
+- {description of blocker fixed}
+
+---
+
+## Verification
+
+| Check | Status | Evidence |
+|-------|--------|----------|
+| {verification 1} | ✅ Pass | {command/output} |
+| {verification 2} | ✅ Pass | {command/output} |
+
+---
+
+## Notes
+
+{Any observations, concerns, or recommendations for future phases}
+
+---
+
+## Metadata
+
+- **Started:** {timestamp}
+- **Completed:** {timestamp}
+- **Duration:** {N} minutes
+- **Context Usage:** ~{N}%
+```
+
+---
+
+## Guidelines
+
+**Create SUMMARY.md:**
+- After each plan completes
+- Before moving to next plan
+- Even if plan failed (document what happened)
+
+**Include:**
+- All commits with hashes
+- All deviations (never hide these)
+- Verification results with evidence
+
+**Keep it factual:**
+- No opinions
+- Just what happened
+- Evidence over claims

package/.gsd/templates/UAT.md

@@ -0,0 +1,168 @@
+# UAT Template
+
+Template for `.gsd/phases/{N}/UAT.md` — User Acceptance Testing checklist.
+
+**Purpose:** Structured manual testing protocol for human verification checkpoints.
+
+---
+
+## File Template
+
+```markdown
+---
+phase: {N}
+type: uat
+created: [ISO timestamp]
+status: pending | in_progress | passed | failed
+---
+
+# Phase {N} UAT
+
+## Overview
+
+**Phase:** {name}
+**Goal:** {what this phase delivers}
+**Tester:** User
+**Date:** {date}
+
+---
+
+## Test Environment
+
+**Setup Required:**
+- [ ] Dev server running (`npm run dev`)
+- [ ] Database seeded with test data
+- [ ] Browser dev tools open for error monitoring
+
+**Test Data:**
+- User: test@example.com / password123
+- Other relevant test accounts/data
+
+---
+
+## Test Cases
+
+### TC-01: {Test Case Name}
+
+**Scenario:** {What user is trying to do}
+
+**Steps:**
+1. {Step 1}
+2. {Step 2}
+3. {Step 3}
+
+**Expected Result:**
+- {What should happen}
+
+**Actual Result:**
+- [ ] PASS
+- [ ] FAIL — Issue: ___
+
+---
+
+### TC-02: {Test Case Name}
+
+**Scenario:** {What user is trying to do}
+
+**Steps:**
+1. {Step 1}
+2. {Step 2}
+
+**Expected Result:**
+- {What should happen}
+
+**Actual Result:**
+- [ ] PASS
+- [ ] FAIL — Issue: ___
+
+---
+
+## Edge Cases
+
+### EC-01: {Edge Case Name}
+
+**Test:** {What to try}
+**Expected:** {Graceful handling}
+**Result:** [ ] PASS  [ ] FAIL
+
+---
+
+## Error Scenarios
+
+### ERR-01: {Error Scenario}
+
+**Trigger:** {How to cause error}
+**Expected Behavior:** {Error message, recovery}
+**Result:** [ ] PASS  [ ] FAIL
+
+---
+
+## Visual Verification
+
+### VIS-01: Layout
+
+- [ ] Responsive on mobile (375px)
+- [ ] Responsive on tablet (768px)
+- [ ] Desktop layout correct (1024px+)
+- [ ] No horizontal scroll
+- [ ] All text readable
+
+### VIS-02: Styling
+
+- [ ] Colors match design system
+- [ ] Fonts correct
+- [ ] Spacing consistent
+- [ ] Icons display correctly
+
+---
+
+## Summary
+
+| Category | Pass | Fail | Total |
+|----------|------|------|-------|
+| Functional | | | |
+| Edge Cases | | | |
+| Errors | | | |
+| Visual | | | |
+
+**Overall Status:** [ ] APPROVED  [ ] NEEDS FIXES
+
+**Issues Found:**
+1. {Issue description}
+2. {Issue description}
+
+**Notes:**
+{Any additional observations}
+```
+
+---
+
+## Usage Guidelines
+
+**When to create UAT:**
+- After phase execution complete
+- Before marking phase as verified
+- For any `checkpoint:human-verify` tasks
+
+**Who runs UAT:**
+- User (always)
+- AI cannot verify visual/UX elements
+
+**After UAT:**
+- If PASSED: Phase can be marked complete
+- If FAILED: Create gap closure plans with `/plan-milestone-gaps`
+
+---
+
+## Test Case Guidelines
+
+**Good test cases:**
+- Specific, reproducible steps
+- Clear expected results
+- One scenario per test case
+
+**Categories to cover:**
+1. Happy path (main functionality)
+2. Edge cases (boundary conditions)
+3. Error handling (invalid input, failures)
+4. Visual/UX (layout, responsiveness)

package/.gsd/templates/VERIFICATION.md

@@ -0,0 +1,70 @@
+# VERIFICATION.md Template
+
+> Copy this template when creating phase verification reports.
+
+```markdown
+---
+phase: {N}
+verified_at: {YYYY-MM-DD HH:MM}
+verdict: PASS | FAIL | PARTIAL
+pass_count: {X}
+total_count: {Y}
+---
+
+# Phase {N} Verification Report
+
+## Summary
+
+**{X}/{Y}** must-haves verified
+**Verdict:** {PASS | FAIL | PARTIAL}
+
+## Must-Haves
+
+### ✅ 1. {Must-have description}
+**Status:** PASS
+**Method:** {How this was verified}
+**Evidence:**
+```
+{Actual command output or screenshot reference}
+```
+
+### ❌ 2. {Must-have description}
+**Status:** FAIL
+**Method:** {How this was verified}
+**Expected:** {What should happen}
+**Actual:** {What actually happened}
+**Evidence:**
+```
+{Actual command output}
+```
+**Gap:** {What needs to be fixed}
+
+### ⏭️ 3. {Must-have description}
+**Status:** SKIPPED
+**Reason:** {Why this couldn't be verified}
+
+## Gap Closure Required
+
+{If verdict is FAIL or PARTIAL, list what needs fixing}
+
+1. **{Gap 1}:** {Description of what's wrong and how to fix}
+2. **{Gap 2}:** {Description}
+
+## Next Steps
+
+{Based on verdict}
+
+- If PASS: Proceed to next phase
+- If FAIL: Run `/execute {N} --gaps-only` after fixing
+- If PARTIAL: Address gaps then re-verify
+```
+
+## Evidence Types
+
+| Verification | Evidence Required |
+|--------------|-------------------|
+| API endpoint | curl command + response |
+| UI behavior | Screenshot |
+| Test suite | Test output |
+| File exists | `ls` or `dir` output |
+| Build passes | Build command output |

package/.gsd/templates/architecture.md

@@ -0,0 +1,67 @@
+# Architecture
+
+> Auto-generated by /map on <!-- date -->
+
+## Overview
+
+{Brief description of the system and its purpose.}
+
+```
+┌───────────────────────────────────────────────────────────────┐
+│                          USER                                 │
+└────────────────────────┬──────────────────────────────────────┘
+                         │
+                         ▼
+┌───────────────────────────────────────────────────────────────┐
+│                     COMPONENT A                               │
+└────────────────────────┬──────────────────────────────────────┘
+                         │
+                         ▼
+┌───────────────────────────────────────────────────────────────┐
+│                     COMPONENT B                               │
+└───────────────────────────────────────────────────────────────┘
+```
+
+## Components
+
+### Component A
+- **Purpose:** {What this component does}
+- **Location:** `{path/to/component}`
+- **Files:** {count} files
+- **Pattern:** {architectural pattern used}
+
+| File | Purpose | Priority |
+|------|---------|----------|
+| file1 | {purpose} | {high/medium/low} |
+| file2 | {purpose} | {high/medium/low} |
+
+### Component B
+- **Purpose:** {What this component does}
+- **Location:** `{path/to/component}`
+
+## Data Flow
+
+1. **User initiates action** (e.g., {example})
+2. **Component A processes** {what happens}
+3. **Component B receives** {what happens}
+4. **Result returned** to user
+
+## Technical Debt
+
+- [ ] {Identified debt item 1}
+- [ ] {Identified debt item 2}
+- [ ] {Identified debt item 3}
+
+## Conventions
+
+**Naming:**
+- {Convention 1}
+- {Convention 2}
+
+**Structure:**
+- {Convention 1}
+- {Convention 2}
+
+---
+
+*Last updated: <!-- date -->*

package/.gsd/templates/context.md

@@ -0,0 +1,91 @@
+# Context Template
+
+Template for `.gsd/phases/{N}/CONTEXT.md` — user's vision for a phase.
+
+---
+
+## File Template
+
+```markdown
+---
+phase: {N}
+name: {phase-name}
+created: [ISO timestamp]
+---
+
+# Phase {N} Context
+
+## Vision
+
+{How the user imagines this phase working — in their words}
+
+## What's Essential
+
+Non-negotiable aspects:
+
+- {Essential 1}
+- {Essential 2}
+- {Essential 3}
+
+## What's Flexible
+
+Open to different implementations:
+
+- {Flexible 1}
+- {Flexible 2}
+
+## What's Out of Scope
+
+Explicitly NOT part of this phase:
+
+- {Out of scope 1}
+- {Out of scope 2}
+
+## User Expectations
+
+### Look and Feel
+{How it should appear/behave}
+
+### Performance
+{Speed/responsiveness expectations}
+
+### Integration
+{How it fits with existing work}
+
+## Examples / Inspiration
+
+{Any examples the user referenced}
+
+## Questions Answered
+
+Clarifications from /discuss-phase:
+
+| Question | Answer |
+|----------|--------|
+| {question} | {answer} |
+
+## Constraints
+
+Technical or business constraints:
+
+- {Constraint 1}
+- {Constraint 2}
+```
+
+---
+
+## When to Create
+
+Created by `/discuss-phase` to capture user's vision before planning.
+
+## How to Use
+
+- Planner reads CONTEXT.md to understand intent
+- Executor honors the vision during implementation
+- Verifier checks against user expectations
+
+## Guidelines
+
+- Capture user's words, not AI interpretation
+- Focus on WHAT, not HOW
+- Keep it short — vision, not specification

package/.gsd/templates/decisions.md

@@ -0,0 +1,37 @@
+# DECISIONS.md — Architecture Decision Records
+
+> **Purpose**: Log significant technical decisions and their rationale.
+
+## Template
+
+```markdown
+## [DECISION-XXX] Title
+
+**Date**: YYYY-MM-DD
+**Status**: Proposed | Accepted | Deprecated | Superseded
+
+### Context
+What is the issue we're facing?
+
+### Decision
+What have we decided to do?
+
+### Rationale
+Why did we make this decision?
+
+### Consequences
+What are the trade-offs?
+
+### Alternatives Considered
+What other options were evaluated?
+```
+
+---
+
+## Decisions
+
+<!-- Add new decisions below -->
+
+---
+
+*Last updated: <!-- date -->*