huangjia2019/claude-code-engineering/code-health-check

Code Health Check

Analyze the codebase at $ARGUMENTS and produce a structured health report.

Checks to Perform

1. File Organization

• Are files reasonably sized? (Flag files > 200 lines)
• Is the directory structure logical?
• Any files that look misplaced?

2. Error Handling

• Are async operations wrapped in try/catch?
• Are errors propagated correctly (not swallowed)?
• Is there a global error handler?

3. Security Basics

• Any hardcoded secrets, API keys, or passwords?
• Any use of eval() or similar dangerous functions?
• Are user inputs validated before use?

4. Code Quality

• Any obvious code duplication (similar blocks in multiple files)?
• Any unused variables or imports?
• Are function signatures reasonable (not too many parameters)?

5. Dependency Hygiene

• Are all imported modules actually used?
• Any circular dependencies?

Severity Levels

Use these to categorize issues:

Output Format

Return a structured report in this exact format:

# Code Health Report: {directory}
 
## Overall Score: {A/B/C/D/F}
 
## Summary
-Files analyzed: {count}
-Issues found: {critical} critical, {warning} warnings, {info} info
 
## Critical Issues
{list each with file:line and description}
 
## Warnings
{list each with file:line and description}
 
## Info
{list each with file:line and description}
 
## Recommendations
{top 3 actionable recommendations}