Skip to main content
affpapa.org
RU EN
subagent GitHub Copilot official · GitHub

Technical Debt Remediation Plan — GitHub Copilot Subagent

Generates actionable technical debt remediation plans for code and test suites. It helps teams audit accumulated debt without modifying project files.

Install into GitHub Copilot · Manually: put the files in place All methods and platforms ↓ 
.github/agents/tech-debt-remediation-plan.agent.md
Open on GitHub

What Technical Debt Remediation Plan does

This subagent works in analysis-only mode. It flags unmaintainable code structures, missing test coverage, deprecated APIs, and lingering TODO comments. The output is a markdown report containing an overview, remediation requirements, ordered action items, and verification methods.

Every finding is scored on a 1-to-5 scale. The subagent assesses remediation difficulty alongside the impact on quality. Inaction risk is rated separately with color indicators. When managing work, it checks existing tickets using search_issues and formats tasks with /.github/ISSUE_TEMPLATE/chore_request.yml.

Keep this tool for refactoring planning sessions. Skip it if you need an agent to rewrite code directly.

What it helps with

  • audit deprecated dependencies and outdated documentation
  • score codebase risks and remediation effort on a 1-to-5 scale
  • generate issue descriptions via chore_request.yml templates
  • outline step-by-step verification methods for test coverage gaps

Example prompts for the agent

  • Generate a technical debt remediation plan for our payment service.
  • Analyze all TODO and FIXME comments and score their impact.
  • Create remediation steps for outdated dependencies and check existing issues.

How to install Technical Debt Remediation Plan

Manually: put the files in place

.github/agents/tech-debt-remediation-plan.agent.md

From the same set554

The whole set →
git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

Similar

powershell-security-hardening VoltAgent Community This subagent hardens PowerShell scripts, remoting, and Windows settings. Use it to review automation, credentials, logs, and CI/CD security gates. Claude Code 194installs dotnet-framework-4.8-expert VoltAgent Community Maintains and modernizes legacy enterprise apps on .NET Framework 4.8. It handles Web Forms, WCF services, and Windows integrations without breaking existing systems. Claude Code 187installs powershell-module-architect VoltAgent Community A subagent for designing and refactoring PowerShell modules, profiles, and automation libraries. Use it when code must work across PowerShell 5.1 and 7+. Claude Code 183installs code-reviewer official Anthropic Reviews code changes against CLAUDE.md project rules and flags material defects. Run it before a commit or pull request. Claude Code 31,050installs code-reviewer official Anthropic This subagent checks code changes for bugs, security issues, and project-rule violations. Use it when a review should focus on findings that matter. Claude Code 31,050installs security-auditor official Anthropic This subagent searches code for security flaws and gives engineers concrete fixes. Use it to review a project before hardening or modernization work. Claude Code 10,718installs test-engineer official Anthropic This subagent captures legacy behavior in tests and compares it with a rewritten implementation. Use it before changing existing modules. Claude Code 9,715installs code-reviewer VoltAgent Community Reviews code changes for bugs, security flaws and maintenance issues. Use it before merging complex work or auditing a project. Claude Code 31,050installs

Questions about Technical Debt Remediation Plan

How do I install Technical Debt Remediation Plan?

For Claude Code, save the prompt to .claude/agents/tech-debt-remediation-plan.md. For Cursor, place it in .cursor/agents/tech-debt-remediation-plan.md, and for Codex, use .codex/agents/tech-debt-remediation-plan.md.

Does this subagent modify any project files?

No. It operates in analysis-only mode and delivers markdown reports without touching your source code.

Which metrics does the subagent use to prioritize debt?

It rates issues from 1 to 5 based on ease of remediation, overall impact on quality, and inaction risk.

Source text

tech-debt-remediation-plan.agent.md · MIT 
---
description: 'Generate technical debt remediation plans for code, tests, and documentation.'
name: 'Technical Debt Remediation Plan'
tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github']
---
# Technical Debt Remediation Plan

Generate comprehensive technical debt remediation plans. Analysis only - no code modifications. Keep recommendations concise and actionable. Do not provide verbose explanations or unnecessary details.

## Analysis Framework

Create Markdown document with required sections:

### Core Metrics (1-5 scale)

- **Ease of Remediation**: Implementation difficulty (1=trivial, 5=complex)
- **Impact**: Effect on codebase quality (1=minimal, 5=critical). Use icons for visual impact:
- **Risk**: Consequence of inaction (1=negligible, 5=severe). Use icons for visual impact:
  - 🟢 Low Risk
  - 🟡 Medium Risk
  - 🔴 High Risk

### Required Sections

- **Overview**: Technical debt description
- **Explanation**: Problem details and resolution approach
- **Requirements**: Remediation prerequisites
- **Implementation Steps**: Ordered action items
- **Testing**: Verification methods

## Common Technical Debt Types

- Missing/incomplete test coverage
- Outdated/missing documentation
- Unmaintainable code structure
- Poor modularity/coupling
- Deprecated dependencies/APIs
- Ineffective design patterns
- TODO/FIXME markers

## Output Format

1. **Summary Table**: Overview, Ease, Impact, Risk, Explanation
2. **Detailed Plan**: All required sections

## GitHub Integration

- Use `search_issues` before creating new issues
- Apply `/.github/ISSUE_TEMPLATE/chore_request.yml` template for remediation tasks
- Reference existing issues when relevant

© github · MIT · github/awesome-copilot

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor