# Architecture Review

> Review architecture of current codebase or staged changes Use when this capability is needed.

- Skill: `tomevault-io/architecture-review-5` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/architecture-review-5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/architecture-review-5/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/architecture-review-5

---


# Architecture Review

Perform comprehensive architecture review including viewpoint analysis and principles validation.

## Arguments

`$ARGUMENTS` - Scope of review:

- Specific file paths or patterns
- `staged` - Review staged git changes
- (empty) - Review entire codebase

## Workflow

1. **Spawn parallel analysis agents**:
   - **viewpoint-analyzer** - Analyze from multiple stakeholder perspectives
   - **principles-validator** - Check alignment with architecture principles

2. **viewpoint-analyzer will**:
   - Identify relevant Zachman perspectives
   - Analyze from each applicable viewpoint
   - Note limitations for rows 1-3 (require human input)

3. **principles-validator will**:
   - Load architecture principles (from `/architecture/principles.md` or memory)
   - Check specified files/changes against each principle
   - Report violations with severity (critical, warning, info)
   - Link violations to relevant ADRs

4. **Aggregate results** into comprehensive review report

## Example Usage

```bash
/ea:architecture-review
/ea:architecture-review staged
/ea:architecture-review src/api/
/ea:architecture-review src/auth/*.ts
```

## Output

Comprehensive architecture review report including:

- Viewpoint analysis results
- Principles compliance status
- Violations with severity and remediation suggestions
- Links to relevant ADRs

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/melodic-software) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->