Skip to main content
Generalmelodic-software

architecture-review

Review architecture of current codebase or staged changes

Stars
74
Source
melodic-software/claude-code-plugins
Updated
2026-04-07
Slug
melodic-software--claude-code-plugins--architecture-review
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/melodic-software/claude-code-plugins/HEAD/plugins/enterprise-architecture/skills/architecture-review/SKILL.md -o .claude/skills/architecture-review.md

Drops the SKILL.md into .claude/skills/architecture-review.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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

/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