team-tech-debt

Scan codebases, assess severity, plan remediation, and execute fixes.

511|63|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill team-tech-debt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-tech-debt
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.claude/skills/team-tech-debt
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill team-tech-debt

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about team-tech-debt

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

FAQPage Schema
How do I automate technical debt remediation across multiple repositories?

Technical debt remediation across single or multi-repo codebases is automated by orchestrating scan, assess, plan, fix, and validate phases using a coordinator and team-worker agent architecture. This systematically reduces risk and maintenance cost with minimal manual coordination.

How can I scan my codebase and generate a prioritized remediation plan?

Scanning a codebase to generate a prioritized remediation plan involves running a coordinator agent that delegates tasks to role-based workers like scanners and assessors. These agents evaluate code quality, assess severity, and produce a phased remediation plan.

Can I run automated code fixes in isolated git worktrees and validate changes before merging?

Automated code fixes run in isolated session git worktrees where executor workers implement changes and validator workers run checks. This supports a fix-verify loop with rollback and accept policies to validate changes safely before opening a pull request.

Does multi-agent orchestration work for parallelizing code quality tasks?

Multi-agent orchestration works for parallelizing code quality tasks by assigning distinct roles like scanner, assessor, planner, executor, and validator to different team-worker agents. This architecture maintains clear ownership and coordinates the workflow via TaskCreate and TaskUpdate APIs.

What is the best way to track the lifecycle of automated tech-debt fixes?

Tracking the lifecycle of automated tech-debt fixes is best handled through a coordinator architecture using TaskCreate and TaskUpdate APIs. This manages the end-to-end governance from initial scan to final validation, ensuring every remediation step is logged and visible.

What do I need to set up before automating tech-debt discovery and remediation?

Automating tech-debt discovery and remediation requires repository read and write access along with agent and task APIs. These permissions allow the multi-agent system to create worktrees, execute fixes, and update remediation statuses across the codebase.