Commit Graph

96 Commits

Author SHA1 Message Date
Tom Boucher
d5f2a7ea19 docs: update README and docs/ for v1.27 release
Add documentation for all new v1.27 features:
- 7 new commands (/gsd:fast, /gsd:review, /gsd:plant-seed, /gsd:thread,
  /gsd:add-backlog, /gsd:review-backlog, /gsd:pr-branch)
- Security hardening (security.cjs, prompt guard hook, workflow guard hook)
- Multi-repo workspace support, discussion audit trail, advisor mode
- New config options (research_before_questions, hooks.workflow_guard)
- Updated component counts in ARCHITECTURE.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 12:21:53 -04:00
Lex Christopherson
fb5c190075 docs: update README for v1.27.0
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 10:06:03 -06:00
Tom Boucher
1427aab41b Merge pull request #1070 from MenglongFan/docs/zh-cn-translation
docs: add Chinese (zh-CN) documentation
2026-03-18 23:58:15 -04:00
Tom Boucher
a9be67f504 docs: comprehensive v1.26 release documentation update (#1187)
Updates all docs to reflect v1.26.0 features and changes:

README.md:
- Add /gsd:ship and /gsd:next to command tables
- Add /gsd:session-report to Session section
- Update workflow to show ship step and auto-advance
- Update inherit profile description for non-Anthropic providers

docs/COMMANDS.md:
- Add /gsd:next command reference with full state detection logic
- Add /gsd:session-report command reference with report contents

docs/FEATURES.md:
- Add Auto-Advance (Next) feature (#14)
- Add Cross-Phase Regression Gate feature (#20)
- Add Requirements Coverage Gate feature (#21)
- Add Session Reporting feature (#24)
- Fix all section numbering (was broken with duplicates)
- Update inherit profile to mention non-Anthropic providers
- Renumber all 39 features consistently

docs/USER-GUIDE.md:
- Add /gsd:ship to workflow diagram
- Add /gsd:next and /gsd:session-report to command tables
- Add HANDOFF.json and reports/ to file structure
- Add troubleshooting for non-Anthropic model providers
- Add recovery entries for session-report and next
- Update example workflow to include ship and session-report

docs/CONFIGURATION.md:
- Update inherit profile to mention non-Anthropic providers
2026-03-18 14:54:02 -04:00
Tom Boucher
80605d2051 docs: add developer profiling, execution hardening, and idempotent mark-complete to docs (#1108)
Update documentation for features added since v1.25.1:

- CHANGELOG.md: Add [Unreleased] entries for developer profiling pipeline,
  execution hardening (pre-wave check, cross-plan contracts, export
  spot-check), and idempotent requirements mark-complete

- README.md: Add /gsd:profile-user command to utilities table

- docs/COMMANDS.md: Add full /gsd:profile-user command documentation
  with flags, generated artifacts, and usage examples

- docs/FEATURES.md: Add Feature 33 (Developer Profiling) with 8
  behavioral dimensions, pipeline modules, and requirements; add
  Feature 34 (Execution Hardening) with 3 quality components

- docs/AGENTS.md: Add gsd-user-profiler agent documentation and
  tool permissions entry
2026-03-16 13:39:52 -06:00
Tom Boucher
a2f359e94b docs: update README and documentation for v1.25 release (#1090)
- Add Antigravity to verify instructions and uninstall commands
- Add Gemini to uninstall commands (was missing)
- Add hooks.context_warnings config to README and CONFIGURATION.md
- Add /gsd:note command documentation to COMMANDS.md
- Add Note Capture feature (section 13) to FEATURES.md
- Renumber subsequent feature sections (14-33)
2026-03-16 09:44:48 -06:00
Lex Christopherson
8d6457733e docs: add /gsd:do and /gsd:note to README commands table 2026-03-16 08:59:01 -06:00
lone
1155c7564e docs: add Chinese (zh-CN) documentation
- Add language switch link to root README
- Translate README.md to docs/zh-CN/README.md
- Translate USER-GUIDE.md to docs/zh-CN/USER-GUIDE.md
- Translate all 13 reference documents to docs/zh-CN/references/

Key terminology mappings:
- context engineering → 上下文工程
- spec-driven development → 规格驱动开发
- context rot → 上下文衰减
- phase → 阶段
- milestone → 里程碑
- roadmap → 路线图

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-16 10:13:55 +08:00
Berkay Karaman
a5f5d50f14 feat: add Antigravity runtime support (#1058)
* feat: add Antigravity runtime support

Add full installation support for the Antigravity AI agent, bringing
get-shit-done capabilities to the new runtime alongside Claude Code,
OpenCode, Gemini, Codex, and Copilot.

- New runtime installation capability in bin/install.js
- Commands natively copied to the unified skills directory
- New test integration suite: tests/antigravity-install.test.cjs
- Refactored copy utility to accommodate Antigravity syntax
- Documentation added into README.md

Co-authored-by: Antigravity <noreply@google.com>

* fix: add missing processAttribution call in copyCommandsAsAntigravitySkills

Antigravity SKILL.md files were written without commit attribution metadata,
inconsistent with the Copilot equivalent (copyCommandsAsCopilotSkills) which
calls processAttribution on each skill's content before writing it.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: update Copilot install test assertions for 3 new UI agents

* docs: update CHANGELOG for Antigravity runtime support

---------

Co-authored-by: Antigravity <noreply@google.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-15 19:31:01 -06:00
TÂCHES
ddb9923df2 feat(quick): add --research flag for focused pre-planning research (#317) (#1063)
Add composable --research flag to /gsd:quick that spawns a focused
gsd-phase-researcher before planning. Investigates implementation
approaches, library options, and pitfalls for the task.

Addresses the middle-ground gap between quick (no quality agents) and
full milestone workflows. All three flags are composable:
--discuss --research --full gives the complete quality pipeline.

Made-with: Cursor

Co-authored-by: ralberts3 <ralberts3@gatech.edu>
2026-03-15 11:45:25 -06:00
jorge g
698985feb1 feat: add inherit model profile for OpenCode /model (#951) 2026-03-15 11:40:08 -06:00
Lex Christopherson
5971f69309 docs: update README for v1.23.0
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 11:22:04 -06:00
sp.wack
7b5b7322b8 docs: show optional [area] arg for /gsd:map-codebase in README 2026-03-14 21:58:06 -06:00
ziyu he
625adb8252 docs(readme): add Simplified Chinese version
Co-authored-by: jouissance-test <207695261+jouissance-test@users.noreply.github.com>
2026-03-14 21:58:02 -06:00
lloydchang
ae787d1be2 docs(README.md): fix broken lines
fix misaligned line-drawing characters that drew broken lines
2026-03-14 21:57:50 -06:00
Frank
dffbdaf65e docs(discuss-phase): add explicit --batch mode (#982) 2026-03-12 11:36:30 -06:00
Lex Christopherson
8603b63089 docs: update README quick command flags for v1.22.4 2026-03-03 12:33:25 -06:00
Lex Christopherson
c298a1a4dc refactor: rename depth setting to granularity (closes #879)
The "depth" setting with values quick/standard/comprehensive implied
investigation thoroughness, but it only controls phase count. Renamed to
"granularity" with values coarse/standard/fine to accurately reflect what
it controls: how finely scope is sliced into phases.

Includes backward-compatible migration in loadConfig and config-ensure
that auto-renames depth→granularity with value mapping in both
.planning/config.json and ~/.gsd/defaults.json.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 10:53:34 -06:00
Ethan Hurst
ad7c79aa6f feat(06-01): add CI status badge to README
- Badge shows workflow status for main branch
- Links to test.yml workflow in GitHub Actions
- Uses for-the-badge style matching existing badges
- Placed after npm downloads badge, before Discord badge
2026-02-26 05:47:33 +10:00
Lex Christopherson
334c61f9a4 chore: update Discord invite to vanity URL 2026-02-25 07:20:14 -06:00
Paarth Tandon
12692ee7a1 docs: add codex usage guidance and update notebook 2026-02-18 13:30:27 -08:00
Lex Christopherson
1104fc9bf6 docs: update README for v1.20.0
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 17:13:45 -06:00
Lex Christopherson
04380c8314 docs: add wave execution diagram to clarify parallelization
Adds ASCII diagram showing how plans are grouped into waves based on
dependencies. Independent plans run in parallel within a wave; waves
run sequentially when dependencies exist.

Addresses user confusion in #486 about why phases may not parallelize
(dependencies prevent parallel execution by design).
2026-02-15 14:33:50 -06:00
TÂCHES
bc13b4919f Merge pull request #505 from pablo-alonso-arista/docs/user-guide
docs: add User Guide (workflow diagrams, troubleshooting, config reference)
2026-02-15 13:18:48 -06:00
Lex Christopherson
d8f3bac692 docs: update README for v1.19.1 — auto-advance flag and config 2026-02-15 10:04:44 -06:00
Lex Christopherson
d86385887a fix(docs): use {phase_num} instead of ambiguous {phase} for filenames (#601)
The verifier agent interpreted {phase} as the full directory slug
(e.g., 01-foundation-target-system) instead of just the padded phase
number (01), producing wrong filenames like
01-foundation-target-system-VERIFICATION.md.

Changed all {phase}-*.md references to {phase_num}-*.md to match the
convention used in gsd-tools.js (${padded}-VERIFICATION.md).

Files: VERIFICATION.md, RESEARCH.md, CONTEXT.md, UAT.md patterns.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-15 07:45:33 -06:00
Lex Christopherson
9d815d31db Revert 12 PRs merged without authorization
Reverts:
- #413 fix(install): build hooks/dist on the fly for dev installs
- #396 refactor(statusline): display git branch in status line
- #543 Add in-progress state for todos
- #532 feat: add git_tag config option
- #171 Add OpenCode installer package
- #519 feat: Add Mistral Vibe CLI Support
- #389 docs: use @latest for uninstall commands
- #288 fix(install): auto-migrate renamed statusline.js reference
- #502 fix(#501): verify-work defers diagnosis/planning
- #497 fix: move resolved debug sessions to resolved/ folder
- #512 fix: create feature branch before first commit
- #545 fix: add Write tool to gsd-verifier

These were merged without owner approval.
2026-02-14 14:25:26 -06:00
Tomer Ariel
9d3d9d88c9 docs: use @latest for uninstall commands to prevent npx cache issues (#389)
Docs: Use @latest for uninstall commands
2026-02-14 14:17:18 -06:00
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
Pablo Alonso
7de17fca8a docs: add User Guide with workflow diagrams, troubleshooting, and config reference
Create docs/USER-GUIDE.md as a detailed companion to the README, covering:
- Workflow diagrams (project lifecycle, planning coordination, execution waves, brownfield)
- Command reference with "When to Use" guidance for each command
- Full config.json schema including workflow toggles, git branching, and per-agent model profiles
- Practical usage examples for common scenarios
- Troubleshooting section for common issues
- Recovery quick reference table

Add link from README navigation bar and Configuration section to the User Guide.

Closes #457

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-09 14:12:35 +01: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