Codebase Analysis Command
Perform comprehensive codebase analysis to understand patterns, architecture, and implementation details.
Instructions
Use the codebase-analyst agent to perform deep codebase analysis.
The codebase-analyst agent provides:
- Pattern recognition across multiple files
- Architecture analysis (dependencies, structure, layers)
- Implementation detail exploration (how code works)
- Cross-cutting concern analysis (error handling, logging, auth)
- Technical debt identification
Invoke the agent based on the arguments provided:
$ARGUMENTS
Based on the arguments, determine the analysis scope:
If a topic/concept provided (e.g., "authentication", "error handling"):
- Find all code related to that concept
- Analyze patterns, implementations, and consistency
- Identify entry points, data flows, and dependencies
If a directory/path provided (e.g., "src/components/"):
- Analyze architecture and structure of that module
- Identify patterns and conventions used
- Map internal dependencies
If a question provided (e.g., "how does the API handle errors?"):
- Research and answer the architectural question
- Provide code references and examples
- Explain the design decisions
If no arguments:
- Provide high-level codebase overview
- Identify main modules and their relationships
- Highlight key patterns and conventions
Examples
Analyze a Concept
/code-quality:analyze authentication
/code-quality:analyze "error handling patterns"
/code-quality:analyze "how API endpoints work"
Analyze a Module
/code-quality:analyze src/components/
/code-quality:analyze "the database layer"
Answer Architectural Questions
/code-quality:analyze "how does caching work in this codebase?"
/code-quality:analyze "what design patterns are used?"
General Overview
/code-quality:analyze
Output Format
The agent returns analysis findings:
## Analysis: [Topic/Scope]
### Overview
[High-level summary of findings]
### Key Patterns
- [Pattern 1]: [Description and locations]
- [Pattern 2]: [Description and locations]
### Architecture
[Structure, layers, dependencies]
### Code References
- `path/to/file.ext:line` - [What this shows]
### Recommendations
[Suggestions for understanding or improving]
Command Design Notes
This command delegates to the codebase-analyst agent which specializes in deep exploration and pattern recognition. It's read-only and focuses on understanding rather than modification.