3b-solid-refactor-assistant

Plan SOLID refactors from SRP/DIP/ISP findings into reviewable patches.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/AgustinMadygraf/skills --skill 3b-solid-refactor-assistant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 3b-solid-refactor-assistant
Source: https://github.com/AgustinMadygraf/skills/tree/main/3b-solid-refactor-assistant
Command: npx skills add https://github.com/AgustinMadygraf/skills --skill 3b-solid-refactor-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The SOLID Refactor Assistant provides guided planning to resolve SRP/DIP/ISP findings without blind autofix, enabling safer, auditable refactors.

Core Features & Use Cases

  • Generate a batch refactor plan based on explicit findings from docs/todo.md.
  • Produce patch suggestions and plan artifacts to be reviewed before applying changes.
  • Works with repository-level scripts to drive deterministic refactors and verification.

Quick Start

Run the SOLID refactor plan generator to create a plan for your repository.

Frequently Asked Questions about 3b-solid-refactor-assistant

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

FAQPage Schema
How do I plan a SOLID refactor for Python code without breaking existing tests?

Plan SOLID refactors by generating a batched, reviewable plan from SRP, DIP, and ISP findings in docs/todo.md. This approach produces patch suggestions and plan artifacts that require explicit user action and post-refactor validation with existing tests.

What is the safest way to resolve SRP and DIP findings in Python projects?

Resolve SRP and DIP findings by generating auditable refactor plans with deterministic scripts. This mechanism prevents blind autofix by producing patch suggestions and artifacts for manual review before applying changes.

Can I use this guided refactor plan with my existing project audit notes?

Yes, the guided refactor plan works directly with audit notes stored in docs/todo.md. It reads explicit SRP, DIP, and ISP findings to generate a batched, reviewable refactor plan tailored to your Python repository.

Does the SOLID refactor process automatically apply code changes to my repository?

No, the SOLID refactor process does not automatically apply changes. It enforces explicit user action by generating patch suggestions and plan artifacts that you must review before applying them to your Python codebase.

What do I need to validate Python code after a planned SOLID refactor?

Validate Python code after a planned SOLID refactor by running existing tests. The process relies on deterministic scripts to drive refactors and requires post-refactor verification to ensure changes minimize risk.

Are there limitations to using batched patch planning for Python refactoring?

Batched patch planning for Python refactoring requires explicit findings in docs/todo.md and depends on existing tests for validation. It does not perform blind autofix, meaning you must manually review and apply generated patches.