team-tech-debt

What problem does it solve?

Systematically discovers, prioritizes, plans, executes, and validates technical debt remediation across a codebase so teams can reduce risk and maintenance cost with minimal manual coordination.

Core Features & Use Cases

• End-to-end governance: Orchestrates scan → assess → plan → fix → validate phases with a coordinator and team-worker agents.
• Role-based workers: Uses scanner, assessor, planner, executor, and validator roles to parallelize work and maintain clear ownership.
• Safe worktrees & GC loop: Creates isolated git worktrees for fixes, runs validation checks, and supports fix-verify GC loops with rollback/accept policies.
• Use Case: Run a repo-wide audit to generate a prioritized remediation plan, spawn workers to implement quick wins in a worktree, and validate changes before opening a PR.

Quick Start

Run the team-tech-debt skill to scan this repository for technical debt, produce a prioritized remediation plan, and prepare a fix worktree for execution.