source-command-research-codebase

What problem does it solve? Answering questions about how a large codebase works requires manually tracing files, components, and historical decisions, which is slow and error-prone. This Skill automates comprehensive codebase research by spawning parallel sub-agents and compiling their findings into a structured, citable research document. ## Core Features & Use Cases - Parallel Sub-Agent Research: Spawns specialized locator, analyzer, and pattern-finder agents to map where code lives and how it works without critiquing it. - Structured Research Documents: Generates markdown reports with YAML frontmatter, code references with file paths and line numbers, and GitHub permalinks, saved to the thoughts/ directory. - Historical Context Integration: Combines live codebase findings with prior research and decisions stored in the thoughts/ directory. - Use Case: Ask how the authentication flow works, and receive a complete document mapping every relevant file, component interaction, and past design decision. ## Quick Start Ask the agent to research how a specific feature or component works in the codebase and generate a research document.