skills.rest
AgustinMadygraf
AgustinMadygrafCOMMUNITY
Explore all skills by this author →
GitHub

2b-architecture-refactor-assistant

Plan architecture refactors for legacy Python Clean Architecture projects.

Updated Mar 22, 2026
Search Tags:#planning#architecture#python#refactor#layer-boundary#gateways
One-click install
npx skills add https://github.com/AgustinMadygraf/skills --skill 2b-architecture-refactor-assistant
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 2b-architecture-refactor-assistant
Source: https://github.com/AgustinMadygraf/skills/tree/main/2b-architecture-refactor-assistant
Command: npx skills add https://github.com/AgustinMadygraf/skills --skill 2b-architecture-refactor-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Plans and coordinates architectural refactors for layered software architectures, helping teams map changes and reduce risk during transitions.

Core Features & Use Cases

  • Guided refactor planning across layer boundaries (entities, use cases, gateways, controllers, presenters, infrastructure)
  • Output migration plans, patch templates, and checklists to drive safe implementation
  • Use cases include transforming legacy architectures to better modularity and enforce port/adapter boundaries

Quick Start

Run the migration plan workflow against your repository root to generate a structured refactor plan.

Frequently Asked Questions about 2b-architecture-refactor-assistant

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

FAQPage Schema
How do I plan an incremental architecture refactor for a legacy Python project?▼

Architecture refactor planning is guided by mapping safe, incremental changes across layer boundaries to generate structured migration batches and validation checklists for legacy Python projects.

How do I enforce layer boundaries when refactoring to Clean Architecture?▼

Layer boundaries are enforced by guiding tasks across entities, use cases, gateways, controllers, presenters, and infrastructure to output concrete change plans that maintain port and adapter separation.

Can I generate migration batches and patch templates for structured refactor work?▼

Migration batches and patch templates are generated by running the migration plan workflow against a repository root to produce concrete change plans and risk-controlled transition steps.

Does this guided refactor planning work with ports and adapters in Python?▼

Ports and adapters are supported by enforcing layer boundaries within legacy Python projects following Clean Architecture, enabling structured refactor work and risk-controlled transitions.

What are the limitations of guided architectural refactor planning?▼

Guided architectural refactor planning is deprecated and focuses on planning and coordinating changes for layered software architectures, outputting migration plans rather than executing code modifications directly.

Related Skills

Explore More Software Engineering Skills→
lasswelltlasswellt
1

codebase-map

Analyze a codebase across technology, architecture, quality, and concerns to generate CODEBASE-MAP.md.

Community
Advanced
theodrosyimertheodrosyimer

refactor

Refactor TypeScript code with incremental changes while keeping tests green.

Community
Intermediate
AgustinMadygrafAgustinMadygraf

2a-layer-boundary-gate

Detect prohibited imports between Clean Architecture layers using AST analysis.

Community
Intermediate
thomasslobodathomassloboda

hexagonal-migration-planning

Analyze partially migrated codebases to generate Jira-ready migration tasks.

Community
Intermediate