large-module-removal-refactor

Remove a large Python module and update code, docs, and tests.

21|1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/z3z1ma/agent-loom --skill large-module-removal-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: large-module-removal-refactor
Source: https://github.com/z3z1ma/agent-loom/tree/main/.opencode/skills/large-module-removal-refactor
Command: npx skills add https://github.com/z3z1ma/agent-loom --skill large-module-removal-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Removing a large module or package from a Python codebase while ensuring there are no dangling imports, broken entry points, or stale documentation; the goal is to converge code, docs, and tests without leaving dead paths.

Core Features & Use Cases

  • Identify the removal boundary
  • Remove code and immediately chase fallout
  • Update routing and wiring
  • Update tests and documentation in the same sweep
  • Validate with quality gates (unit tests, type checks, and linting)

Quick Start

Identify the module to remove, perform the controlled removal plan, and verify all references and tests are updated and passing.

Frequently Asked Questions about large-module-removal-refactor

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

FAQPage Schema
How do I safely remove a large Python module without breaking imports?

To safely remove a large Python module, you need to define the removal boundary, delete the code, and immediately chase fallout by updating routing, wiring, references, and tests. This ensures no dangling imports or broken entry points remain.

What is the best way to update tests and documentation when refactoring a Python codebase?

Updating tests and documentation during a Python codebase refactor should be done in the same sweep as the code deletion. This approach converges code, docs, and tests simultaneously, preventing stale documentation and dead paths.

How do I reconcile code and tests during a large module removal refactor?

Reconciling code and tests during a large module removal requires updating routing, wiring, and test suites immediately after deletion. You then validate the refactor using quality gates like unit tests, type checks, and linting.

Can I preserve existing behavior when deleting a large package from my Python codebase?

Yes, you can preserve behavior when deleting a large package by defining a strict removal boundary and updating all references and entry points. Validating with quality gates like unit tests and type checks ensures existing behavior remains intact.

What quality gates should I run after removing a large Python module?

After removing a large Python module, you should run quality gates including unit tests, type checks, and linting. These validation steps confirm that all reference updates, routing changes, and test modifications are passing correctly.

Why does deleting a Python package leave broken entry points and how do I fix them?

Deleting a Python package leaves broken entry points when routing and wiring are not updated. You fix them by identifying the removal boundary, deleting the code, and immediately chasing the fallout to update all imports and references.