diff --git a/commands/gsd/audit-milestone.md b/commands/gsd/audit-milestone.md index 227023182..02831a604 100644 --- a/commands/gsd/audit-milestone.md +++ b/commands/gsd/audit-milestone.md @@ -18,7 +18,7 @@ Verify milestone achieved its definition of done. Check requirements coverage, c -@~/.claude/get-shit-done/references/principles.md + diff --git a/commands/gsd/create-roadmap.md b/commands/gsd/create-roadmap.md index ab96f42a1..096da814a 100644 --- a/commands/gsd/create-roadmap.md +++ b/commands/gsd/create-roadmap.md @@ -35,11 +35,9 @@ Roadmaps define what work happens in what order. Phases map to requirements. -@~/.claude/get-shit-done/references/principles.md @~/.claude/get-shit-done/workflows/create-roadmap.md @~/.claude/get-shit-done/templates/roadmap.md @~/.claude/get-shit-done/templates/state.md -@~/.claude/get-shit-done/references/goal-backward.md diff --git a/commands/gsd/define-requirements.md b/commands/gsd/define-requirements.md index c55596b91..64c24b63f 100644 --- a/commands/gsd/define-requirements.md +++ b/commands/gsd/define-requirements.md @@ -36,7 +36,6 @@ Output: `.planning/REQUIREMENTS.md` -@~/.claude/get-shit-done/references/principles.md @~/.claude/get-shit-done/workflows/define-requirements.md @~/.claude/get-shit-done/templates/requirements.md diff --git a/commands/gsd/discuss-milestone.md b/commands/gsd/discuss-milestone.md index 096beb85d..c68ab8410 100644 --- a/commands/gsd/discuss-milestone.md +++ b/commands/gsd/discuss-milestone.md @@ -11,7 +11,6 @@ Output: Context gathered, then routes to /gsd:new-milestone -@~/.claude/get-shit-done/references/principles.md @~/.claude/get-shit-done/workflows/discuss-milestone.md diff --git a/commands/gsd/discuss-phase.md b/commands/gsd/discuss-phase.md index b3241dbc4..8beef2500 100644 --- a/commands/gsd/discuss-phase.md +++ b/commands/gsd/discuss-phase.md @@ -18,7 +18,6 @@ Extract implementation decisions that downstream agents need — researcher and -@~/.claude/get-shit-done/references/principles.md @~/.claude/get-shit-done/workflows/discuss-phase.md @~/.claude/get-shit-done/templates/context.md diff --git a/commands/gsd/execute-phase.md b/commands/gsd/execute-phase.md index 9a656549e..ec130eb78 100644 --- a/commands/gsd/execute-phase.md +++ b/commands/gsd/execute-phase.md @@ -23,7 +23,6 @@ Context budget: ~15% orchestrator, 100% fresh per subagent. -@~/.claude/get-shit-done/references/principles.md @~/.claude/get-shit-done/references/ui-brand.md @~/.claude/get-shit-done/workflows/execute-phase.md diff --git a/commands/gsd/execute-plan.md b/commands/gsd/execute-plan.md index f1bb882cc..a92fbf43f 100644 --- a/commands/gsd/execute-plan.md +++ b/commands/gsd/execute-plan.md @@ -25,7 +25,7 @@ Context budget: ~15% orchestrator, 100% fresh for subagent. -@~/.claude/get-shit-done/references/principles.md + diff --git a/commands/gsd/plan-milestone-gaps.md b/commands/gsd/plan-milestone-gaps.md index 5f93830c8..70bed3460 100644 --- a/commands/gsd/plan-milestone-gaps.md +++ b/commands/gsd/plan-milestone-gaps.md @@ -19,8 +19,7 @@ One command creates all fix phases — no manual `/gsd:add-phase` per gap. -@~/.claude/get-shit-done/references/principles.md -@~/.claude/get-shit-done/workflows/plan-phase.md + diff --git a/get-shit-done/references/debugging/debugging-mindset.md b/get-shit-done/references/debugging/debugging-mindset.md deleted file mode 100644 index b66b732d9..000000000 --- a/get-shit-done/references/debugging/debugging-mindset.md +++ /dev/null @@ -1,11 +0,0 @@ -# Debugging Mindset (DEPRECATED) - -This reference has been consolidated into the `gsd-debugger` agent. - -**Location:** `agents/gsd-debugger.md` - -**Section:** `` - -**Reason:** Debugging expertise is now baked into the agent. Loading separate reference files into orchestrator context was wasteful (~95% context reduction). - -See `agents/gsd-debugger.md` for the consolidated debugging methodology. diff --git a/get-shit-done/references/debugging/hypothesis-testing.md b/get-shit-done/references/debugging/hypothesis-testing.md deleted file mode 100644 index ad871b9fb..000000000 --- a/get-shit-done/references/debugging/hypothesis-testing.md +++ /dev/null @@ -1,11 +0,0 @@ -# Hypothesis Testing (DEPRECATED) - -This reference has been consolidated into the `gsd-debugger` agent. - -**Location:** `agents/gsd-debugger.md` - -**Section:** `` - -**Reason:** Debugging expertise is now baked into the agent. Loading separate reference files into orchestrator context was wasteful (~95% context reduction). - -See `agents/gsd-debugger.md` for the consolidated debugging methodology. diff --git a/get-shit-done/references/debugging/investigation-techniques.md b/get-shit-done/references/debugging/investigation-techniques.md deleted file mode 100644 index 3c103e0d8..000000000 --- a/get-shit-done/references/debugging/investigation-techniques.md +++ /dev/null @@ -1,11 +0,0 @@ -# Investigation Techniques (DEPRECATED) - -This reference has been consolidated into the `gsd-debugger` agent. - -**Location:** `agents/gsd-debugger.md` - -**Section:** `` - -**Reason:** Debugging expertise is now baked into the agent. Loading separate reference files into orchestrator context was wasteful (~95% context reduction). - -See `agents/gsd-debugger.md` for the consolidated debugging methodology. diff --git a/get-shit-done/references/debugging/verification-patterns.md b/get-shit-done/references/debugging/verification-patterns.md deleted file mode 100644 index c560b483f..000000000 --- a/get-shit-done/references/debugging/verification-patterns.md +++ /dev/null @@ -1,11 +0,0 @@ -# Verification Patterns (DEPRECATED) - -This reference has been consolidated into the `gsd-debugger` agent. - -**Location:** `agents/gsd-debugger.md` - -**Section:** `` - -**Reason:** Debugging expertise is now baked into the agent. Loading separate reference files into orchestrator context was wasteful (~95% context reduction). - -See `agents/gsd-debugger.md` for the consolidated debugging methodology. diff --git a/get-shit-done/references/debugging/when-to-research.md b/get-shit-done/references/debugging/when-to-research.md deleted file mode 100644 index 4ae7e0b3f..000000000 --- a/get-shit-done/references/debugging/when-to-research.md +++ /dev/null @@ -1,11 +0,0 @@ -# When to Research (DEPRECATED) - -This reference has been consolidated into the `gsd-debugger` agent. - -**Location:** `agents/gsd-debugger.md` - -**Section:** `` - -**Reason:** Debugging expertise is now baked into the agent. Loading separate reference files into orchestrator context was wasteful (~95% context reduction). - -See `agents/gsd-debugger.md` for the consolidated debugging methodology. diff --git a/get-shit-done/references/goal-backward.md b/get-shit-done/references/goal-backward.md deleted file mode 100644 index f103fb92a..000000000 --- a/get-shit-done/references/goal-backward.md +++ /dev/null @@ -1,33 +0,0 @@ -# DEPRECATED: Goal-Backward Planning Reference - -**This reference has been consolidated into the gsd-planner agent.** - -## Migration - -Planning expertise is now baked into: -- `agents/gsd-planner.md` - Section: `` - -## Why This Changed - -The thin orchestrator pattern consolidates all planning methodology into the agent: -- Before: Reference files loaded separately (~287 lines) -- After: Agent has expertise baked in, orchestrator is thin - -## Historical Reference - -This file previously contained: -- Goal-backward vs forward planning distinction -- Must-haves derivation process (5 steps) -- Observable truths from user perspective -- Required artifacts mapping -- Required wiring analysis -- Key links identification -- must_haves YAML structure for PLAN.md frontmatter -- Examples (e-commerce, settings, notifications) -- Common failures and anti-patterns - -All content preserved in `agents/gsd-planner.md`. - ---- -*Deprecated: 2026-01-16* -*Replaced by: agents/gsd-planner.md* diff --git a/get-shit-done/references/plan-format.md b/get-shit-done/references/plan-format.md deleted file mode 100644 index 5f58d0161..000000000 --- a/get-shit-done/references/plan-format.md +++ /dev/null @@ -1,32 +0,0 @@ -# DEPRECATED: Plan Format Reference - -**This reference has been consolidated into the gsd-planner agent.** - -## Migration - -Planning expertise is now baked into: -- `agents/gsd-planner.md` - Section: `` - -## Why This Changed - -The thin orchestrator pattern consolidates all planning methodology into the agent: -- Before: Reference files loaded separately (~474 lines) -- After: Agent has expertise baked in, orchestrator is thin - -## Historical Reference - -This file previously contained: -- PLAN.md frontmatter structure -- XML prompt structure -- Task anatomy (files, action, verify, done) -- Task types (auto, checkpoint:*) -- TDD plans guidance -- Context references and anti-patterns -- Specificity levels (too vague vs just right) -- Task sizing guidance - -All content preserved in `agents/gsd-planner.md`. - ---- -*Deprecated: 2026-01-16* -*Replaced by: agents/gsd-planner.md* diff --git a/get-shit-done/references/principles.md b/get-shit-done/references/principles.md deleted file mode 100644 index 49e033e09..000000000 --- a/get-shit-done/references/principles.md +++ /dev/null @@ -1,29 +0,0 @@ -# DEPRECATED: GSD Principles - -**This reference has been consolidated into the gsd-planner agent.** - -## Migration - -Planning expertise is now baked into: -- `agents/gsd-planner.md` - Section: `` - -## Why This Changed - -The thin orchestrator pattern consolidates all planning methodology into the agent: -- Before: Reference files loaded separately (~74 lines) -- After: Agent has expertise baked in, orchestrator is thin - -## Historical Reference - -This file previously contained: -- Solo developer + Claude workflow philosophy -- "Plans are prompts" principle -- Scope control and quality degradation curve -- "Claude automates" and "ship fast" principles -- Anti-enterprise patterns - -All content preserved in `agents/gsd-planner.md`. - ---- -*Deprecated: 2026-01-16* -*Replaced by: agents/gsd-planner.md* diff --git a/get-shit-done/references/research-pitfalls.md b/get-shit-done/references/research-pitfalls.md deleted file mode 100644 index 1575919f7..000000000 --- a/get-shit-done/references/research-pitfalls.md +++ /dev/null @@ -1,233 +0,0 @@ -# Research Pitfalls Reference - -## DEPRECATED - -**This reference has been consolidated into the gsd-researcher agent.** - -The verification protocols and pitfall patterns now live in: -- `agents/gsd-researcher.md` (section: ``) - -The content below is preserved for reference but is no longer the primary source. - ---- - -*Deprecated: 2026-01-15* -*Replaced by: agents/gsd-researcher.md* - ---- - - - - -This document catalogs research mistakes discovered in production use, providing specific patterns to avoid and verification strategies to prevent recurrence. - - - - - -**What**: Assuming global configuration means no project-scoping exists -**Example**: Concluding "MCP servers are configured GLOBALLY only" while missing project-scoped `.mcp.json` -**Why it happens**: Not explicitly checking all known configuration patterns -**Prevention**: -```xml - -**CRITICAL**: Verify ALL configuration scopes: -- User/global scope - System-wide configuration -- Project scope - Project-level configuration files -- Local scope - Project-specific user overrides -- Workspace scope - IDE/tool workspace settings -- Environment scope - Environment variables - -``` - - - -**What**: Asking researchers to "search for documentation" without specifying where -**Example**: "Research MCP documentation" -> finds outdated community blog instead of official docs -**Why it happens**: Vague research instructions don't specify exact sources -**Prevention**: -```xml - -Official sources (use WebFetch): -- https://exact-url-to-official-docs -- https://exact-url-to-api-reference - -Search queries (use WebSearch): -- "specific search query {current_year}" -- "another specific query {current_year}" - -``` - - - -**What**: Finding archived/old documentation and concluding feature doesn't exist -**Example**: Finding 2022 docs saying "feature not supported" when current version added it -**Why it happens**: Not checking multiple sources or recent updates -**Prevention**: -```xml - -- Check current official documentation -- Review changelog/release notes for recent updates -- Verify version numbers and publication dates -- Cross-reference multiple authoritative sources - -``` - - - -**What**: Conflating capabilities across different tools/environments -**Example**: "Claude Desktop supports X" does not mean "Claude Code supports X" -**Why it happens**: Not explicitly checking each environment separately -**Prevention**: -```xml - -- Claude Desktop capabilities -- Claude Code capabilities -- VS Code extension capabilities -- API/SDK capabilities -Document which environment supports which features - -``` - - - -**What**: Making definitive "X is not possible" statements without official source verification -**Example**: "Folder-scoped MCP configuration is not supported" (missing `.mcp.json`) -**Why it happens**: Drawing conclusions from absence of evidence rather than evidence of absence -**Prevention**: -```xml - -For any "X is not possible" or "Y is the only way" statement: -- [ ] Is this verified by official documentation stating it explicitly? -- [ ] Have I checked for recent updates that might change this? -- [ ] Have I verified all possible approaches/mechanisms? -- [ ] Am I confusing "I didn't find it" with "it doesn't exist"? - -``` - - - -**What**: Investigating open-ended scope without enumerating known possibilities first -**Example**: "Research configuration options" instead of listing specific options to verify -**Why it happens**: Not creating explicit checklist of items to investigate -**Prevention**: -```xml - -Enumerate ALL known options FIRST: -- Option 1: [specific item] -- Option 2: [specific item] -- Option 3: [specific item] -- Check for additional unlisted options - -For each option above, document: -- Existence (confirmed/not found/unclear) -- Official source URL -- Current status (active/deprecated/beta) - -``` - - - -**What**: Relying on a single source for critical claims -**Example**: Using only Stack Overflow answer from 2021 for current best practices -**Why it happens**: Not cross-referencing multiple authoritative sources -**Prevention**: -```xml - -For critical claims, require multiple sources: -- [ ] Official documentation (primary) -- [ ] Release notes/changelog (for currency) -- [ ] Additional authoritative source (for verification) -- [ ] Contradiction check (ensure sources agree) - -``` - - - -**What**: Assuming search results are complete and authoritative -**Example**: First Google result is outdated but assumed current -**Why it happens**: Not verifying publication dates and source authority -**Prevention**: -```xml - -For each source consulted: -- [ ] Publication/update date verified (prefer recent/current) -- [ ] Source authority confirmed (official docs, not blogs) -- [ ] Version relevance checked (matches current version) -- [ ] Multiple search queries tried (not just one) - -``` - - - - - - -**Warning**: Every investigation succeeds perfectly -**Problem**: Real research encounters dead ends, ambiguity, and unknowns -**Action**: Expect honest reporting of limitations, contradictions, and gaps - - - -**Warning**: All findings presented as equally certain -**Problem**: Can't distinguish verified facts from educated guesses -**Action**: Require confidence levels (High/Medium/Low) for key findings - - - -**Warning**: "According to documentation..." without specific URL -**Problem**: Can't verify claims or check for updates -**Action**: Require actual URLs for all official documentation claims - - - -**Warning**: "X cannot do Y" or "Z is the only way" without citation -**Problem**: Strong claims require strong evidence -**Action**: Flag for verification against official sources - - - -**Warning**: Verification checklist lists 4 items, output covers 2 -**Problem**: Systematic gaps in coverage -**Action**: Ensure all enumerated items addressed or marked "not found" - - - - - -When research gaps occur: - -1. **Document the gap** - - What was missed or incorrect? - - What was the actual correct information? - - What was the impact? - -2. **Root cause analysis** - - Why wasn't it caught? - - Which verification step would have prevented it? - - What pattern does this reveal? - -3. **Update this document** - - Add new pitfall entry - - Update relevant checklists - - Share lesson learned - - - - -Before submitting research, verify: - -- [ ] All enumerated items investigated (not just some) -- [ ] Negative claims verified with official docs -- [ ] Multiple sources cross-referenced for critical claims -- [ ] URLs provided for all official documentation -- [ ] Publication dates checked (prefer recent/current) -- [ ] Tool/environment-specific variations documented -- [ ] Confidence levels assigned honestly -- [ ] Assumptions distinguished from verified facts -- [ ] "What might I have missed?" review completed - -**Living Document**: Update after each significant research gap -**Lessons From**: MCP configuration research gap (missed `.mcp.json`) - - diff --git a/get-shit-done/references/scope-estimation.md b/get-shit-done/references/scope-estimation.md deleted file mode 100644 index 967fa69be..000000000 --- a/get-shit-done/references/scope-estimation.md +++ /dev/null @@ -1,32 +0,0 @@ -# DEPRECATED: Scope Estimation Reference - -**This reference has been consolidated into the gsd-planner agent.** - -## Migration - -Planning expertise is now baked into: -- `agents/gsd-planner.md` - Section: `` - -## Why This Changed - -The thin orchestrator pattern consolidates all planning methodology into the agent: -- Before: Reference files loaded separately (~257 lines) -- After: Agent has expertise baked in, orchestrator is thin - -## Historical Reference - -This file previously contained: -- Quality degradation curve (0-30%, 30-50%, 50-70%, 70%+) -- Context budget targets (~50%) -- Task-per-plan rules (2-3 tasks) -- Split signals (always split, consider splitting) -- Splitting strategies (vertical slices preferred) -- Dependency awareness and wave assignment -- File ownership for parallel execution -- Depth calibration (quick, standard, comprehensive) - -All content preserved in `agents/gsd-planner.md`. - ---- -*Deprecated: 2026-01-16* -*Replaced by: agents/gsd-planner.md* diff --git a/get-shit-done/templates/phase-prompt.md b/get-shit-done/templates/phase-prompt.md index 860f01d4b..607a97b4f 100644 --- a/get-shit-done/templates/phase-prompt.md +++ b/get-shit-done/templates/phase-prompt.md @@ -573,5 +573,4 @@ Task completion ≠ Goal achievement. A task "create chat component" can complet 5. Gaps found → fix plans created → execute → re-verify 6. All must_haves pass → phase complete -See `~/.claude/get-shit-done/references/goal-backward.md` for derivation process. See `~/.claude/get-shit-done/workflows/verify-phase.md` for verification logic. diff --git a/get-shit-done/workflows/debug.md b/get-shit-done/workflows/debug.md deleted file mode 100644 index d507a22c2..000000000 --- a/get-shit-done/workflows/debug.md +++ /dev/null @@ -1,14 +0,0 @@ -# Debug Workflow (DEPRECATED) - -This workflow has been consolidated into the `gsd-debugger` agent. - -**Location:** `agents/gsd-debugger.md` - -**Reason:** The gsd-debugger agent contains all debugging expertise. Loading a separate workflow into orchestrator context was wasteful. - -**Migration:** -- `/gsd:debug` now spawns `gsd-debugger` agent directly -- All debugging methodology lives in the agent file -- Templates remain at `get-shit-done/templates/DEBUG.md` - -See `agents/gsd-debugger.md` for debugging expertise. diff --git a/get-shit-done/workflows/discovery-phase.md b/get-shit-done/workflows/discovery-phase.md index 5fcb2a821..19b651a07 100644 --- a/get-shit-done/workflows/discovery-phase.md +++ b/get-shit-done/workflows/discovery-phase.md @@ -107,7 +107,7 @@ For: Choosing between options, new external integration. 5. **Cross-verify:** Any WebSearch finding → confirm with Context7/official docs. -6. **Quality check:** Before finalizing findings, consult ~/.claude/get-shit-done/references/research-pitfalls.md to avoid common research gaps. +6. **Quality check:** Before finalizing findings, consult the gsd-researcher agent's verification protocols to avoid common research gaps. 7. **Create DISCOVERY.md** using ~/.claude/get-shit-done/templates/discovery.md structure: @@ -160,7 +160,7 @@ For: Architectural decisions, novel problems, high-risk choices. - Mark what's verified vs assumed - Flag contradictions -6. **Quality check:** Before finalizing findings, consult ~/.claude/get-shit-done/references/research-pitfalls.md to ensure comprehensive coverage and avoid common research gaps. +6. **Quality check:** Before finalizing findings, consult the gsd-researcher agent's verification protocols to ensure comprehensive coverage and avoid common research gaps. 7. **Create comprehensive DISCOVERY.md:** diff --git a/get-shit-done/workflows/plan-phase.md b/get-shit-done/workflows/plan-phase.md deleted file mode 100644 index 644683a31..000000000 --- a/get-shit-done/workflows/plan-phase.md +++ /dev/null @@ -1,41 +0,0 @@ -# DEPRECATED: Plan-Phase Workflow - -**This workflow has been consolidated into the gsd-planner agent.** - -## Migration - -Planning expertise is now baked into: -- `agents/gsd-planner.md` - Complete planning methodology - -The `/gsd:plan-phase` command spawns the gsd-planner agent directly. - -## Why This Changed - -The thin orchestrator pattern reduces main context usage: -- Before: ~3,580 lines loaded into main context -- After: ~150 lines in orchestrator, expertise in agent - -## Historical Reference - -This file previously contained: -- Decimal phase numbering rules -- Required reading list (8 reference files) -- Planning principles and philosophy -- Discovery level definitions (Level 0-3) -- Project history assembly via frontmatter dependency graph -- Gap closure mode process -- Task breakdown with TDD detection -- Dependency graph building -- Wave assignment algorithm -- Plan grouping rules -- Scope estimation and depth calibration -- Phase prompt writing (PLAN.md structure) -- User setup frontmatter for external services -- Git commit step -- Success criteria (standard and gap closure modes) - -All content preserved in `agents/gsd-planner.md`. - ---- -*Deprecated: 2026-01-16* -*Replaced by: agents/gsd-planner.md* diff --git a/get-shit-done/workflows/research-phase.md b/get-shit-done/workflows/research-phase.md deleted file mode 100644 index 6b74959db..000000000 --- a/get-shit-done/workflows/research-phase.md +++ /dev/null @@ -1,17 +0,0 @@ -# Research Phase Workflow - -## DEPRECATED - -**This workflow has been consolidated into the gsd-researcher agent.** - -The research methodology, tool strategy, source hierarchy, and verification protocols now live in: -- `agents/gsd-researcher.md` - -The `/gsd:research-phase` command spawns the gsd-researcher agent directly. - -**Migration:** No action needed - the command handles this automatically. - ---- - -*Deprecated: 2026-01-15* -*Replaced by: agents/gsd-researcher.md* diff --git a/get-shit-done/workflows/research-project.md b/get-shit-done/workflows/research-project.md deleted file mode 100644 index 61f745735..000000000 --- a/get-shit-done/workflows/research-project.md +++ /dev/null @@ -1,23 +0,0 @@ -# Research Project Workflow - -## DEPRECATED - -**This workflow has been consolidated into the gsd-researcher agent.** - -The research methodology for project research now lives in: -- `agents/gsd-researcher.md` - -The `/gsd:research-project` command spawns 4 parallel gsd-researcher agents: -- Stack agent -> .planning/research/STACK.md -- Features agent -> .planning/research/FEATURES.md -- Architecture agent -> .planning/research/ARCHITECTURE.md -- Pitfalls agent -> .planning/research/PITFALLS.md - -The orchestrator synthesizes SUMMARY.md after all agents complete. - -**Migration:** No action needed - the command handles this automatically. - ---- - -*Deprecated: 2026-01-15* -*Replaced by: agents/gsd-researcher.md* diff --git a/get-shit-done/workflows/verify-phase.md b/get-shit-done/workflows/verify-phase.md index d50506bb1..4ac36cad1 100644 --- a/get-shit-done/workflows/verify-phase.md +++ b/get-shit-done/workflows/verify-phase.md @@ -19,7 +19,6 @@ Then verify each level against the actual codebase. **Load these references:** -- ~/.claude/get-shit-done/references/goal-backward.md (derivation process) - ~/.claude/get-shit-done/references/verification-patterns.md (detection patterns) - ~/.claude/get-shit-done/templates/verification-report.md (output format) @@ -97,7 +96,7 @@ If no must_haves in frontmatter, derive using goal-backward process: 5. **Document derived must-haves** before proceeding to verification. -See ~/.claude/get-shit-done/references/goal-backward.md for detailed derivation guidance. +