gsd-ag 1.0.0

package/.agent/workflows/install.md

@@ -0,0 +1,152 @@
+---
+description: Install GSD into the current project from GitHub
+---
+
+# /install Workflow
+
+<objective>
+Install GSD for Antigravity into the current project from GitHub.
+</objective>
+
+<process>
+
+## 1. Check for Existing Installation
+
+Look for GSD marker directories:
+
+**PowerShell:**
+```powershell
+$alreadyInstalled = (Test-Path ".agent") -or (Test-Path ".gsd")
+if ($alreadyInstalled) {
+    Write-Output "GSD files detected in this project."
+}
+```
+
+**Bash:**
+```bash
+if [ -d ".agent" ] || [ -d ".gsd" ]; then
+    echo "GSD files detected in this project."
+fi
+```
+
+**If already installed:**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► ALREADY INSTALLED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+GSD files already exist in this project.
+
+───────────────────────────────────────────────────────
+
+A) Reinstall — Overwrite with latest version
+B) Cancel — Keep current installation
+
+If you want to update instead: /update
+
+───────────────────────────────────────────────────────
+```
+
+If user chooses Cancel, exit.
+If user chooses Reinstall, continue to Step 2.
+
+---
+
+## 2. Clone from GitHub
+
+```bash
+git clone --depth 1 https://github.com/toonight/get-shit-done-for-antigravity.git .gsd-install-temp
+```
+
+---
+
+## 3. Copy Files
+
+**PowerShell:**
+```powershell
+# Core directories
+Copy-Item -Recurse ".gsd-install-temp\.agent" ".\"
+Copy-Item -Recurse ".gsd-install-temp\.gemini" ".\"
+Copy-Item -Recurse ".gsd-install-temp\.gsd" ".\"
+```
+
+**Bash:**
+```bash
+# Core directories
+cp -r .gsd-install-temp/.agent ./
+cp -r .gsd-install-temp/.gemini ./
+cp -r .gsd-install-temp/.gsd ./
+```
+
+---
+
+## 4. Cleanup
+
+**PowerShell:**
+```powershell
+Remove-Item -Recurse -Force ".gsd-install-temp"
+```
+
+**Bash:**
+```bash
+rm -rf .gsd-install-temp
+```
+
+---
+
+## 5. Add to .gitignore (Optional)
+
+Check if `.gsd/STATE.md` and other session files should be gitignored:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► ADD TO .gitignore?
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Recommended .gitignore additions for session-specific files:
+
+.gsd/STATE.md
+.gsd/JOURNAL.md
+.gsd/TODO.md
+
+───────────────────────────────────────────────────────
+
+A) Yes — Add recommended entries
+B) No — Skip
+
+───────────────────────────────────────────────────────
+```
+
+---
+
+## 6. Confirm Installation
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► INSTALLED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+GSD for Antigravity has been installed.
+
+Files installed:
+• .agent/        (workflows + skills)
+• .gemini/       (Gemini integration)
+• .gsd/          (project methodology and docs)
+
+───────────────────────────────────────────────────────
+
+Next step:
+
+/new-project — Initialize your project with GSD
+
+───────────────────────────────────────────────────────
+```
+
+</process>
+
+<notes>
+- This workflow is designed to work from a clean project (no prior GSD installation)
+- It copies ALL necessary files, unlike manual installation which may miss some
+- For updates to an existing installation, use /update instead
+- The /new-project command should be run after installation to set up SPEC.md
+</notes>

package/.agent/workflows/list-phase-assumptions.md

@@ -0,0 +1,82 @@
+---
+description: List assumptions made during phase planning
+argument-hint: "<phase-number>"
+---
+
+# /list-phase-assumptions Workflow
+
+<objective>
+Surface and document assumptions made during phase planning that should be validated.
+</objective>
+
+<process>
+
+## 1. Load Phase Plans
+
+```powershell
+Get-ChildItem ".gsd/phases/{N}/*-PLAN.md"
+```
+
+---
+
+## 2. Extract Assumptions
+
+Scan plans for:
+- Technology choices without justification
+- Implied dependencies
+- Expected behaviors not verified
+- Time estimates
+- Scope boundaries
+
+---
+
+## 3. Categorize Assumptions
+
+| Category | Risk Level |
+|----------|------------|
+| Technical | API exists, library works, syntax correct |
+| Integration | Services compatible, auth works |
+| Scope | Feature boundaries, what's excluded |
+| Performance | Will handle load, fast enough |
+| Timeline | Estimates accurate |
+
+---
+
+## 4. Display Assumptions
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► PHASE {N} ASSUMPTIONS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+TECHNICAL
+🟡 {assumption 1} — Validate before execution
+🟢 {assumption 2} — Low risk
+
+INTEGRATION
+🔴 {assumption 3} — High risk, verify first
+
+SCOPE
+🟡 {assumption 4} — Confirm with user
+
+───────────────────────────────────────────────────────
+
+▶ ACTIONS
+
+• Validate high-risk assumptions before /execute
+• Add verified assumptions to RESEARCH.md
+• Flag for user review if scope-related
+
+───────────────────────────────────────────────────────
+```
+
+---
+
+## 5. Offer Validation
+
+Ask if user wants to:
+- Validate specific assumptions now
+- Add to TODO.md for later
+- Accept and proceed
+
+</process>

package/.agent/workflows/map.md

@@ -0,0 +1,394 @@
+---
+description: The Architect — Analyze codebase and update ARCHITECTURE.md and STACK.md
+---
+
+# /map Workflow
+
+<role>
+You are a GSD codebase mapper. You analyze existing codebases to understand structure, patterns, and technical debt.
+
+**Core responsibilities:**
+- Scan project structure and identify components
+- Analyze dependencies and versions
+- Map data flow and integration points
+- Identify technical debt and patterns
+- Document findings for planning context
+</role>
+
+<objective>
+Analyze the existing codebase and produce documentation that enables informed planning.
+
+This workflow should be run BEFORE `/plan` on brownfield projects to give the planner full context.
+</objective>
+
+<context>
+**No arguments required.** Operates on current project directory.
+
+**Outputs:**
+- `.gsd/ARCHITECTURE.md` — System design documentation
+- `.gsd/STACK.md` — Technology inventory
+</context>
+
+<process>
+
+## 1. Validate Project
+
+Check this is a valid project:
+
+**PowerShell:**
+```powershell
+# Look for common project indicators
+$indicators = @(
+    "package.json", "requirements.txt", "Cargo.toml", 
+    "go.mod", "pom.xml", "*.csproj", "Gemfile"
+)
+```
+
+**Bash:**
+```bash
+# Look for common project indicators
+indicators=("package.json" "requirements.txt" "Cargo.toml" 
+    "go.mod" "pom.xml" "*.csproj" "Gemfile")
+```
+
+Display banner:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► MAPPING CODEBASE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## 2. Analyze Project Structure
+
+### 2a. Directory Analysis
+
+**PowerShell:**
+```powershell
+Get-ChildItem -Recurse -Directory | 
+    Where-Object { $_.Name -notmatch "node_modules|\.git|__pycache__|dist|build" }
+```
+
+**Bash:**
+```bash
+find . -type d -not -path '*/node_modules/*' -not -path '*/.git/*' \
+    -not -path '*/__pycache__/*' -not -path '*/dist/*' -not -path '*/build/*'
+```
+
+Identify:
+- Source directories (`src/`, `lib/`, `app/`)
+- Test directories (`tests/`, `__tests__/`, `spec/`)
+- Configuration locations
+- Asset directories
+
+### 2b. Entry Points
+
+Find main files:
+**PowerShell:**
+```powershell
+# Example for Node.js
+Get-Content "package.json" | ConvertFrom-Json | Select-Object -ExpandProperty main
+```
+
+**Bash:**
+```bash
+# Example for Node.js (requires jq)
+cat package.json | jq -r '.main'
+```
+
+### 2c. Component Detection
+
+Scan for common patterns:
+- React components (`*.tsx`, `*.jsx`)
+- API routes (`routes/`, `api/`)
+- Database models (`models/`, `entities/`)
+- Services (`services/`, `lib/`)
+- Utilities (`utils/`, `helpers/`)
+
+---
+
+## 3. Analyze Dependencies
+
+### 3a. Production Dependencies
+
+**PowerShell:**
+```powershell
+# Node.js example
+Get-Content "package.json" | ConvertFrom-Json | 
+    Select-Object -ExpandProperty dependencies
+```
+
+**Bash:**
+```bash
+# Node.js example (requires jq)
+cat package.json | jq '.dependencies'
+```
+
+For each dependency, note:
+- Name and version
+- Purpose (infer from name/usage)
+- Is it actively used?
+
+### 3b. Development Dependencies
+
+Same for devDependencies, noting:
+- Build tools
+- Test frameworks
+- Linters/formatters
+
+### 3c. Outdated Packages
+
+```bash
+npm outdated
+# or
+pip list --outdated
+```
+
+---
+
+## 4. Map Data Flow
+
+### 4a. External Integrations
+
+Search for:
+**PowerShell:**
+```powershell
+# API calls
+Select-String -Path "src/**/*" -Pattern "fetch\(|axios\.|http\."
+
+# Database connections
+Select-String -Path "**/*" -Pattern "DATABASE_URL|mongodb|postgres|mysql"
+
+# Third-party services
+Select-String -Path "**/*" -Pattern "stripe|sendgrid|twilio|aws-sdk"
+```
+
+**Bash:**
+```bash
+# API calls
+grep -rE 'fetch\(|axios\.|http\.' src/
+
+# Database connections
+grep -rE 'DATABASE_URL|mongodb|postgres|mysql' .
+
+# Third-party services
+grep -rE 'stripe|sendgrid|twilio|aws-sdk' .
+```
+
+### 4b. Internal Flow
+
+Trace how data moves:
+- Entry point → Business logic → Data layer → Output
+- Identify shared state (context, stores, singletons)
+
+---
+
+## 5. Identify Technical Debt
+
+### 5a. Code Smells
+
+Search for indicators:
+**PowerShell:**
+```powershell
+# TODOs and FIXMEs
+Select-String -Path "src/**/*" -Pattern "TODO|FIXME|HACK|XXX"
+
+# Deprecated markers
+Select-String -Path "**/*" -Pattern "@deprecated|DEPRECATED"
+```
+
+**Bash:**
+```bash
+# TODOs and FIXMEs
+grep -rE 'TODO|FIXME|HACK|XXX' src/
+
+# Deprecated markers
+grep -rE '@deprecated|DEPRECATED' .
+```
+
+### 5b. Pattern Inconsistencies
+
+Note where patterns differ:
+- Naming conventions
+- File organization
+- Error handling approaches
+
+### 5c. Missing Elements
+
+Identify gaps:
+- No tests for critical paths
+- Missing error boundaries
+- No input validation
+- No logging/monitoring
+
+---
+
+## 6. Write ARCHITECTURE.md
+
+```markdown
+# Architecture
+
+> Auto-generated by /map on {date}
+
+## Overview
+
+{High-level description of what this system does}
+
+```
+┌─────────────────────────────────────────┐
+│              [Entry Point]              │
+├─────────────────────────────────────────┤
+│         [Business Logic Layer]          │
+├─────────────────────────────────────────┤
+│            [Data Layer]                 │
+└─────────────────────────────────────────┘
+```
+
+## Components
+
+### {Component 1}
+- **Purpose:** {what it does}
+- **Location:** `{path}`
+- **Dependencies:** {what it imports}
+
+### {Component 2}
+...
+
+## Data Flow
+
+1. {Step 1}
+2. {Step 2}
+3. {Step 3}
+
+## Integration Points
+
+| Service | Type | Purpose |
+|---------|------|---------|
+| {name} | API | {purpose} |
+
+## Technical Debt
+
+- [ ] {Debt item 1}
+- [ ] {Debt item 2}
+
+## Conventions
+
+**Naming:** {patterns observed}
+**Structure:** {organization patterns}
+**Testing:** {test patterns}
+```
+
+---
+
+## 7. Write STACK.md
+
+```markdown
+# Technology Stack
+
+> Auto-generated by /map on {date}
+
+## Runtime
+
+| Technology | Version | Purpose |
+|------------|---------|---------|
+| {runtime} | {version} | Core runtime |
+
+## Dependencies
+
+### Production
+| Package | Version | Purpose |
+|---------|---------|---------|
+| {pkg} | {ver} | {purpose} |
+
+### Development
+| Package | Version | Purpose |
+|---------|---------|---------|
+| {pkg} | {ver} | {purpose} |
+
+## Infrastructure
+
+| Service | Provider | Purpose |
+|---------|----------|---------|
+| {service} | {provider} | {purpose} |
+
+## Configuration
+
+| Variable | Purpose | Location |
+|----------|---------|----------|
+| {var} | {purpose} | {file} |
+
+## Outdated Packages
+
+| Package | Current | Latest | Risk |
+|---------|---------|--------|------|
+| {pkg} | {cur} | {new} | {risk} |
+```
+
+---
+
+## 8. Update State
+
+Update `.gsd/STATE.md`:
+```markdown
+## Last Session Summary
+Codebase mapping complete.
+- {N} components identified
+- {M} dependencies analyzed
+- {K} technical debt items found
+```
+
+---
+
+## 9. Commit Documentation
+
+```bash
+git add .gsd/ARCHITECTURE.md .gsd/STACK.md .gsd/STATE.md
+git commit -m "docs: map existing codebase"
+```
+
+---
+
+## 10. Offer Next Steps
+
+</process>
+
+<offer_next>
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► CODEBASE MAPPED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Components: {N}
+Dependencies: {M} production, {K} dev
+Technical debt: {J} items
+
+───────────────────────────────────────────────────────
+
+▶ Next Up
+
+/plan — create execution plans with full context
+
+Files updated:
+• .gsd/ARCHITECTURE.md
+• .gsd/STACK.md
+
+───────────────────────────────────────────────────────
+```
+
+</offer_next>
+
+<related>
+## Related
+
+### Workflows
+| Command | Relationship |
+|---------|--------------|
+| `/plan` | Use ARCHITECTURE.md from /map for planning context |
+
+### Skills
+| Skill | Purpose |
+|-------|---------|
+| `codebase-mapper` | Detailed mapping methodology |
+</related>