architecture-review

Compare code changes against layering rules and pattern constraints.

3|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/marcus-friction/agents --skill architecture-review-marcus-friction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/marcus-friction/agents/tree/main/.agent/skills/architecture-review
Command: npx skills add https://github.com/marcus-friction/agents --skill architecture-review-marcus-friction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture guidance during code review to ensure changes align with defined patterns, reducing architectural drift and rework later.

Core Features & Use Cases

  • Enforces layer separation across Controllers, Actions, Models, Requests, and Services.
  • Checks API design, dependency direction, and frontend-backend boundaries to prevent cross-layer leakage.
  • Helps reviewers quickly identify architectural deviations and maintain consistency across the codebase.

Quick Start

Run the architecture review pass on a code change to verify alignment with project patterns.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I check if code changes align with Laravel and Nuxt project architecture?

Architecture review checks code changes against defined layering rules and pattern constraints across Controllers, Actions, Models, Requests, and Services. It validates API routes, resources, and frontend proxies to ensure separation of concerns and proper dependency flow.

What is architectural drift and how does a code review prevent it?

Architectural drift happens when incremental code changes deviate from established design patterns. An architecture review identifies these deviations during code review by enforcing layer separation and checking dependency direction, reducing rework and maintaining consistency across the codebase.

How do I prevent cross-layer leakage between my backend Actions and frontend proxies?

Prevent cross-layer leakage by applying an architecture review pass that checks API design and frontend-backend boundaries. It verifies that dependency direction adheres to project guidelines, ensuring Actions and proxies remain properly separated.

Does this architecture review work with projects outside of Laravel and Nuxt?

This architecture review is specifically designed for Laravel and Nuxt projects. It applies layering rules to components like Controllers, Actions, Models, Requests, and Services, checking API routes and frontend proxies unique to this stack.

Can I use this to review separation of concerns in my API routes and resources?

Yes, you can review separation of concerns in API routes and resources by running an architecture review pass. It validates that these components adhere to project architectural guidelines and coding standards, preventing improper dependency flow.

What's the best way to enforce layer separation across Controllers, Models, and Services?

The best way to enforce layer separation is running an architecture review pass on code changes. It compares modifications against defined pattern constraints for Controllers, Models, and Services, quickly identifying architectural deviations and maintaining codebase consistency.