review-architecture

Audit codebase architecture and report findings on modules, layers, and dependencies.

7|3|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/nesnilnehc/ai-cortex --skill review-architecture-nesnilnehc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-architecture
Source: https://github.com/nesnilnehc/ai-cortex/tree/main/skills/review-architecture
Command: npx skills add https://github.com/nesnilnehc/ai-cortex --skill review-architecture-nesnilnehc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies and communicates architectural issues in a codebase, focusing on module and layer boundaries, dependency direction, and interface stability to enable targeted improvements.

Core Features & Use Cases

  • Assess module and layer boundaries across API, domain, and data layers to ensure clear separation of concerns.
  • Analyze dependency direction to confirm inner stability and outer abstractions, preventing leakage of details.
  • Check for single-responsibility violations, cyclic dependencies, and brittle interfaces, surfacing concrete refactor points.
  • Produce actionable findings with precise locations and practical remediation suggestions, suitable for both focused reviews and system-wide audits.

Quick Start

Provide the code scope and ask the agent to run an architecture review to produce a structured findings list.

Frequently Asked Questions about review-architecture

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

FAQPage Schema
How do I review code architecture to fix cyclic dependencies and layer violations?

Reviewing code architecture involves auditing module boundaries, dependency direction, and interface stability to identify cyclic dependencies and layer violations. This process produces actionable findings with specific locations and concrete refactor suggestions to ensure clear separation of concerns.

What is the best way to check for single-responsibility violations in a codebase?

Checking for single-responsibility violations requires auditing module boundaries and coupling across API, domain, and data layers. An architecture review surfaces concrete refactor points by evaluating whether modules maintain focused responsibilities and stable interfaces without leaking implementation details.

Can I perform a focused architecture review on a specific module scope?

Yes, you can perform a focused architecture review by providing a specific code scope. The audit applies to individual modules, layers, dependencies, and interfaces, evaluating boundary integrity and dependency direction to produce targeted remediation suggestions for that exact scope.

How do I analyze dependency direction to ensure inner module stability?

Analyzing dependency direction confirms inner module stability and proper outer abstractions by auditing how layers interact. An architecture review identifies leaking implementation details and enforces correct dependency flow, ensuring inner layers remain stable and unaffected by outer changes.

Does an architectural code review provide specific locations for refactor suggestions?

Yes, an architectural code review provides actionable findings with precise locations and practical remediation suggestions. It evaluates interface stability, coupling, and module boundaries, outputting a structured list detailing exactly where and how to refactor problematic dependencies.