skills.rest
fsolla
fsollaCOMMUNITY
Explore all skills by this author →
Website𝕏@franciscosollaGitHub

remove-technical-debt

Orchestrate an eight-phase refactoring process to reduce technical debt in legacy codebases.

Updated Jul 31, 2026
Search Tags:#testing#architecture#refactoring#clean-code#legacy-code#technical-debt
One-click install
npx skills add https://github.com/fsolla/teqo --skill remove-technical-debt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: remove-technical-debt
Source: https://github.com/fsolla/teqo/tree/main/.agents/skills/remove-technical-debt
Command: npx skills add https://github.com/fsolla/teqo --skill remove-technical-debt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the paralysis of working with large, aged, and tangled codebases that teams are afraid to touch, preventing the common failure mode of attempting a high-risk, big-bang rewrite.

Core Features & Use Cases

  • Incremental Paydown: Orchestrates an eight-phase journey to improve code quality, architecture, and reliability in place while the system continues to ship.
  • Safety-First Methodology: Enforces the creation of a safety net through characterization tests before any structural changes are made.
  • Resumable Planning: Records every decision and phase status in project documentation, allowing teams to pause and resume the debt-reduction journey across multiple sessions.

Quick Start

Invoke the remove-technical-debt skill to begin the intake process and create a technical debt plan for your current codebase.

Frequently Asked Questions about remove-technical-debt

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

FAQPage Schema
How do I reduce technical debt in a legacy codebase without a complete rewrite?▼

To reduce technical debt without a rewrite, you can apply an incremental refactoring process that systematically improves maintainability and architectural boundaries while the system continues to ship to production.

What is the safest way to start refactoring tangled legacy code?▼

The safest way to start refactoring legacy code is to first establish a safety net by creating characterization tests, ensuring you capture existing behavior before making any structural changes.

How do I track technical debt paydown progress across multiple sessions?▼

You can track technical debt paydown across sessions by recording every decision and phase status in standardized project documentation artifacts, allowing teams to pause and resume the incremental journey.

Can I improve architectural boundaries in production without disrupting delivery?▼

Yes, you can improve architectural boundaries in production without disrupting delivery by orchestrating a multi-phase refactoring process that applies dependency inversion and clean code techniques incrementally.

When should I avoid a big-bang rewrite of an aged codebase?▼

You should avoid a big-bang rewrite of an aged codebase when teams are afraid to touch the tangled system, opting instead for an incremental paydown journey that improves code quality in place.

Does incremental refactoring work for complex software systems requiring improved test coverage?▼

Yes, incremental refactoring works for complex software systems by orchestrating a structured eight-phase journey designed to systematically improve test coverage, architecture, and reliability.

Related Skills

Explore More Software Engineering Skills→
k1lgork1lgor
2

legacy-archaeologist

Analyze legacy codebases to map entry points, data flows, and dependencies.

Community
Advanced
manolakismanolakis

code-quality

Reviews code files against Clean Code, SOLID, and Object Calisthenics principles.

Community
Intermediate
yslee5005yslee5005

moai-workflow-ddd

Refactor legacy code while preserving behavior using an ANALYZE-PRESERVE-IMPROVE cycle.

Community
Advanced
voidrotvoidrot

python-code-style

Format and lint Python source code with Black, Ruff, isort, and mypy.

Community
Advanced