fix: remove arbitrary 100-line limit from codebase mapping
The limit was causing loss of useful context, especially code examples in TESTING.md and CONVENTIONS.md. Document quality > arbitrary brevity. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -13,7 +13,7 @@ allowed-tools:
|
||||
<objective>
|
||||
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.
|
||||
</objective>
|
||||
@@ -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)
|
||||
</process>
|
||||
|
||||
<success_criteria>
|
||||
- [ ] .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
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<purpose>
|
||||
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.
|
||||
</purpose>
|
||||
|
||||
<philosophy>
|
||||
@@ -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.
|
||||
</philosophy>
|
||||
|
||||
<process>
|
||||
@@ -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.
|
||||
</step>
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user