Epic: Context Quality (v0.2)

[prosdev]

Overview

Transform dev-agent from returning pointers to returning actionable context. When an AI assistant asks "where is X?", we should return enough information to understand and work with the code—not just file paths that require additional reads.

Philosophy

• Structured data over prose - Code snippets, relationships, patterns
• Token-aware - Fit context within LLM limits using progressive disclosure
• Reduce round-trips - One query should return everything needed

Success Criteria

• dev_search returns code snippets + imports (not just locations) ✅
• dev_refs shows what calls/is called by a function
• dev_map provides codebase overview in one query
• dev_plan returns raw context, not heuristic task breakdowns

Tasks

• Epic: Richer Search Results #66 Richer Search Results
• Relationship Queries (dev_refs)
• Codebase Map (dev_map)
• Refactor Planner → Context Assembler

Out of Scope

• LLM integration (we provide context, external LLMs reason)
• Effort estimation heuristics
• PR description generation
• Task breakdown logic (let the LLM do this)

Timeline

Target: v0.2.0 release

[prosdev]

Epic completed in v0.3.0! All tasks done:

• ✅ Richer Search Results (Epic: Richer Search Results #66)
• ✅ Relationship Queries - dev_refs (Relationship Queries (dev_refs) #80)
• ✅ Codebase Map - dev_map (Codebase Map (dev_map) #81)
• ✅ Refactor Planner → Context Assembler (Refactor Planner → Context Assembler #82)