architecture-reviewer

Review TypeScript proposals for Clean Architecture layer boundaries and dependency direction.

241|51|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/shep-ai/cli --skill architecture-reviewer-shep-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-reviewer
Source: https://github.com/shep-ai/cli/tree/main/.claude/skills/architecture-reviewer
Command: npx skills add https://github.com/shep-ai/cli --skill architecture-reviewer-shep-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides architecture review and guidance to ensure proposals align with Clean Architecture principles, guiding decisions on where code should live, how components interact, and how to maintain layer boundaries.

Core Features & Use Cases

  • Design Decisions: Recommend module and layer placement for new features.
  • Pattern Compliance: Validate adherence to project style and architecture patterns.
  • Dependency Direction: Enforce inward dependencies (presentation → application → domain).
  • Interface Design: Advise on port/adapter boundaries and abstractions.
  • TypeSpec Models: Check consistency with tsp/ domain models.

Quick Start

Ask the reviewer to assess an architectural proposal and provide placement, boundaries, and interface guidance.

Frequently Asked Questions about architecture-reviewer

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

FAQPage Schema
How do I enforce clean architecture layer boundaries in a TypeScript project?

To enforce clean architecture boundaries, ensure inward dependencies flow from presentation to application to domain. This Skill reviews TypeScript proposals to verify layer separation and prevent domain logic from leaking into infrastructure or presentation layers.

What is the correct way to design ports and adapters for a new feature?

Designing ports and adapters requires defining clear abstractions at layer boundaries. This Skill analyzes architectural proposals to advise on interface placement and ensure external infrastructure integrates smoothly through adapter implementations without violating domain isolation.

Can I use this to check TypeSpec model consistency in my tsp directory?

Yes, you can use this to check TypeSpec model consistency. During design reviews, this Skill evaluates architectural alignment by referencing TypeSpec models located in the tsp directory to ensure domain definitions match proposed structural changes.

Does this architecture reviewer work for domain-driven design reviews?

Yes, this architecture reviewer works for domain-driven design reviews. It provides targeted guidance to align proposals with Clean Architecture principles across domain, application, infrastructure, and presentation layers in TypeScript projects.

How do I validate dependency direction during a pull request check?

To validate dependency direction during a pull request check, assess whether changes maintain the inward dependency rule. This Skill evaluates PRs to ensure presentation depends on application, which depends on domain, rejecting outward dependency violations.