derek-opdee

Sub-Agent Tech Debt Finder & Fixer Command

Development community intermediate

SOURCE https://github.com/derek-codebridge/subagent-example-script

Description

A two-phase command that first identifies technical debt across your codebase, presents findings for review, then orchestrates specialized sub-agents to systematically fix the issues while ensuring co

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for derek-codebridge/subagent-example-script, shared by 8 entries in this directory. It describes the repository, not this entry specifically.

Sub-Agent Tech Debt Finder & Fixer Command

A two-phase command that first identifies technical debt across your codebase, presents findings for review, then orchestrates specialized sub-agents to systematically fix the issues while ensuring code stability.

Command Syntax

sub-agent-tech-debt-finder-fixer [target] [options]

# Aliases
@tech-debt-finder-fixer [target] [options]
@td-finder-fixer [target] [options]
@satdff [target] [options]

Parameters

Target

target - Directory, file, or glob pattern to analyze (defaults to current directory)

Options

--type - Types of tech debt to find (duplicates, complexity, patterns, dead-code, types, all)
--threshold - Sensitivity threshold (aggressive, standard, conservative)
--auto-fix - Auto-fix level (none, safe, recommended, all)
--interactive - Review each fix before applying (default: true)
--dry-run - Show what would be fixed without making changes
--fix-order - Order of fixes (risk, impact, quick-wins, custom)
--backup - Create backups before fixes (default: true)
--test-command - Command to run tests between fixes
--max-changes - Maximum number of fixes per run
--ignore - Patterns to ignore (.techdebtignore file)

Examples

Basic Usage

# Find and fix tech debt with review
sub-agent-tech-debt-finder-fixer

# Quick wins only - safe fixes
sub-agent-tech-debt-finder-fixer --auto-fix safe --fix-order quick-wins

# Dry run to see what would be fixed
sub-agent-tech-debt-finder-fixer --dry-run

Advanced Usage

# Focus on duplicate code with aggressive detection
sub-agent-tech-debt-finder-fixer src/ \
  --type duplicates \
  --threshold aggressive \
  --auto-fix recommended

# Full scan with custom test command
sub-agent-tech-debt-finder-fixer \
  --auto-fix safe \
  --test-command "npm test && npm run lint" \
  --max-changes 10

# Non-interactive mode for CI/CD
sub-agent-tech-debt-finder-fixer \
  --interactive false \
  --auto-fix safe \
  --fix-order risk

Phase 1: Finding Tech Debt (Parallel Agents)

Agent 1: Duplicate Code Detector

Find duplicate code in [TARGET]

Detection Tasks:
1. Exact Duplicates:
   - Copy-pasted code blocks
   - Identical functions in different files
   - Repeated constants/configurations
   - Duplicate type definitions
   - Identical test patterns

2. Similar Code (70%+ similarity):
   - Functions with minor parameter differences
   - Components with slight prop variations
   - Similar error handling patterns
   - Repeated validation logic
   - Near-identical API calls

3. Pattern Duplicates:
   - Repeated design patterns
   - Similar file structures
   - Duplicate business logic
   - Repeated UI patterns
   - Similar data transformations

4. Should-Be-Utils:
   - Date formatting functions
   - String manipulation
   - Array operations
   - API request builders
   - Validation helpers

Return:
- Duplicate groups with file:line references
- Similarity percentages
-