/code-analysis - Deep Code Analysis

Perform comprehensive code analysis for quality, complexity, and maintainability.

Usage

/code-analysis [target] [focus]

Arguments:

• target - File or directory to analyze
• focus - (optional) Focus: quality, complexity, maintainability, all

Examples

/code-analysis src/services/
/code-analysis src/utils/helpers.ts complexity
/code-analysis src/components/ maintainability
/code-analysis src/ all

What It Does

1. Analyzes code across multiple dimensions:

   • Quality: Code standards, best practices, anti-patterns
   • Complexity: Cyclomatic complexity, cognitive complexity
   • Maintainability: Readability, documentation, modularity
   • Test coverage: Missing tests, untested paths

2. Generates metrics:

   • Lines of code (LOC)
   • Complexity scores
   • Duplication percentage
   • Dependency count
   • Maintainability index

Output Format

## Code Analysis: {target}

### Summary
| Metric | Value | Status |
|--------|-------|--------|
| Quality Score | X/10 | {status} |
| Avg Complexity | X | {status} |
| Maintainability | X/10 | {status} |
| Duplication | X% | {status} |

### Quality Issues

#### Critical
- **[file.ts:123]** {issue}
  - Impact: {why it matters}
  - Fix: {recommendation}

#### Warnings
- {issue list}

### Complexity Hotspots

| File | Function | Complexity | Recommendation |
|------|----------|------------|----------------|
| {file} | {func} | {score} | {action} |

### Maintainability Concerns
1. **{area}** - {issue and recommendation}

### Duplication
- {X} duplicate blocks found
- Largest: {description}
- Recommendation: {extract to shared utility}

### Recommendations
1. {Priority 1}
2. {Priority 2}
3. {Priority 3}

### Technical Debt Estimate
- **Current debt:** {estimate}
- **Recommended cleanup time:** {hours}

Skill Used

skills/analysis/code/

When to Use Agent Instead

Use the Senior Developer agent when:

• Analysis is part of a refactoring effort
• Code review with mentoring is needed
• Implementation of fixes is required