diff --git a/commands/gsd/map-codebase.md b/commands/gsd/map-codebase.md index 84f0049df..cadc93567 100644 --- a/commands/gsd/map-codebase.md +++ b/commands/gsd/map-codebase.md @@ -13,7 +13,7 @@ allowed-tools: Analyze existing codebase using parallel Explore agents to produce structured codebase documents. -This command spawns multiple Explore agents to analyze different aspects of the codebase in parallel, each with fresh context. Each agent produces focused documentation under 100 lines. +This command spawns multiple Explore agents to analyze different aspects of the codebase in parallel, each with fresh context. Output: .planning/codebase/ folder with 7 structured documents about the codebase state. @@ -71,14 +71,12 @@ Check for .planning/STATE.md - loads context if project already initialized - TESTING.md - Test structure, coverage, practices - INTEGRATIONS.md - APIs, databases, external services - CONCERNS.md - Technical debt, risks, issues -6. Verify each document is under 100 lines (summarize if needed) -7. Offer next steps (typically: /gsd:new-project or /gsd:plan-phase) +6. Offer next steps (typically: /gsd:new-project or /gsd:plan-phase) - [ ] .planning/codebase/ directory created - [ ] All 7 codebase documents written -- [ ] Each document under 100 lines - [ ] Documents follow template structure - [ ] Parallel agents completed without errors - [ ] User knows next steps diff --git a/get-shit-done/templates/codebase/stack.md b/get-shit-done/templates/codebase/stack.md index a686cbb1e..f57f7f10c 100644 --- a/get-shit-done/templates/codebase/stack.md +++ b/get-shit-done/templates/codebase/stack.md @@ -177,7 +177,6 @@ Template for `.planning/codebase/STACK.md` - captures the technology foundation. - Note runtime version from .nvmrc or package.json engines - Include only dependencies that affect understanding (not every utility) - Specify versions only when version matters (breaking changes, compatibility) -- Keep under ~100 lines total **Useful for phase planning when:** - Adding new dependencies (check compatibility) diff --git a/get-shit-done/workflows/execute-phase.md b/get-shit-done/workflows/execute-phase.md index 75d945ebc..9cc115c47 100644 --- a/get-shit-done/workflows/execute-phase.md +++ b/get-shit-done/workflows/execute-phase.md @@ -1177,7 +1177,6 @@ For each document needing update: 1. Read current document 2. Identify what changed (new entries, removed entries, modified sections) 3. Apply minimal edits to reflect new state -4. Keep document under 100 lines (summarize if needed) **Commit codebase updates:** ```bash diff --git a/get-shit-done/workflows/map-codebase.md b/get-shit-done/workflows/map-codebase.md index c0002c3f5..d9ee9a3cb 100644 --- a/get-shit-done/workflows/map-codebase.md +++ b/get-shit-done/workflows/map-codebase.md @@ -1,7 +1,7 @@ Orchestrate parallel Explore agents to analyze codebase and produce structured documents in .planning/codebase/ -Each agent has fresh context and focuses on specific aspects. Output is concise (under 100 lines per document) and actionable for planning. +Each agent has fresh context and focuses on specific aspects. Output is concise and actionable for planning. @@ -11,8 +11,8 @@ Each agent has fresh context and focuses on specific aspects. Output is concise - Each agent optimized for its domain (tech vs organization vs quality vs issues) - Faster execution (agents run simultaneously) -**Why 100-line limit:** -Codebase maps are reference material loaded frequently. Concise summaries are more useful than exhaustive inventories. If codebase is large, summarize patterns rather than listing every file. +**Document quality over length:** +Include enough detail to be useful as reference. Prioritize practical examples (especially code patterns) over arbitrary brevity. A 200-line TESTING.md with real patterns is more valuable than a 74-line summary. @@ -255,13 +255,6 @@ If an agent didn't find information for a section, use placeholder: - "Not applicable" (for patterns that don't apply to this codebase) - "No significant concerns" (for CONCERNS.md if codebase is clean) -**Line count check:** - -Before writing, estimate total lines for each document. If any will exceed 100 lines: -- Summarize patterns instead of listing all instances -- Prioritize most important/frequent patterns -- Reference "see code for full details" for exhaustive lists - Continue to write_documents. @@ -281,11 +274,7 @@ For each document: - "Not detected" for optional infrastructure - "Not applicable" for patterns that don't fit this codebase - "No significant concerns" for clean codebase areas -4. **Verify line count** - if filled template exceeds 100 lines, summarize: - - Keep most critical findings - - Summarize patterns instead of exhaustive lists - - Add "(see code for full details)" where appropriate -5. **Write to .planning/codebase/{NAME}.md** (uppercase filename) +4. **Write to .planning/codebase/{NAME}.md** (uppercase filename) **Example filling pattern:** @@ -329,7 +318,6 @@ wc -l .planning/codebase/*.md **Verification checklist:** - All 7 documents exist -- Each document under 100 lines - No empty documents - Templates populated with findings @@ -377,7 +365,6 @@ Created .planning/codebase/: - INTEGRATIONS.md ([N] lines) - External services and APIs - CONCERNS.md ([N] lines) - Technical debt and issues -[If any files >100 lines, add warning: "⚠ Some files exceed 100 lines - consider summarizing further"] --- @@ -410,7 +397,6 @@ End workflow. - Agent prompts are specific and actionable - TaskOutput used to collect all agent results - All 7 codebase documents written using template filling -- Each document under 100 lines (or warning shown) - Documents follow template structure with actual findings - Clear completion summary with line counts - User offered clear next steps in GSD style