Multi-Agent Codebase Refactoring Workflow

Content

{
  "steps": [
    {
      "tool": "static_analysis",
      "order": 1,
      "action": "Auditor agent: static analysis scan, generate dependency graph, identify hotspots",
      "output": "hotspot_report"
    },
    {
      "tool": "llm",
      "order": 2,
      "action": "Planner agent: break refactoring into atomic, non-overlapping subtasks",
      "output": "task_breakdown"
    },
    {
      "tool": "agent_framework",
      "order": 3,
      "action": "Spawn parallel worker agents (max 4): each agent owns one module, reads code, proposes changes",
      "output": "proposed_changes"
    },
    {
      "tool": "llm",
      "order": 4,
      "action": "Conflict detector: check proposed changes for inter-module dependencies or collisions",
      "output": "conflict_report"
    },
    {
      "tool": "llm",
      "order": 5,
      "action": "Resolver agent: order changes to eliminate conflicts, produce sequenced patch list",
      "output": "sequenced_patches"
    },
    {
      "tool": "git_cli",
      "order": 6,
      "action": "Apply patches sequentially, run test suite after each, rollback on failure",
      "output": "refactored_codebase"
    }
  ],
  "tools_required": [
    "static_analysis",
    "llm",
    "agent_framework",
    "git_cli",
    "test_runner"
  ],
  "expected_output": "Refactored codebase with passing test suite and conflict-free patches applied sequentially",
  "trigger_condition": "Legacy codebase flagged for refactoring — tech debt sprint"
}