zaileys 2.2.7 → 3.0.0

package/.agent/workflows/remove-phase.md

@@ -0,0 +1,139 @@
+---
+description: Remove a phase from the roadmap (with safety checks)
+argument-hint: "<phase-number>"
+---
+
+# /remove-phase Workflow
+
+<objective>
+Remove a phase from the roadmap, with safety checks for in-progress or completed work.
+</objective>
+
+<process>
+
+## 1. Validate Phase Exists
+
+**PowerShell:**
+```powershell
+$phase = Select-String -Path ".gsd/ROADMAP.md" -Pattern "### Phase $N:"
+if (-not $phase) {
+    Write-Error "Phase $N not found in ROADMAP.md"
+}
+```
+
+**Bash:**
+```bash
+if ! grep -q "### Phase $N:" ".gsd/ROADMAP.md"; then
+    echo "Error: Phase $N not found in ROADMAP.md" >&2
+fi
+```
+
+---
+
+## 2. Check Phase Status
+
+**PowerShell:**
+```powershell
+$status = Select-String -Path ".gsd/ROADMAP.md" -Pattern "Phase $N:.*\n.*Status: (.*)"
+```
+
+**Bash:**
+```bash
+status=$(grep -A1 "Phase $N:" ".gsd/ROADMAP.md" | grep "Status:" | cut -d: -f2)
+```
+
+**Safety checks:**
+
+| Status | Action |
+|--------|--------|
+| ⬜ Not Started | Safe to remove |
+| 🔄 In Progress | Warn and confirm |
+| ✅ Complete | Error — archive instead |
+
+---
+
+## 3. Check for Dependencies
+
+Are other phases depending on this one?
+
+**PowerShell:**
+```powershell
+Select-String -Path ".gsd/ROADMAP.md" -Pattern "Depends on.*Phase $N"
+```
+
+**Bash:**
+```bash
+grep "Depends on.*Phase $N" ".gsd/ROADMAP.md"
+```
+
+**If dependencies exist:**
+```
+⚠️ Phase {M} depends on Phase {N}
+
+Cannot remove. Consider:
+1. Update dependent phases first
+2. Use /insert-phase to restructure
+```
+
+---
+
+## 4. Confirm Removal
+
+```
+⚠️ CONFIRM REMOVAL
+
+Phase {N}: {name}
+Status: {status}
+
+This will:
+- Remove phase from ROADMAP.md
+- Delete .gsd/phases/{N}/ if exists
+- Renumber subsequent phases
+
+Type "REMOVE" to confirm:
+```
+
+---
+
+## 5. Remove Phase
+
+1. Delete from ROADMAP.md
+2. Remove `.gsd/phases/{N}/` directory
+3. Renumber subsequent phases (N+1 becomes N, etc.)
+4. Update dependencies
+
+---
+
+## 6. Update STATE.md
+
+If currently in removed phase, set to previous phase or "Planning".
+
+---
+
+## 7. Commit
+
+```bash
+git add -A
+git commit -m "docs: remove phase {N} - {name}"
+```
+
+---
+
+## 8. Display Result
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► PHASE REMOVED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Removed: Phase {N}: {name}
+Renumbered: {M} phases
+
+───────────────────────────────────────────────────────
+
+/progress — See updated roadmap
+
+───────────────────────────────────────────────────────
+```
+
+</process>

package/.agent/workflows/research-phase.md

@@ -0,0 +1,160 @@
+---
+description: Deep technical research for a phase
+argument-hint: "<phase-number> [--level 1|2|3]"
+---
+
+# /research-phase Workflow
+
+<objective>
+Conduct technical research to inform planning decisions for a phase.
+</objective>
+
+<discovery_levels>
+## Discovery Levels
+
+| Level | Time | Use When |
+|-------|------|----------|
+| 0 | 0 min | Already know, just doing it |
+| 1 | 2-5 min | Single library, confirming syntax |
+| 2 | 15-30 min | Choosing between options, new integration |
+| 3 | 1+ hour | Architectural decision, novel problem |
+
+**Default:** Level 2 unless specified.
+</discovery_levels>
+
+<process>
+
+## 1. Load Phase Context
+
+Read:
+- Phase objective from ROADMAP.md
+- Relevant ARCHITECTURE.md sections
+- STACK.md for current technologies
+
+---
+
+## 2. Identify Research Questions
+
+What needs to be understood before planning?
+
+```markdown
+## Research Questions
+
+1. {Technical question 1}
+2. {Technical question 2}
+3. {Integration question}
+```
+
+---
+
+## 3. Conduct Research
+
+Based on discovery level:
+
+**Level 1:** Quick verification
+- Check official docs
+- Confirm API/syntax
+
+**Level 2:** Comparison research
+- Compare 2-3 options
+- Evaluate trade-offs
+- Make recommendation
+
+**Level 3:** Deep dive
+- Prototype if needed
+- Research edge cases
+- Document unknowns
+
+---
+
+## 4. Generate RESEARCH.md
+
+Create `.gsd/phases/{N}/RESEARCH.md`:
+
+```markdown
+---
+phase: {N}
+level: {1|2|3}
+researched_at: {date}
+---
+
+# Phase {N} Research
+
+## Questions Investigated
+1. {question}
+2. {question}
+
+## Findings
+
+### {Topic 1}
+{What was learned}
+
+**Sources:**
+- {URL}
+
+**Recommendation:** {what to do}
+
+### {Topic 2}
+...
+
+## Decisions Made
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+| {decision} | {choice} | {why} |
+
+## Patterns to Follow
+- {pattern 1}
+- {pattern 2}
+
+## Anti-Patterns to Avoid
+- {anti-pattern}: {why}
+
+## Dependencies Identified
+| Package | Version | Purpose |
+|---------|---------|---------|
+| {pkg} | {ver} | {why} |
+
+## Risks
+- {risk}: {mitigation}
+
+## Ready for Planning
+- [x] Questions answered
+- [x] Approach selected
+- [x] Dependencies identified
+```
+
+---
+
+## 5. Commit Research
+
+```powershell
+git add .gsd/phases/{N}/RESEARCH.md
+git commit -m "docs(phase-{N}): research complete"
+```
+
+---
+
+## 6. Offer Next Steps
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► RESEARCH COMPLETE ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Phase {N}: {name}
+Level: {level}
+
+Key findings:
+• {finding 1}
+• {finding 2}
+
+───────────────────────────────────────────────────────
+
+▶ NEXT
+
+/plan {N} — Create plans informed by research
+
+───────────────────────────────────────────────────────
+```
+
+</process>

package/.agent/workflows/resume.md

@@ -0,0 +1,131 @@
+---
+description: Restore context from previous session
+---
+
+# /resume Workflow
+
+<objective>
+Start a new session with full context from where we left off.
+</objective>
+
+<process>
+
+## 1. Load Saved State
+
+Read `.gsd/STATE.md` completely.
+
+---
+
+## 2. Display Context
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► RESUMING SESSION
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+LAST POSITION
+─────────────
+Phase: {phase from STATE.md}
+Task: {task from STATE.md}
+Status: {status when paused}
+
+───────────────────────────────────────────────────────
+
+CONTEXT FROM LAST SESSION
+─────────────────────────
+{Context dump content from STATE.md}
+
+───────────────────────────────────────────────────────
+
+BLOCKERS
+────────
+{Blockers from STATE.md, or "None"}
+
+───────────────────────────────────────────────────────
+
+NEXT STEPS (from last session)
+──────────────────────────────
+1. {First priority}
+2. {Second priority}
+3. {Third priority}
+
+───────────────────────────────────────────────────────
+```
+
+---
+
+## 3. Load Recent Journal
+
+Show last entry from `.gsd/JOURNAL.md`:
+- What was accomplished
+- Handoff notes
+- Any issues encountered
+
+---
+
+## 4. Check for Conflicts
+
+```bash
+# Check for uncommitted changes
+git status --porcelain
+```
+
+**If changes found:**
+```
+⚠️ UNCOMMITTED CHANGES DETECTED
+
+{list of modified files}
+
+These may be from the previous session.
+Review before proceeding.
+```
+
+---
+
+## 5. Update State
+
+Mark session as active in `.gsd/STATE.md`:
+```markdown
+**Status**: Active (resumed {timestamp})
+```
+
+---
+
+## 6. Suggest Action
+
+```
+───────────────────────────────────────────────────────
+
+▶ READY TO CONTINUE
+
+Suggested action based on state:
+
+{One of:}
+• /execute {N} — Continue phase execution
+• /verify {N} — Verify completed phase
+• /plan {N} — Create plans for phase
+• /progress — See full roadmap status
+
+───────────────────────────────────────────────────────
+
+💡 Fresh session = fresh perspective
+
+You have all the context you need.
+The previous struggles are documented.
+Time to solve this with fresh eyes.
+
+───────────────────────────────────────────────────────
+```
+
+</process>
+
+<fresh_context_advantage>
+A resumed session has advantages:
+
+1. **No accumulated confusion** — You see the problem clearly
+2. **Documented failures** — You know what NOT to try
+3. **Hypothesis preserved** — Pick up where logic left off
+4. **Full context budget** — 200k tokens of fresh capacity
+
+Often the first thing a fresh context sees is the obvious solution that a tired context missed.
+</fresh_context_advantage>

package/.agent/workflows/update.md

@@ -0,0 +1,203 @@
+---
+description: Update GSD to the latest version from GitHub
+---
+
+# /update Workflow
+
+<objective>
+Update GSD for Antigravity to the latest version from GitHub.
+</objective>
+
+<process>
+
+## 1. Check Current Version
+
+**PowerShell:**
+```powershell
+if (Test-Path "CHANGELOG.md") {
+    $version = Select-String -Path "CHANGELOG.md" -Pattern "## \[(\d+\.\d+\.\d+)\]" | 
+        Select-Object -First 1
+    Write-Output "Current version: $($version.Matches.Groups[1].Value)"
+}
+```
+
+**Bash:**
+```bash
+if [ -f "CHANGELOG.md" ]; then
+    version=$(grep -oP '## \[\K[0-9]+\.[0-9]+\.[0-9]+' CHANGELOG.md | head -1)
+    echo "Current version: $version"
+fi
+```
+
+---
+
+## 2. Fetch Latest from GitHub
+
+```bash
+# Clone latest to temp directory
+git clone --depth 1 https://github.com/toonight/get-shit-done-for-antigravity.git .gsd-update-temp
+```
+
+---
+
+## 3. Compare Versions
+
+**PowerShell:**
+```powershell
+$remoteVersion = Select-String -Path ".gsd-update-temp/CHANGELOG.md" -Pattern "## \[(\d+\.\d+\.\d+)\]" | 
+    Select-Object -First 1
+
+Write-Output "Remote version: $($remoteVersion.Matches.Groups[1].Value)"
+```
+
+**Bash:**
+```bash
+remote_version=$(grep -oP '## \[\K[0-9]+\.[0-9]+\.[0-9]+' .gsd-update-temp/CHANGELOG.md | head -1)
+echo "Remote version: $remote_version"
+```
+
+**If same version:**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► ALREADY UP TO DATE ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Version: {version}
+
+No updates available.
+
+───────────────────────────────────────────────────────
+```
+Exit after cleanup.
+
+---
+
+## 4. Show Changes
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► UPDATE AVAILABLE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Current: {current-version}
+Latest:  {remote-version}
+
+Changes:
+{Extract from CHANGELOG.md}
+
+───────────────────────────────────────────────────────
+
+Update now?
+A) Yes — Apply updates
+B) No — Cancel
+
+───────────────────────────────────────────────────────
+```
+
+---
+
+## 5. Apply Updates
+
+**If user confirms:**
+
+**PowerShell:**
+```powershell
+# Backup current
+Copy-Item -Recurse ".agent" ".agent.backup"
+Copy-Item -Recurse ".gsd/templates" ".gsd/templates.backup"
+
+# Update workflows and skills (preserve user's .gsd docs)
+Copy-Item -Recurse -Force ".gsd-update-temp/.agent/*" ".agent/"
+
+# Update templates only
+Copy-Item -Recurse -Force ".gsd-update-temp/.gsd/templates/*" ".gsd/templates/"
+
+# Update GSD core files
+Copy-Item -Force ".gsd-update-temp/.gsd/GSD-STYLE.md" ".gsd/"
+Copy-Item -Force ".gsd-update-temp/.gsd/PROJECT_RULES.md" ".gsd/"
+Copy-Item -Force ".gsd-update-temp/.gsd/model_capabilities.yaml" ".gsd/"
+Copy-Item -Recurse -Force ".gsd-update-temp/.gsd/adapters" ".gsd/"
+Copy-Item -Recurse -Force ".gsd-update-temp/.gsd/docs" ".gsd/"
+Copy-Item -Recurse -Force ".gsd-update-temp/.gsd/scripts" ".gsd/"
+
+# Update root files
+Copy-Item -Force ".gsd-update-temp/CHANGELOG.md" "./"
+Copy-Item -Force ".gsd-update-temp/VERSION" "./"
+```
+
+**Bash:**
+```bash
+# Backup current
+cp -r .agent .agent.backup
+cp -r .gsd/templates .gsd/templates.backup
+
+# Update workflows and skills (preserve user's .gsd docs)
+cp -r .gsd-update-temp/.agent/* .agent/
+
+# Update templates only
+cp -r .gsd-update-temp/.gsd/templates/* .gsd/templates/
+
+# Update GSD core files
+cp .gsd-update-temp/.gsd/GSD-STYLE.md .gsd/
+cp .gsd-update-temp/.gsd/PROJECT_RULES.md .gsd/
+cp .gsd-update-temp/.gsd/model_capabilities.yaml .gsd/
+cp -r .gsd-update-temp/.gsd/adapters .gsd/
+cp -r .gsd-update-temp/.gsd/docs .gsd/
+cp -r .gsd-update-temp/.gsd/scripts .gsd/
+
+# Update root files
+cp .gsd-update-temp/CHANGELOG.md ./
+cp .gsd-update-temp/VERSION ./
+```
+
+---
+
+## 6. Cleanup
+
+**PowerShell:**
+```powershell
+Remove-Item -Recurse -Force ".gsd-update-temp"
+Remove-Item -Recurse -Force ".agent.backup"
+Remove-Item -Recurse -Force ".gsd/templates.backup"
+```
+
+**Bash:**
+```bash
+rm -rf .gsd-update-temp
+rm -rf .agent.backup
+rm -rf .gsd/templates.backup
+```
+
+---
+
+## 7. Confirm
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► UPDATED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Updated to version {remote-version}
+
+───────────────────────────────────────────────────────
+
+/whats-new — See what changed
+
+───────────────────────────────────────────────────────
+```
+
+</process>
+
+<preserved_files>
+These user files are NEVER overwritten:
+- .gsd/SPEC.md
+- .gsd/ROADMAP.md
+- .gsd/STATE.md
+- .gsd/ARCHITECTURE.md
+- .gsd/STACK.md
+- .gsd/DECISIONS.md
+- .gsd/JOURNAL.md
+- .gsd/TODO.md
+- .gsd/phases/*
+- .gemini/GEMINI.md
+</preserved_files>