@tekyzinc/gsd-t 2.0.0 → 2.0.2

package/README.md

@@ -17,7 +17,7 @@ A methodology for reliable, parallelizable development using Claude Code with op
 npx @tekyzinc/gsd-t install
 ```
 
-This installs 22 GSD-T commands + 3 utility commands to `~/.claude/commands/` and the global CLAUDE.md to `~/.claude/CLAUDE.md`. Works on Windows, Mac, and Linux.
+This installs 23 GSD-T commands + 3 utility commands to `~/.claude/commands/` and the global CLAUDE.md to `~/.claude/CLAUDE.md`. Works on Windows, Mac, and Linux.
 
 ### Start Using It
 
@@ -92,6 +92,7 @@ This will replace changed command files, back up your CLAUDE.md if customized, a
 | `/user:gsd-t-help` | List all commands with descriptions |
 | `/user:gsd-t-help {cmd}` | Detailed help for specific command |
 | `/user:gsd-t-prompt` | Help formulate your idea before committing |
+| `/user:gsd-t-brainstorm` | Creative exploration and idea generation |
 
 ### Project Initialization
 

package/commands/gsd-t-help.md

@@ -14,6 +14,7 @@ Display the full command reference:
 GETTING STARTED
 ───────────────────────────────────────────────────────────────────────────────
   prompt              Help formulate your idea before committing to a command
+  brainstorm          Creative exploration, rethinking, and idea generation
   init                Initialize GSD-T structure in current project
   project             New project → requirements → milestone roadmap
   feature             Major feature → impact analysis → milestones
@@ -112,6 +113,13 @@ Use these when user asks for help on a specific command:
 - **Files**: None (conversational only)
 - **Use when**: You have a vague idea and need help articulating it
 
+### brainstorm
+- **Summary**: Creative exploration, rethinking, and idea generation
+- **Auto-invoked**: No
+- **Files**: Optional save to `.gsd-t/brainstorm-{date}.md`
+- **Use when**: You want to explore ideas, challenge assumptions, or break out of tunnel vision
+- **Modes**: Ideation, Enhancement, Rethink, Unstuck, Blue Sky
+
 ### init
 - **Summary**: Initialize GSD-T directory structure in current project
 - **Auto-invoked**: No

package/commands/gsd-t-init.md

@@ -73,9 +73,10 @@ Create a starter template:
 {Languages, frameworks, services — fill this in}
 
 ## Documentation
-- Requirements: docs/requirements.md (if exists)
-- Architecture: docs/architecture.md (if exists)
-- Schema: docs/schema.md (if exists)
+- Requirements: docs/requirements.md
+- Architecture: docs/architecture.md
+- Workflows: docs/workflows.md
+- Infrastructure: docs/infrastructure.md
 
 ## Conventions
 - {Coding style, naming patterns — fill this in}
@@ -91,13 +92,19 @@ If `CLAUDE.md` exists but doesn't reference GSD-T, append the GSD-T section.
 
 ## Step 5: Create docs/ if Needed
 
-If no `docs/` directory:
+If no `docs/` directory, create it with all 4 living document templates.
+For each file, skip if it already exists:
+
 ```
 docs/
-├── requirements.md    — (create placeholder)
-└── architecture.md    — (create placeholder)
+├── requirements.md    — Functional, technical, and non-functional requirements
+├── architecture.md    — System design, components, data flow, design decisions
+├── workflows.md       — User journeys, technical processes, API flows
+└── infrastructure.md  — Dev setup, DB commands, cloud provisioning, deployment, credentials
 ```
 
+These are the living documents that persist across milestones and keep institutional knowledge alive. The `infrastructure.md` is especially important — it captures the exact commands for provisioning cloud resources, setting up databases, managing secrets, and deploying, so this knowledge doesn't get lost between sessions.
+
 ## Step 6: Map Existing Codebase (if code exists)
 
 If there's existing source code:

package/commands/gsd-t-scan.md

@@ -310,7 +310,55 @@ Estimated effort: {assessment}
 Can be scheduled: During next maintenance window
 ```
 
-## Step 5: Update Project State
+## Step 5: Update Living Documents
+
+The scan produces deep analysis in `.gsd-t/scan/`. Now cross-populate findings into the living docs so knowledge persists across milestones.
+
+### docs/architecture.md
+Using findings from `.gsd-t/scan/architecture.md`, update or create `docs/architecture.md`:
+- System overview (stack, structure, patterns)
+- Component descriptions with locations and dependencies
+- Data flow (request → handler → service → data layer → response)
+- Data models from schema files or ORM definitions
+- API structure from route definitions
+- External integrations
+- Design decisions found in code comments or configs
+
+If the file exists, merge new findings — don't overwrite existing content.
+
+### docs/workflows.md
+Using findings from `.gsd-t/scan/business-rules.md`, update or create `docs/workflows.md`:
+- User workflows traced from routes/handlers (registration, login, core features)
+- Technical workflows from cron jobs, queue workers, scheduled tasks
+- API workflows for multi-step operations
+- Integration workflows for external system syncing
+- State machines and approval flows discovered in code
+
+### docs/infrastructure.md
+Scan the codebase for operational knowledge and update or create `docs/infrastructure.md`:
+- **Quick Reference commands** from package.json scripts, Makefile, README, CI/CD configs
+- **Local development setup** from README, docker-compose, .env.example
+- **Database commands** from migrations, seeds, ORM config, backup scripts
+- **Cloud provisioning** from Terraform, CloudFormation, Pulumi, or deployment scripts
+- **Credentials and secrets** from .env.example (names only, not values) and secret manager configs
+- **Deployment** from CI/CD configs, Dockerfiles, cloud platform configs
+- **Logging and monitoring** from any logging setup or dashboard configs
+
+This is critical — infrastructure knowledge is the most commonly lost between sessions.
+
+### docs/requirements.md
+Using all scan findings, update or create `docs/requirements.md`:
+- Functional requirements discovered from routes, handlers, UI components
+- Technical requirements from configs, package.json, runtime settings
+- Non-functional requirements from performance configs, rate limits, caching
+
+### For all docs:
+- If the file exists and has real content, **merge** — don't overwrite
+- If the file exists with only placeholder text, **replace** with real findings
+- If the file doesn't exist, **create** it
+- Replace `{Project Name}` and `{Date}` tokens with actual values
+
+## Step 6: Update Project State
 
 If `.gsd-t/progress.md` exists:
 - Log scan in Decision Log
@@ -323,7 +371,7 @@ If `.gsd-t/roadmap.md` exists:
 If `CLAUDE.md` exists:
 - Suggest updates for any patterns or conventions discovered during scan
 
-## Step 6: Report to User
+## Step 7: Report to User
 
 Present a summary:
 1. Architecture overview (brief)

package/docs/GSD-T-README.md

@@ -65,6 +65,7 @@ GSD-T reads all state files and tells you exactly where you left off.
 | `/user:gsd-t-help` | List all commands with descriptions |
 | `/user:gsd-t-help {cmd}` | Detailed help for specific command |
 | `/user:gsd-t-prompt` | Help formulate your idea before committing |
+| `/user:gsd-t-brainstorm` | Creative exploration and idea generation |
 
 ### Project Initialization
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.0.0",
-  "description": "GSD-T: Contract-Driven Development for Claude Code — 26 slash commands with impact analysis, test sync, and milestone archival",
+  "version": "2.0.2",
+  "description": "GSD-T: Contract-Driven Development for Claude Code — 27 slash commands with impact analysis, test sync, and milestone archival",
   "author": "Tekyz, Inc.",
   "license": "MIT",
   "repository": {

package/templates/CLAUDE-global.md

@@ -13,7 +13,7 @@
 ```
 PROJECT or FEATURE or SCAN
   └── MILESTONE (major deliverable)
-      └── PARTITION → DISCUSS → PLAN → EXECUTE → INTEGRATE → VERIFY
+      └── PARTITION → DISCUSS → PLAN → IMPACT → EXECUTE → TEST-SYNC → INTEGRATE → VERIFY → COMPLETE
 ```
 
 - **Project**: Full greenfield project → decomposed into milestones
@@ -29,6 +29,7 @@ PROJECT or FEATURE or SCAN
 |---------|---------|
 | `/user:gsd-t-help` | List all commands or get detailed help |
 | `/user:gsd-t-prompt` | Help formulate your idea before committing |
+| `/user:gsd-t-brainstorm` | Creative exploration and idea generation |
 | `/user:gsd-t-project` | Full project → milestone roadmap |
 | `/user:gsd-t-feature` | Major feature → impact analysis + milestones |
 | `/user:gsd-t-scan` | Deep codebase analysis → techdebt.md |