Codebase Health Check Analyzer

# Codebase Health Check Analyzer

## Problem Context

Engineering teams need to assess the overall health of their codebase systematically. A comprehensive health check helps identify issues across multiple dimensions: code quality, performance, security, error handling, dependencies, and structural organization. Without a structured approach, teams may miss critical issues or prioritize incorrectly.

## Solution Pattern: Structured Analysis Pattern

The Structured Analysis Pattern breaks down complex analysis into systematic steps. Each step focuses on a specific dimension (logic, performance, security, etc.), ensuring comprehensive coverage while maintaining clarity and actionability.

## Prompt Template



When analyzing codebase health:

### Step 1: File Collection
- Scan for source code files (.ts, .tsx, .js, .jsx, .css, etc.)
- Exclude documentation files (.md, etc.)
- Build complete file list for review

### Step 2: Per-File Analysis
For each source file:
- Check logical flow and correctness
- Evaluate performance characteristics
- Scan for security issues
- Review error handling patterns
- Assess dependency usage
- Examine code structure

### Step 3: Issue Categories
Track findings under:
- Logic Issues
  - Control flow problems
  - Data handling errors
  - State management flaws
  
- Performance Issues
  - Resource inefficiencies
  - Unnecessary operations
  - Memory management
  
- Security Issues
  - Input validation
  - Data exposure
  - Authentication/authorization
  
- Error Handling
  - Missing try/catch blocks
  - Uncaught exceptions
  - Error propagation
  
- Dependencies
  - Deprecated packages
  - Version conflicts
  - Unused imports
  
- Structure
  - Code organization
  - Component coupling
  - Pattern consistency

### Step 4: Generate Report in below format:

Codebase Health Analysis
Files Reviewed
[List of analyzed files]

Critical Issues
[Priority findings requiring immediate attention]

Issue Details
[Categorized findings with file locations and recommendations]

Summary
[Overall health assessment and next steps]

## Example Use Case

**Scenario**: A team inherits a legacy codebase and needs to assess its health before planning refactoring work.

**Process**:
1. Run the codebase health check analyzer
2. Review findings across all categories (logic, performance, security, etc.)
3. Prioritize issues based on impact and effort
4. Create a refactoring roadmap

**Result**: Clear understanding of codebase health, prioritized action items, and a data-driven refactoring plan.

---

*This prompt is part of the Engify.ai research-based prompt library. Customize it for your specific context and needs.*