Claude Code Plugins

Community-maintained marketplace

Feedback

architecture-review

@athola/claude-night-market
10
0

Evaluate codebase architecture against ADRs, coupling rules, and team guardrails.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name architecture-review
description Evaluate codebase architecture against ADRs, coupling rules, and team guardrails.
category architecture
tags architecture, design, adr, coupling, patterns, principles
tools adr-auditor, coupling-analyzer, principle-checker
usage_patterns architecture-assessment, adr-audit, refactor-review, design-validation
complexity advanced
estimated_tokens 300
progressive_loading true
dependencies pensive:shared, imbue:evidence-logging, imbue:diff-analysis/modules/risk-assessment-framework
modules modules/adr-audit.md, modules/coupling-analysis.md, modules/principle-checks.md

Architecture Review Workflow

Architecture assessment against ADRs and design principles.

Quick Start

/architecture-review

When to Use

  • Before approving reimplementations.
  • Large-scale refactoring reviews.
  • System design changes.
  • New module/service introduction.
  • Dependency restructuring.

Progressive Loading

Load modules based on review scope:

  • modules/adr-audit.md (~400 tokens): ADR verification and documentation.
  • modules/coupling-analysis.md (~450 tokens): Dependency analysis and boundary violations.
  • modules/principle-checks.md (~500 tokens): Code quality, security, and performance.

Load all modules for full reviews. For focused reviews, load only relevant modules.

Required TodoWrite Items

  1. arch-review:context-established: Repository, branch, motivation.
  2. arch-review:adr-audit: ADR verification and new ADR needs.
  3. arch-review:interaction-mapping: Module coupling analysis.
  4. arch-review:principle-checks: LoD, security, performance.
  5. arch-review:risks-actions: Recommendation and follow-ups.

Workflow

Step 1: Establish Context (arch-review:context-established)

Confirm repository and branch:

pwd
git status -sb

Document:

  • Feature/bug/epic motivating review.
  • Affected subsystems.
  • Architectural intent from README/docs.
  • Design trade-off assumptions.

Step 2: ADR Audit (arch-review:adr-audit)

Load: modules/adr-audit.md

  • Locate ADRs in project.
  • Verify required sections.
  • Check status flow.
  • Confirm immutability compliance.
  • Flag need for new ADRs.

Step 3: Interaction Mapping (arch-review:interaction-mapping)

Load: modules/coupling-analysis.md

  • Diagram before/after module interactions.
  • Verify composition boundaries.
  • Check data ownership clarity.
  • Validate dependency flow direction.
  • Identify coupling violations.

Step 4: Principle Checks (arch-review:principle-checks)

Load: modules/principle-checks.md

  • Law of Demeter.
  • Anti-slop patterns.
  • Security (input validation, least privilege).
  • Performance (N+1 queries, caching).

Step 5: Risks and Actions (arch-review:risks-actions)

Summarize using imbue:diff-analysis/modules/risk-assessment-framework:

  • Current vs proposed architecture.
  • Business impact.
  • Technical debt implications.

List follow-ups with owners and dates.

Provide recommendation:

  • Approve: Architecture sound.
  • Approve with actions: Minor issues to address.
  • Block: Fundamental problems requiring redesign.

Architecture Principles Checklist

Coupling

  • Dependencies follow defined boundaries.
  • No circular dependencies.
  • Extension points used properly.
  • Abstractions don't leak.

Cohesion

  • Related functionality grouped.
  • Single responsibility per module.
  • Clear module purposes.

Layering

  • Layers have clear responsibilities.
  • Dependencies flow downward.
  • No layer bypassing.

Evolution

  • Changes are reversible.
  • Migration paths are clear.
  • ADRs document decisions.