architecture-lens

Assess architectural integrity, coupling, cohesion, and resilience in codebases.

30|1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/atomicinnovation/accelerator --skill architecture-lens
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-lens
Source: https://github.com/atomicinnovation/accelerator/tree/main/skills/review/lenses/architecture-lens
Command: npx skills add https://github.com/atomicinnovation/accelerator --skill architecture-lens

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured architect's perspective to find structural faults, unclear boundaries, and evolution blockers so teams can assess whether a design will sustain future change without hidden single points of failure.

Core Features & Use Cases

  • Structural integrity checks: Evaluate module and component boundaries, interface clarity, and separation of concerns.
  • Coupling, cohesion & dependency analysis: Trace dependency direction, flag circular dependencies, and identify inappropriate reliance on concretions.
  • Resilience and fault-tolerance review: Examine retry/backoff strategies, timeouts, graceful degradation, idempotency, and single points of failure.
  • Evolutionary fitness assessment: Determine how easily the design can adapt to likely future requirements and whether tradeoffs are acknowledged.
  • Use cases: Apply during plan reviews, architectural change proposals, pull request reviews, or post-incident assessments to produce actionable findings and confidence ratings.

Quick Start

Ask the review orchestrator to run the architecture-lens on the plan or code area you want evaluated.

Frequently Asked Questions about architecture-lens

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assess architectural integrity and find structural faults in my codebase?

Assess architectural integrity by evaluating module boundaries, interface clarity, and separation of concerns to identify structural faults and evolution blockers. This review reveals whether your system design can sustain future changes without hidden failures.

What is the best way to analyze coupling, cohesion, and circular dependencies in system design?

Analyze coupling and cohesion by tracing dependency directions, flagging circular dependencies, and identifying inappropriate reliance on concretions. This structural review ensures clear module boundaries and prevents dependencies that block system evolution.

How do I review code for resilience, fault tolerance, and single points of failure?

Review resilience by examining retry and backoff strategies, timeouts, graceful degradation, and idempotency to identify single points of failure. This fault-tolerance review highlights runtime failure scenarios and recommends mitigations for robust system design.

Can I evaluate evolutionary fitness and tradeoffs during an architectural change proposal?

Yes, you can evaluate evolutionary fitness during change proposals by determining how easily your design adapts to likely future requirements. The assessment evaluates whether tradeoffs are acknowledged and produces actionable findings with confidence ratings.

When do I need an architecture review for a pull request or post-incident assessment?

You need an architecture review during pull request evaluations and post-incident assessments when module boundaries, dependencies, and failure modes must be understood. It provides structured findings to ensure changes do not introduce structural faults or evolution blockers.