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

CommandDescription
(default)Run full analysis
statusShow current progress
resumeContinue from checkpoint
resetReset workflow state

Options

OptionDescription
--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:

  1. Structure Mapping - Parse files, build tree, detect monorepo
  2. Architecture - Identify layers, modules, patterns (MVC, etc.)
  3. Dependencies - Import graph, circular deps, unused deps
  4. Pattern Detection - Design patterns, anti-patterns, code smells
  5. Flow Tracing - Entry points, request flows, data flows
  6. Component Analysis - Component signatures, prop drilling, coupling
  7. 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...