Commit Graph

67 Commits

Author SHA1 Message Date
Lex Christopherson
90f1f66d85 docs: use static Discord badge to avoid widget dependency
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-09 10:15:26 -06:00
Lex Christopherson
d80e4ef75f docs: add X, Dexscreener badges and fix Discord member count
- Add X (Twitter) badge linking to @gsd_foundation
- Add $GSD token badge linking to Dexscreener
- Fix Discord badge to show live member count (server ID 1463221958777901349)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-09 09:39:50 -06:00
Lex Christopherson
19568d6e68 docs: use @latest in primary install commands
Prevents npx cache from serving stale versions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-08 10:45:15 -06:00
Lex Christopherson
cbb4aa105e docs: add --auto flag to new-project command table 2026-02-08 10:07:07 -06:00
Lex Christopherson
f53011c9e2 fix(#429): prevent API keys from being committed via map-codebase
Defense-in-depth approach:

Layer 1 - Prevention:
- Add <forbidden_files> section to gsd-codebase-mapper agent
- Explicitly prohibit reading .env, credentials, keys, secrets
- Agent can note file existence but never quote contents

Layer 2 - Detection:
- Add scan_for_secrets step before commit in map-codebase workflow
- Regex patterns catch: sk-*, ghp_*, AKIA*, xox*-*, JWTs, private keys
- Halts with alert if secrets detected, requires user confirmation

Layer 3 - Documentation:
- Add Security section to README
- Document Claude Code deny rules for sensitive files
- Recommend defense-in-depth approach

Closes #429

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-05 13:13:22 -06:00
Colin
8d2651d128 fix: remove broken gsd-gemini link (404)
The uberfuzzy/gsd-gemini repository no longer exists. Removed the dead
link while preserving attribution to the original contributor.

Fixes #346
2026-02-01 11:28:15 -05:00
Lex Christopherson
f3db981fa7 docs: update changelog and README for v1.11.0 2026-01-31 15:27:42 -06:00
Lex Christopherson
d58f2b5462 docs: update README and changelog for v1.9.14
- Add Gemini CLI to supported runtimes
- Update install examples with --gemini and --all flags
- Note native Gemini/OpenCode support in Community Ports section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 13:30:53 -06:00
Lex Christopherson
7ebde26d8e docs: remove whats-new references, update stays
/gsd:update now covers changelog viewing with cancel option.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-23 17:26:49 -06:00
TÂCHES
4c0cd9d1e0 Update README.md 2026-01-23 17:09:28 -06:00
Lex Christopherson
2f225d7b08 docs: reorder badges - stars before license
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-23 02:11:12 -06:00
Lex Christopherson
7a7ada6222 docs: use static Discord badge
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-23 02:10:38 -06:00
Lex Christopherson
73aad664ca docs: add Discord badge to README
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-23 02:06:43 -06:00
Lex Christopherson
3a43501832 docs: add join-discord to README command table 2026-01-23 01:42:46 -06:00
Lex Christopherson
12e6acbf53 feat(installer): add --uninstall flag to remove GSD files
Adds -u/--uninstall option that cleanly removes all GSD-installed files:
- commands/gsd/ directory (Claude Code) or gsd-*.md files (OpenCode)
- get-shit-done/ directory
- gsd-*.md agent files
- GSD hooks (gsd-statusline.js, gsd-check-update.js/sh)
- GSD entries from settings.json (statusline, hooks)
- GSD permissions from opencode.json (OpenCode only)

Usage: npx get-shit-done-cc --claude --global --uninstall

Closes #236

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-22 20:37:35 -06:00
Lex Christopherson
820f1086ce feat(installer): add interactive runtime selection prompt
Users can now choose to install for Claude Code, OpenCode, or both
when running the installer interactively. New CLI flags:
- --claude: Install for Claude Code only
- --opencode: Install for OpenCode only
- --both: Install for both runtimes

The installer prompts for runtime first, then location. Backward
compatible - existing --global and --local flags still work.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-22 12:53:46 -06:00
Lex Christopherson
7e9b8decf1 docs: add community ports section to README
Link to gsd-opencode and gsd-gemini community adaptations.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-22 11:24:51 -06:00
Lex Christopherson
d1fda80c7f revert: remove codebase intelligence system
Rolled back the intel system due to overengineering concerns:
- 1200+ line hook with SQLite graph database
- 21MB sql.js dependency
- Entity generation spawning additional Claude calls
- Complex system with unclear value

Removed:
- /gsd:analyze-codebase command
- /gsd:query-intel command
- gsd-intel-index.js, gsd-intel-session.js, gsd-intel-prune.js hooks
- gsd-entity-generator, gsd-indexer agents
- entity.md template
- sql.js dependency

Preserved:
- Model profiles feature
- Statusline hook
- All other v1.9.x improvements

-3,065 lines removed

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 10:28:53 -06:00
Lex Christopherson
9a3a394f79 docs: update changelog and documentation for v1.9.0 2026-01-20 11:53:21 -06:00
Lex Christopherson
4218f8666a feat(profiles): add model profiles for GSD agents
Adds switchable model profiles (quality/balanced/budget) to control
which Claude model each agent uses, balancing quality vs token spend.

New files:
- get-shit-done/references/model-profiles.md - profile lookup table
- commands/gsd/set-profile.md - runtime profile switching

Updated orchestrators to resolve model before spawning agents:
- new-project, new-milestone (7 calls each)
- plan-phase (4 calls)
- execute-phase (3 calls)
- audit-milestone, debug, research-phase, quick (1-2 calls each)
- workflows: execute-phase, execute-plan, verify-work, map-codebase

Profile stored in .planning/config.json as model_profile.
Default: "balanced" (Opus for planning, Sonnet for execution).

Closes #160

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 01:29:04 -06:00
Lex Christopherson
9c239e4b15 docs(03-03): add codebase intelligence section to README
- Add Codebase Intelligence section explaining automatic learning
- Document convention detection and context injection
- Add /gsd:analyze-codebase to Brownfield commands table
- List intel files and their purposes

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 00:10:42 -06:00
Lex Christopherson
2dc7d47d10 docs(02-01): add Quick Mode section to README.md
- Add Quick Mode section in How It Works after Repeat section
- Add /gsd:quick entry to Utilities command table
- Document usage examples and output files
2026-01-19 15:59:29 -06:00
Lex Christopherson
bc047f46ee docs: restructure README with improved workflow clarity
- Rewrite "How It Works" with 6 clear steps: init → discuss → plan → execute → verify → complete
- Emphasize discuss-phase as where users shape implementation (feeds research + planning)
- Emphasize verify-work as where users confirm features actually work (auto-diagnoses failures)
- Add brownfield callout at top of How It Works instead of separate section
- Move discuss-phase, verify-work, new-milestone into Core Workflow commands
- Replace "Subagent Execution" with "Multi-Agent Orchestration" explaining thin orchestrator pattern
- Highlight 30-40% context usage even after thousands of lines of code
2026-01-17 01:10:41 -06:00
Lex Christopherson
c54071ccb8 refactor: unify milestone flow, remove deprecated commands
Consolidate /gsd:new-milestone to mirror /gsd:new-project:
- questioning → research (optional) → requirements → roadmap

BREAKING CHANGES:
- Remove /gsd:discuss-milestone (consolidated into new-milestone)
- Remove /gsd:create-roadmap (integrated into project/milestone flows)
- Remove /gsd:define-requirements (integrated into project/milestone flows)
- Remove /gsd:research-project (integrated into project/milestone flows)

Deleted files:
- commands/gsd/{discuss-milestone,create-roadmap,define-requirements,research-project}.md
- get-shit-done/workflows/{discuss-milestone,create-roadmap,define-requirements}.md
- get-shit-done/templates/milestone-context.md

Updated references in:
- progress.md, complete-milestone.md, help.md
- complete-milestone workflow, continuation-format.md
- questioning.md, requirements.md template, SUMMARY.md template
- gsd-project-researcher.md, gsd-roadmapper.md
- README.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 00:28:41 -06:00
Lex Christopherson
c8034418dd docs(readme): add optional discuss-phase before plan-phase
Clarifies that users can run /gsd:discuss-phase first to specify
UI/UX/behavior decisions before planning. Creates CONTEXT.md that
guides the planner. Optional if defaults are acceptable.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 12:41:04 -06:00
Lex Christopherson
ccd49d88b2 docs(readme): simplify workflow to new-project → plan → execute loop
- Collapse 5-step flow into 4 clear phases
- Show /gsd:new-project as single ~10min initialization flow
- Document research → plan → verify loop in plan-phase
- Document parallel waves + verification in execute-phase
- Remove deprecated commands: execute-plan, research-project,
  define-requirements, create-roadmap, research-phase,
  list-phase-assumptions
- Reorganize commands table with Core Workflow at top
- Simplify brownfield section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 12:22:18 -06:00
Lex Christopherson
2869fee206 refactor(verify-work): consolidate plan-fix into plan-phase --gaps
Unify gap handling - whether discovered by code verification or user
testing, gaps feed into the same plan-phase --gaps workflow.

Changes:
- Delete commands/gsd/plan-fix.md (redundant)
- Update verify-work to route to plan-phase --gaps
- Update progress Route E to detect UAT gaps
- Change UAT.md "Issues" section to "Gaps" with YAML format
- Extend plan-phase --gaps to read from both VERIFICATION.md and UAT.md
- Update diagnose-issues to output gaps in YAML format
- Update all references (debug, templates, workflows)

One path: gap discovered → diagnosed → plan-phase --gaps → fixed

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 15:40:18 -06:00
Lex Christopherson
c74f4a05e8 docs: clarify research-project optional, define-requirements required
- Split into separate steps: 1, 1.5 (optional), 2, 3, 4, 5
- Research is recommended for quality, skip only for speed
- Define-requirements is required before create-roadmap

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 02:37:02 -06:00
Lex Christopherson
f03947a3f4 docs: document research-project and define-requirements flow
- Add research & scope step to "How It Works" (optional but recommended)
- Update brownfield section with full optional flow
- Add research-project and define-requirements to commands
- Add research/ and REQUIREMENTS.md to context engineering table
- Split commands into 7 grouped tables for easier scanning

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 02:29:15 -06:00
Lex Christopherson
bd4bd9db53 refactor: remove dead code, improve execute-phase UX, fix requirements flow
- Remove phantom status.md command (background agent model abandoned)
- Remove agent-history.md template (unused)
- Remove _archive/ directory
- Add narration to execute-phase (describe what's being built before/after waves)
- Update new-project to offer define-requirements as fast path
- Make define-requirements work without research (gather through questioning)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 01:04:41 -06:00
Lex Christopherson
1f24f7e689 docs: add staying updated section to help and README
Promote /gsd:whats-new and update command visibility.
GSD evolves fast — users should check periodically.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 00:23:29 -06:00
Lex Christopherson
62f12794dd chore: remove dead ISSUES.md system
Remove the global ISSUES.md deferred enhancement tracking system.

- Delete /gsd:consider-issues command (never used)
- Delete issues.md template (never instantiated)
- Remove Rule 5 from deviation rules (never triggered)
- Remove all ISSUES.md, ISS-XXX, and "deferred issues" references
- Update STATE.md to track pending todos instead

The ISSUES.md system was designed to capture non-critical enhancements
during plan execution via "Rule 5", but it never fired in practice
across 100+ projects. The system added ~350 lines of dead code.

The /gsd:add-todo and /gsd:check-todos system serves the same purpose
and is actually used.

Note: UAT *-ISSUES.md files (per-plan, created by /gsd:verify-work)
are unaffected - those are a separate, active system.

Closes #56

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 12:33:18 -06:00
Lex Christopherson
4d04c91929 docs: add context rot explanation to README header
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-13 17:57:58 -06:00
Lex Christopherson
cd1bede183 docs: fix brownfield flow, remove deprecated resume-task
- Fix brownfield example to use execute-phase instead of execute-plan
- Remove /gsd:resume-task command (relies on broken Task resume)
- Checkpoint continuation now uses fresh agents, not resume

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 17:49:13 -06:00
Lex Christopherson
7c10bdc76f docs: recommend execute-phase as primary execution command
execute-phase with parallel agents is the recommended path.
execute-plan is for single-plan or interactive checkpoint handling.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 17:46:55 -06:00
Lex Christopherson
f0b4c7d853 feat: add /gsd:debug for systematic debugging with persistent state
- Creates .planning/debug/[slug].md immediately on command
- Continuous updates: file IS the debugging brain
- Clear section rules: OVERWRITE (Current Focus, Resolution) vs APPEND (Evidence, Eliminated)
- Survives /clear perfectly - resume from any interruption point
- Scientific method: evidence → hypothesis → test → eliminate or confirm
- Includes debugging reference files (mindset, hypothesis testing, investigation techniques)

Closes #53, closes #44

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 11:48:14 -06:00
anirudhpv
341bf3e4ee Update README with verification details (#55)
Clarified verification instructions for usage. 

I was initially trying to get this to work in my PowerShell terminal, but later realized that the /gsd:help command became available inside Claude Code.
2026-01-13 09:45:31 -06:00
Lex Christopherson
f53471e608 docs: add /gsd:status to README and help
New command for monitoring background agents from parallel execution.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-12 14:59:36 -06:00
Lex Christopherson
b372905544 docs(10-03): add execute-phase command documentation
- README.md: Add execute-phase to command table and explain when to use each
- help.md: Add full usage entry with config options
2026-01-12 13:16:06 -06:00
Lex Christopherson
3787f50ea6 feat: add todo capture system for mid-session ideas
Adds /gsd:add-todo and /gsd:check-todos commands for capturing
ideas during work sessions without losing context.

Features:
- Capture todos from conversation context or explicit description
- Structured frontmatter (created, title, area, files)
- Area inference from file paths for grouping
- Duplicate detection before creating
- Filter todos by area
- Route to appropriate action (work now, add to phase, brainstorm)
- Git commits on capture and when starting work

Closes #48

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 11:46:01 -06:00
Lex Christopherson
d2904dfede docs: add Docker troubleshooting for tilde path expansion
Closes #25

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 10:56:21 -06:00
Lex Christopherson
94b01b97ab docs: add /gsd:resume-task to commands table
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 14:20:47 -06:00
TÂCHES
992d034df2 Update README.md 2026-01-08 16:06:13 -06:00
TÂCHES
141828b962 Update README.md 2026-01-08 16:05:33 -06:00
Lex Christopherson
5457bdfffb docs: fix development installation instructions
Use actual install.js workflow instead of --plugin-dir flag

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:47:42 -06:00
Lex Christopherson
58c2e86e4d docs: redesign README with pro patterns
- Add shields.io badges (npm version, downloads, license, stars)
- Move "Why I Built This" section higher for immediate context
- Add dark/light mode aware star history chart
- Use GitHub alerts for callouts
- Collapse secondary install options into details blocks
- Remove incorrect marketplace installation option
- Improve visual hierarchy and spacing

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:45:44 -06:00
Lex Christopherson
254f5143c7 docs: fix troubleshooting section for slash commands, add update instructions
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 10:44:19 -06:00
Lex Christopherson
7faf33d267 docs: add star history chart to README
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 10:41:07 -06:00
Lex Christopherson
d72bd7437e feat(09-02): add plan-fix command and progress routing for UAT issues
- Create plan-fix command to generate FIX.md from ISSUES.md
- Add Route E to progress.md for detecting unaddressed UAT issues
- Add verify-work and plan-fix to README commands table
- Credit OracleGreyBeard for verify-work contribution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 09:17:31 -06:00
Lex Christopherson
c096ead2f4 feat: add /gsd:remove-phase command
Remove future phases from roadmap and renumber subsequent phases.
- Validates phase is unstarted (no SUMMARY.md files)
- Deletes phase directory
- Renumbers all subsequent phases (integers and decimals)
- Updates ROADMAP.md and STATE.md
- Git commit preserves historical record

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 08:17:45 -06:00