From 9a3a394f79c2eef09c0613e23d446d194e3b36f9 Mon Sep 17 00:00:00 2001 From: Lex Christopherson Date: Tue, 20 Jan 2026 11:53:21 -0600 Subject: [PATCH] docs: update changelog and documentation for v1.9.0 --- CHANGELOG.md | 26 ++++++++++++++- README.md | 21 ++++++++++-- commands/gsd/help.md | 76 ++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 120 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 64c7878e1..34b77428b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,29 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). ## [Unreleased] +## [1.9.0] - 2025-01-20 + +### Added +- **Codebase Intelligence System** — Automatic semantic understanding of your codebase + - `/gsd:analyze-codebase` now generates semantic entities (modules, services, utils) from AST analysis + - `/gsd:query-intel` command for CLI access to dependency graph (`dependents`, `hotspots`) + - SQLite graph database (`.planning/intel/graph.db`) stores entity relationships + - SessionStart hook injects relevant codebase context into conversations + - PostToolUse hook maintains index incrementally as files change + - Stop hook prunes deleted files from index +- **Model Profiles** — `/gsd:set-profile` for quality/balanced/budget agent configurations +- **Workflow Settings** — `/gsd:settings` command for toggling workflow behaviors interactively + +### Changed +- Subagent prompts now include codebase intelligence context when available +- New project initialization creates intel directory structure +- Install process registers intel hooks automatically +- Documentation updated: help.md, README.md with new commands and codebase intelligence features + +### Fixed +- Orchestrators now inline file contents in Task prompts (fixes context issues with @ references) +- Tech debt from milestone audit addressed + ## [1.8.0] - 2026-01-19 ### Added @@ -957,7 +980,8 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). - YOLO mode for autonomous execution - Interactive mode with checkpoints -[Unreleased]: https://github.com/glittercowboy/get-shit-done/compare/v1.8.0...HEAD +[Unreleased]: https://github.com/glittercowboy/get-shit-done/compare/v1.9.0...HEAD +[1.9.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.9.0 [1.8.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.8.0 [1.7.1]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.7.1 [1.7.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.7.0 diff --git a/README.md b/README.md index 4feb927bd..8212401fe 100644 --- a/README.md +++ b/README.md @@ -326,13 +326,14 @@ Use for: bug fixes, small features, config changes, one-off tasks. ### Codebase Intelligence -GSD learns your codebase patterns automatically. As Claude writes code, a PostToolUse hook indexes exports and imports, detects naming conventions, and builds a lightweight intelligence layer. +GSD learns your codebase patterns automatically. As Claude writes code, a PostToolUse hook indexes exports and imports, detects naming conventions, and builds a semantic understanding of your codebase. **How it works:** 1. **Automatic learning** — Every time Claude writes or edits a JS/TS file, the hook extracts exports/imports and updates `.planning/intel/index.json` 2. **Convention detection** — Analyzes exports for naming patterns (camelCase, PascalCase, etc.), identifies directory purposes, detects file suffixes -3. **Context injection** — At session start, injects a summary into Claude's context so it knows your codebase structure and conventions +3. **Graph database** — Stores entity relationships in SQLite for dependency analysis +4. **Context injection** — At session start, injects a summary into Claude's context so it knows your codebase structure and conventions **For existing codebases:** @@ -342,12 +343,20 @@ GSD learns your codebase patterns automatically. As Claude writes code, a PostTo Performs a bulk scan of your codebase to bootstrap the intelligence layer. Works standalone — no `/gsd:new-project` required. After initial analysis, hooks continue incremental learning. +**Query the graph:** + +``` +/gsd:query-intel dependents src/lib/db.ts # What depends on this file? +/gsd:query-intel hotspots # Most-depended-on files +``` + **Files created:** | File | Purpose | |------|---------| | `.planning/intel/index.json` | File exports and imports index | | `.planning/intel/conventions.json` | Detected patterns (naming, directories, suffixes) | +| `.planning/intel/graph.db` | SQLite database with entity relationships | | `.planning/intel/summary.md` | Concise context for session injection | **Benefits:** @@ -355,6 +364,8 @@ Performs a bulk scan of your codebase to bootstrap the intelligence layer. Works - Claude follows your naming conventions automatically - New files go in the right directories - Consistency maintained across sessions +- Query blast radius before refactoring +- Identify high-impact hotspot files - No manual documentation of patterns needed ### Context Engineering @@ -449,6 +460,7 @@ You're never locked in. The system adapts. | `/gsd:plan-phase [N]` | Research + plan + verify for a phase | | `/gsd:execute-phase ` | Execute all plans in parallel waves, verify when complete | | `/gsd:verify-work [N]` | Manual user acceptance testing ¹ | +| `/gsd:audit-milestone` | Verify milestone achieved its definition of done | | `/gsd:complete-milestone` | Archive milestone, tag release | | `/gsd:new-milestone [name]` | Start next version: questions → research → requirements → roadmap | @@ -458,6 +470,8 @@ You're never locked in. The system adapts. |---------|--------------| | `/gsd:progress` | Where am I? What's next? | | `/gsd:help` | Show all commands and usage guide | +| `/gsd:whats-new` | See what changed since your installed version | +| `/gsd:update` | Update GSD with changelog preview | ### Brownfield @@ -465,6 +479,7 @@ You're never locked in. The system adapts. |---------|--------------| | `/gsd:map-codebase` | Analyze existing codebase before new-project | | `/gsd:analyze-codebase` | Bootstrap codebase intelligence for existing projects | +| `/gsd:query-intel ` | Query dependency graph (dependents, hotspots) | ### Phase Management @@ -473,6 +488,8 @@ You're never locked in. The system adapts. | `/gsd:add-phase` | Append phase to roadmap | | `/gsd:insert-phase [N]` | Insert urgent work between phases | | `/gsd:remove-phase [N]` | Remove future phase, renumber | +| `/gsd:list-phase-assumptions [N]` | See Claude's intended approach before planning | +| `/gsd:plan-milestone-gaps` | Create phases to close gaps from audit | ### Session diff --git a/commands/gsd/help.md b/commands/gsd/help.md index b6a1ed09b..80c79652c 100644 --- a/commands/gsd/help.md +++ b/commands/gsd/help.md @@ -285,6 +285,73 @@ List pending todos and select one to work on. Usage: `/gsd:check-todos` Usage: `/gsd:check-todos api` +### User Acceptance Testing + +**`/gsd:verify-work [phase]`** +Validate built features through conversational UAT. + +- Extracts testable deliverables from SUMMARY.md files +- Presents tests one at a time (yes/no responses) +- Automatically diagnoses failures and creates fix plans +- Ready for re-execution if issues found + +Usage: `/gsd:verify-work 3` + +### Milestone Auditing + +**`/gsd:audit-milestone [version]`** +Audit milestone completion against original intent. + +- Reads all phase VERIFICATION.md files +- Checks requirements coverage +- Spawns integration checker for cross-phase wiring +- Creates MILESTONE-AUDIT.md with gaps and tech debt + +Usage: `/gsd:audit-milestone` + +**`/gsd:plan-milestone-gaps`** +Create phases to close gaps identified by audit. + +- Reads MILESTONE-AUDIT.md and groups gaps into phases +- Prioritizes by requirement priority (must/should/nice) +- Adds gap closure phases to ROADMAP.md +- Ready for `/gsd:plan-phase` on new phases + +Usage: `/gsd:plan-milestone-gaps` + +### Configuration + +**`/gsd:settings`** +Configure workflow toggles and model profile interactively. + +- Toggle researcher, plan checker, verifier agents +- Select model profile (quality/balanced/budget) +- Updates `.planning/config.json` + +Usage: `/gsd:settings` + +**`/gsd:set-profile `** +Quick switch model profile for GSD agents. + +- `quality` — Opus everywhere except verification +- `balanced` — Opus for planning, Sonnet for execution (default) +- `budget` — Sonnet for writing, Haiku for research/verification + +Usage: `/gsd:set-profile budget` + +### Codebase Intelligence + +**`/gsd:query-intel [path]`** +Query the codebase intelligence graph database. + +- `dependents ` — What files depend on this? (blast radius) +- `hotspots` — Which files have the most dependents? + +Requires `/gsd:analyze-codebase` to build the graph first. + +Usage: `/gsd:query-intel dependents src/lib/db.ts` +Usage: `/gsd:query-intel hotspots` + ### Utility Commands **`/gsd:help`** @@ -300,6 +367,15 @@ See what's changed since your installed version. Usage: `/gsd:whats-new` +**`/gsd:update`** +Update GSD to latest version with changelog preview. + +- Shows what changed before updating +- Confirms before running install +- Better than raw `npx get-shit-done-cc` + +Usage: `/gsd:update` + ## Files & Structure ```