Tech Lead Architecture Review

Output format

# Architecture Review: <Project Name>

## Executive Summary

<2–3 sentences: overall health, biggest risks, key recommendations.>

## Current Architecture

<Brief description of the architecture: style, major components, data stores, integrations.>

## Quality Attribute Assessment

| Attribute | Rating | Findings |
|---|---|---|
| Maintainability | 🟢🟡🔴 | <key findings> |
| Reliability | 🟢🟡🔴 | <key findings> |
| Performance | 🟢🟡🔴 | <key findings> |
| Security | 🟢🟡🔴 | <key findings> |
| Scalability | 🟢🟡🔴 | <key findings> |
| Testability | 🟢🟡🔴 | <key findings> |

## Findings

### Critical

- **<Finding title>**: <description, evidence, impact>

### High

- **<Finding title>**: <description, evidence, impact>

### Medium

- **<Finding title>**: <description, evidence, impact>

### Low

- **<Finding title>**: <description, evidence, impact>

## Technical Debt Summary

| Category | Items | Interest Level |
|---|---|---|
| Code debt | <count> | High/Medium/Low |
| Design debt | <count> | High/Medium/Low |
| Architecture debt | <count> | High/Medium/Low |
| Test debt | <count> | High/Medium/Low |
| Dependency debt | <count> | High/Medium/Low |

## Recommendations

| # | Recommendation | Severity | Effort | Impact |
|---|---|---|---|---|
| 1 | <actionable recommendation> | Critical/High/Medium | S/M/L | <expected improvement> |
| 2 | <actionable recommendation> | High | S/M/L | <expected improvement> |

## Risks

- <Risk that needs monitoring or mitigation>

## References

- <Links to ADRs, docs, tools used for analysis>

Rules

• Findings must include evidence — "module X has cyclomatic complexity of 45" not "code is complex"
• Every finding must have a recommendation — observations without actions are not useful
• Rate quality attributes honestly — green/yellow/red with evidence
• Sort recommendations by impact — highest impact first
• Keep executive summary to 3 sentences max — busy stakeholders read only this
• This is an assessment, not a rewrite proposal — recommend incremental improvements