Bootspring
HomeGet Started

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#

bootspring analyze [command] [options]

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.

bootspring analyze --depth=shallow

Standard (Default)#

Standard analysis including patterns and dependencies. Recommended for most use cases.

bootspring analyze

Deep#

Comprehensive analysis with flow tracing and component analysis. Best for detailed understanding.

bootspring analyze --depth=deep

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#

1# Full analysis 2bootspring analyze 3 4# Quick scan 5bootspring analyze --depth=shallow 6 7# Deep analysis 8bootspring analyze --depth=deep 9 10# Check progress 11bootspring analyze status 12 13# Resume after interruption 14bootspring analyze resume 15 16# Analyze specific directory 17bootspring analyze --include="src/**"

Related Commands#