What is the primary focus of the Architecture Review skill?

It focuses on module responsibilities, isolating side effects for testability, and ensuring a clean separation of concerns between frontend and backend logic.

How does it help with full-stack development?

It specifically checks if the frontend is taking on too much logic (like sorting or complex data manipulation) and suggests moving those responsibilities to the backend.

Can this skill help improve my unit testing?

Yes, by identifying side effects that should be moved to call-sites, it helps you create a 'functional core' that is much easier to test through pure functions.

Does this skill provide a full checklist of every file it reviews?

No, it follows a 'report-only-on-concern' approach. If no architectural issues are found, it will provide a single acknowledgement statement to reduce output noise.

Does it enforce the Single Responsibility Principle (SRP)?

Yes, one of its core focus areas is ensuring that each namespace or function has one clearly nameable responsibility.

Architecture Reviewer

Name: Architecture Reviewer
Author: eighttrigrams

byeighttrigrams

•

Collaboration Tools

Evaluates system design and code structure to ensure modularity, testability, and optimal logic distribution across the stack.

The Architecture Reviewer skill provides high-level guidance for assessing architectural changes and system design within Claude Code. It focuses on critical design principles such as the Single Responsibility Principle, the isolation of side effects to create a testable functional core, and the proper distribution of logic between frontend and backend layers. By employing a 'report-by-exception' methodology, it delivers concise, actionable feedback only when architectural concerns are detected, ensuring developers can focus on resolving structural debt without wading through noisy 'pass' reports.

Key Features

01Full-Stack Logic Balancing: Ensures frontend components remain 'dumb' by offloading processing and sorting to the backend.

02System Design Guidance: Evaluates overall application structure to ensure long-term maintainability and scalability.

03Module Responsibility Analysis: Validates that every namespace and function has a single, clearly defined purpose.

04Functional Core Assessment: Identifies opportunities to isolate side effects for improved unit testing and reliability.

05Exception-Only Reporting: Minimizes review noise by only flagging problematic patterns and structural concerns.

064 GitHub stars

Use Cases

01Reviewing complex pull requests for architectural regressions and design pattern violations.

02Refactoring monolithic functions into modular, single-responsibility namespaces.

03Optimizing full-stack application performance by shifting data logic from the UI to the API layer.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add eighttrigrams/claude-stuff architecture-review

For use in Claude.ai and ChatGPT

Download Skill