Skills
.Work. You
Rest

mp-architecture-review

Community

Turn architecture friction into actionable refactor RFCs

Software Engineering#refactoring#test strategy#interface design#architecture review#ports and adapters#deep modules#github rfc
AuthorMartinoPolo
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It helps you identify architectural friction in a codebase and convert that friction into concrete, testable refactor proposals you can implement as GitHub RFC issues.

Core Features & Use Cases

  • Deep-module refactor guidance: Surfaces places where the interface is shallow, tightly coupled, or hard to test, then frames deepening opportunities.
  • Dependency-category-based planning: Classifies dependencies (in-process, local-substitutable, ports & adapters, true external) to drive the right refactor/testing strategy.
  • Boundary-focused testing impact: Replaces brittle shallow-module tests with interface-boundary tests to make refactors safer and more maintainable.
  • RFC issue creation: Produces an issue body using the repository’s RFC template so the plan is ready for implementation.

Quick Start

Use the mp-architecture-review skill to review architecture, propose deepening candidates, and generate a refactor RFC issue from the friction you find.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: mp-architecture-review
Download link: https://github.com/MartinoPolo/mpx-claude-code/archive/main.zip#mp-architecture-review

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.