architecture-fit-check

Evaluate proposed change-set specs against repository architecture constraints.

4|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/shanepadgett/agent-extensions --skill architecture-fit-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-fit-check
Source: https://github.com/shanepadgett/agent-extensions/tree/main/skills/architecture-fit-check
Command: npx skills add https://github.com/shanepadgett/agent-extensions --skill architecture-fit-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This framework helps engineering teams determine if proposed change-set specs can be integrated within the current codebase architecture without requiring large-scale overhauls or paradigm shifts.

Core Features & Use Cases

  • Assess architectural compatibility of delta and feature-change proposals.
  • Identify boundary crossings, new interfaces, or required adapters early in the workflow.
  • Use case: before proposing a wide refactor, run this evaluation to decide if localized changes suffice.

Quick Start

Run an architecture-fit evaluation against the target repository and summarize any 1-2 actionable adjustments.

Frequently Asked Questions about architecture-fit-check

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

FAQPage Schema
How do I assess if a new feature fits my existing codebase architecture?

Assess codebase compatibility for delta changes by evaluating proposed change-set specs against the repository's existing architecture, constraints, and patterns to determine fit without large-scale overhauls. It identifies boundary crossings and required adapters early.

When do I need an architecture fit check for a codebase refactor?

You need an architecture fit check before proposing a wide refactor to decide if localized changes suffice. It evaluates whether proposed change-set specs require paradigm shifts or can be integrated within the current codebase architecture using existing adapters.

How do I evaluate dependency directions and entry points for a delta change proposal?

Evaluate dependency directions and entry points by analyzing the repository architecture to determine if delta and feature-change proposals cross module boundaries. This assessment identifies potential refactors and required new interfaces early in the workflow.

Can I check architectural compatibility for feature changes across multiple modules?

Yes, you can check architectural compatibility for feature-change proposals across modules. The assessment focuses on constraints, patterns, and potential refactors to ensure proposed change-set specs integrate with existing adapters and dependency directions.

What's the best way to identify boundary crossings before implementing a codebase change?

The best way to identify boundary crossings is running an architecture-fit evaluation against the target repository. This analysis of repo architecture and dependency directions summarizes actionable adjustments needed for the delta change specs.