bootspring analyze
Deep codebase analysis for understanding your project's architecture, patterns, and dependencies.
Overview
The analyze command performs comprehensive codebase analysis to help you and AI assistants understand your project structure. It generates detailed reports about architecture, dependencies, patterns, and potential issues.
Usage
Loading code block...
Commands
| Command | Description |
|---|---|
| (default) | Run full analysis |
status | Show current progress |
resume | Continue from checkpoint |
reset | Reset workflow state |
Options
| Option | Description |
|---|---|
--depth=<level> | Analysis depth: shallow, standard, deep |
--phase=<phase> | Run specific phase only |
--include=<glob> | Include pattern (e.g., "src/**") |
--exclude=<glob> | Exclude pattern |
Analysis Depth
Shallow
Quick scan focusing on structure and architecture only. Best for getting a quick overview.
Loading code block...
Standard (Default)
Standard analysis including patterns and dependencies. Recommended for most use cases.
Loading code block...
Deep
Comprehensive analysis with flow tracing and component analysis. Best for detailed understanding.
Loading code block...
Analysis Phases
The analysis runs through multiple phases:
- Structure Mapping - Parse files, build tree, detect monorepo
- Architecture - Identify layers, modules, patterns (MVC, etc.)
- Dependencies - Import graph, circular deps, unused deps
- Pattern Detection - Design patterns, anti-patterns, code smells
- Flow Tracing - Entry points, request flows, data flows
- Component Analysis - Component signatures, prop drilling, coupling
- Report Generation - Executive summary, Mermaid diagrams
Output
Analysis generates a comprehensive report at /planning/CODEBASE_ANALYSIS.md containing:
- Executive summary with health score
- Architecture diagram (Mermaid)
- Module map with dependencies
- Entry points table
- Pattern findings
- Circular dependency warnings
- Recommendations
Examples
Loading code block...
Related Commands
bootspring audit- Quality and security auditbootspring onboard- Layer Bootspring onto existing projectsbootspring context- View project context