Codebase Consolidation & Analysis
Systematically analyze codebases to identify consolidation opportunities, document architecture, and generate actionable insights.
Quick Reference
- Analysis Dimensions - 8 analysis dimensions with detailed criteria
- Consolidation Patterns - Common refactoring patterns with examples
- Report Templates - Output format templates
When to Use
- Starting on a new codebase - Understand structure quickly
- Planning refactoring - Identify consolidation opportunities
- Code review preparation - Comprehensive analysis before changes
- Documentation needs - Generate architecture docs
- Technical debt assessment - Quantify and prioritize improvements
- Onboarding new developers - Create codebase overview
- Pre-release audits - Quality and security review
Don't use for: Single file analysis, quick bug fixes, simple feature additions
Core Purpose
Comprehensive codebase analysis:
- Code Duplication - Find duplicate code for consolidation
- Architectural Analysis - Document system structure and patterns
- Refactoring Opportunities - Identify improvement areas
- Technical Debt Assessment - Quantify and prioritize debt
- Documentation Generation - Create architecture diagrams and docs
- Multi-Perspective Analysis - Review from architect, developer, product views
- Quality Metrics - Complexity, coverage, maintainability
Analysis Dimensions
| Dimension |
Focus |
| Code Duplication |
Find duplicate/similar code blocks |
| Architectural Structure |
System architecture and component relationships |
| Code Organization |
Module structure and separation of concerns |
| Refactoring Opportunities |
Large files, complex functions |
| Technical Debt |
TODOs, missing tests, outdated deps |
| Quality Metrics |
LOC, complexity, coverage |
| Design Patterns |
Patterns and anti-patterns in use |
| Cross-Cutting Concerns |
Error handling, logging, security |
See analysis-dimensions.md for detailed criteria.
Analysis Workflow
- Discovery - Project structure, file counts, configuration
- Dependency Analysis - cargo tree, outdated, audit
- Duplication Detection - Large files, tech debt markers
- Complexity Analysis - LOC statistics, long functions
- Architecture Mapping - Components, dependencies, data flow
- Quality Assessment - Coverage, linting, formatting
- Documentation Review - Doc generation, API documentation
- Synthesis - Comprehensive report with recommendations
Output Formats
- Executive Summary - Health score, key metrics, priorities
- Architecture Documentation - System diagram, patterns, data flows
- Refactoring Roadmap - Phased plan with tasks and estimates
- Technical Debt Report - Quantified debt, payoff strategy
- Onboarding Document - Developer guide to codebase
See report-templates.md for complete templates.
Best Practices
✓ Start with high-level structure, use automated tools, prioritize findings, provide concrete examples with file paths, estimate effort, consider multiple perspectives
✗ Don't analyze without clear goals, only report problems, provide generic advice, ignore context, recommend big rewrites, overwhelm with detail
See consolidation-patterns.md for refactoring patterns and examples.
1---2name: codebase-consolidation3description: Analyze, consolidate, and document codebases through multi-perspective analysis. Use when reviewing project structure, planning refactoring, creating documentation, or assessing technical debt.4---5
6# Codebase Consolidation & Analysis
7
8Systematically analyze codebases to identify consolidation opportunities, document architecture, and generate actionable insights.
9
10## Quick Reference
11
12- **[Analysis Dimensions](analysis-dimensions.md)** - 8 analysis dimensions with detailed criteria
13- **[Consolidation Patterns](consolidation-patterns.md)** - Common refactoring patterns with examples
14- **[Report Templates](report-templates.md)** - Output format templates
15
16## When to Use
17
18- Starting on a new codebase - Understand structure quickly
19- Planning refactoring - Identify consolidation opportunities
20- Code review preparation - Comprehensive analysis before changes
21- Documentation needs - Generate architecture docs
22- Technical debt assessment - Quantify and prioritize improvements
23- Onboarding new developers - Create codebase overview
24- Pre-release audits - Quality and security review
25
26**Don't use for**: Single file analysis, quick bug fixes, simple feature additions
27
28## Core Purpose
29
30Comprehensive codebase analysis:
31- **Code Duplication** - Find duplicate code for consolidation
32- **Architectural Analysis** - Document system structure and patterns
33- **Refactoring Opportunities** - Identify improvement areas
34- **Technical Debt Assessment** - Quantify and prioritize debt
35- **Documentation Generation** - Create architecture diagrams and docs
36- **Multi-Perspective Analysis** - Review from architect, developer, product views
37- **Quality Metrics** - Complexity, coverage, maintainability
38
39## Analysis Dimensions
40
41| Dimension | Focus |
42|-----------|-------|
43| Code Duplication | Find duplicate/similar code blocks |
44| Architectural Structure | System architecture and component relationships |
45| Code Organization | Module structure and separation of concerns |
46| Refactoring Opportunities | Large files, complex functions |
47| Technical Debt | TODOs, missing tests, outdated deps |
48| Quality Metrics | LOC, complexity, coverage |
49| Design Patterns | Patterns and anti-patterns in use |
50| Cross-Cutting Concerns | Error handling, logging, security |
51
52See **[analysis-dimensions.md](analysis-dimensions.md)** for detailed criteria.
53
54## Analysis Workflow
55
561. **Discovery** - Project structure, file counts, configuration
572. **Dependency Analysis** - cargo tree, outdated, audit
583. **Duplication Detection** - Large files, tech debt markers
594. **Complexity Analysis** - LOC statistics, long functions
605. **Architecture Mapping** - Components, dependencies, data flow
616. **Quality Assessment** - Coverage, linting, formatting
627. **Documentation Review** - Doc generation, API documentation
638. **Synthesis** - Comprehensive report with recommendations
64
65## Output Formats
66
67- **Executive Summary** - Health score, key metrics, priorities
68- **Architecture Documentation** - System diagram, patterns, data flows
69- **Refactoring Roadmap** - Phased plan with tasks and estimates
70- **Technical Debt Report** - Quantified debt, payoff strategy
71- **Onboarding Document** - Developer guide to codebase
72
73See **[report-templates.md](report-templates.md)** for complete templates.
74
75## Best Practices
76
77✓ Start with high-level structure, use automated tools, prioritize findings, provide concrete examples with file paths, estimate effort, consider multiple perspectives
78
79✗ Don't analyze without clear goals, only report problems, provide generic advice, ignore context, recommend big rewrites, overwhelm with detail
80
81See **[consolidation-patterns.md](consolidation-patterns.md)** for refactoring patterns and examples.
majiayu000