my-arch-review

Evaluate coupling, cohesion, module boundaries, and dependency direction in code changes.

4|1|Updated May 31, 2015
One-click install
npx skills add https://github.com/samcdavid/dotfiles --skill my-arch-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: my-arch-review
Source: https://github.com/samcdavid/dotfiles/tree/main/claude/skills/my-arch-review
Command: npx skills add https://github.com/samcdavid/dotfiles --skill my-arch-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture reviews help teams assess whether a change aligns with system conventions, boundaries, and long-term maintainability, preventing design drift.

Core Features & Use Cases

  • Evaluate coupling, cohesion, module boundaries, and dependency direction.
  • Map architectural risks for PRs, features, or codebase areas.
  • Provide actionable feedback to improve future changes.

Quick Start

Review the requested change for architectural alignment and surface any boundary violations.

Frequently Asked Questions about my-arch-review

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

FAQPage Schema
How do I review code changes for architectural alignment and boundary violations?

You review code changes for architectural alignment by evaluating coupling, cohesion, module boundaries, and dependency direction to identify structural risks and prevent design drift. This process maps architectural impacts across PRs or feature areas to guide maintainability.

What is an architecture review and when do I need one for my codebase?

An architecture review assesses whether a change aligns with system conventions and long-term maintainability. You need an architecture review when modifying PRs, files, or feature areas to ensure the changes do not violate established module boundaries or introduce design drift.

How do I assess coupling and cohesion in a pull request?

You assess coupling and cohesion in a pull request by examining dependency direction and module boundaries within the changed files. This evaluation identifies whether the modifications align with the existing system structure or introduce architectural risks that impact future changes.

Can I use an architecture review for feature-area assessments instead of just PRs?

Yes, you can apply an architecture review to feature-area assessments, individual files, or PRs. The review determines the impact of changes on system structure by evaluating module boundaries and dependency direction to provide actionable feedback for future improvements.

What is the best way to prevent design drift in software engineering?

The best way to prevent design drift is conducting regular architecture reviews that map structural risks and boundary violations. By evaluating dependency direction and modularization before merging changes, teams maintain system conventions and ensure long-term maintainability.

Why does high coupling make future code changes harder to maintain?

High coupling makes future code changes harder because it obscures module boundaries and increases the impact of modifications across the system. Architecture reviews identify these dependency issues to provide actionable feedback that improves maintainability and guides future structural changes.