architecture-review-lens

Solid

Use when a diff may break system boundaries, dependency direction, or cross-service contracts — fifth judge dispatched by /review-changes alongside the four standard judges.

AI & Automation 10 stars 1 forks Updated today MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
35
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# architecture-review-lens > Fifth judge in the `/review-changes` family. Reviews a diff for > **architectural fit**, not correctness, security, tests, or style. > Catches what the other four miss: layer violations, wrong > dependency direction, leaking abstractions, and broken cross-service > contracts. Sibling of [`judge-bug-hunter`](../judge-bug-hunter/SKILL.md) > et al. — never overlaps. ## When to use - `/review-changes` dispatches its "architecture" slice to this skill. - A reviewer asks "does this belong here?", "should this be in the domain layer?", or "is this leaking storage details?". - A diff adds a cross-service call, event, or contract. Do NOT use when: - The diff is documentation-only or a formatting-only change. - The concern is correctness — route to [`judge-bug-hunter`](../judge-bug-hunter/SKILL.md). - The concern is security — route to [`judge-security-auditor`](../judge-security-auditor/SKILL.md). - The concern is naming or DRY — route to [`judge-code-quality`](../judge-code-quality/SKILL.md). - The concern is *whether to make* the architectural change — route to [`decision-record`](../decision-record/SKILL.md) first. ## Procedure ### 1. Anchor on the system shape Read the codebase's stated architecture (ADRs, AGENTS.md, module docs). If no shape is documented, infer it from folder structure and surface the gap. You are judging the diff against **the stated shape**, not a fantasy ideal. ### 2. Inspect each changed file for fit For every...

Details

Author
event4u-app
Repository
event4u-app/agent-config
Created
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

judge-arch

Architectural critic and the review half of a blocking architecture gate. Use before calling any non-trivial code or schema change done, before opening a pull request, or when asked to review a diff, branch, or area of an application for architectural drift. Reviews the change in a fresh context against the repository's decisions.md and the four questions — boundary placement, data ownership, dependency direction, error handling — plus a grep-test for leaked web or UI concerns in domain code. Reports each violation with where it lives, what breaks if ignored, and the smallest fix. Findings only — it never edits code, and it returns PASS and stops when nothing is wrong rather than inventing problems.

0 Updated 1 weeks ago
techfleetworks
Code & Development Listed

architecture-review

Review a set of pending changes (or a given diff/PR) for architectural consistency with the rest of this repository — layering, module boundaries, naming, and dependency direction. Use when asked to review architecture, check consistency, or before merging a non-trivial change.

0 Updated yesterday
ferronicardoso
Code & Development Listed

architecture-review

A focused, single-lens review of a change's design and structure — not its defects. Judges separation of concerns and SOLID, coupling and cohesion, module/layer boundaries and dependency direction, whether the right abstraction is present (and the wrong/early one is absent), files and functions that have grown too large or do too much, leaky abstractions, intent-hiding names, duplication that wants to be a shared unit, and whether the change fits how this codebase is already built. Every finding cites file/module:line, a severity, the future cost it imposes, and a concrete refactor direction. Constructive and pragmatic — flags structure that will cost future change, never taste.

0 Updated today
itzikiusa