The Commonplace
Home Papers Evidence Explore Trends Syntheses Digests References About 🎲 Workforce Futures
← Papers
Direction, evidence grade, and study type are AI-generated labels (gpt-5-mini), not human-verified. Syntheses are LLM-written. "Tensions" are machine-detected candidates, not confirmed contradictions. A research-acceleration tool, not peer review. How this is built →

Giving coding agents interactive debuggers boosts bug-fix success by over 20% on standard benchmarks; better tool design can let cheaper models match pricier ones, narrowing the gap between model size and practical performance.

Debug2Fix: Can Interactive Debugging Help Coding Agents Fix More Bugs?
Spandan Garg, Yufan Huang · February 20, 2026
arxiv quasi_experimental medium evidence 7/10 relevance Full text usable extracted full text Source PDF

Structured author observations

Linked only from stored provider relations; the raw author line above is never matched by name.

Arxiv

Latest observation:

  1. Spandan Garg unresolved corpus identity
  2. Yufan Huang unresolved corpus identity

Semantic Scholar

Latest observation:

  1. Spandan Garg provider ID
  2. Yufan Huang provider ID
Integrating interactive debuggers into coding agents via a subagent architecture (Debug2Fix) improves bug-fixing performance on GitBug-Java and SWE-Bench-Live—yielding over 20% gains for some models and enabling weaker models to match or exceed stronger ones.

Citation observations

Cumulative provider counts captured on specific dates; providers are never combined.

While significant progress has been made in automating various aspects of software development through coding agents, there is still significant room for improvement in their bug fixing capabilities. Debugging and investigation of runtime behavior remains largely a manual, developer-driven process. Popular coding agents typically rely on either static analysis of the code or iterative test-fix cycles, which is akin to trial and error debugging. We posit that there is a wealth of rich runtime information that developers routinely access while debugging code, which agents are currently deprived of due to design limitations. Despite how prevalent debuggers are in modern IDEs and command-line tools, they have surprisingly not made their way into coding agents. In this work, we introduce Debug2Fix, a novel framework that incorporates interactive debugging as a core component of a software engineering agent via a subagent architecture. We incorporate debuggers for Java and Python into our agent framework and evaluate against GitBug-Java and SWE-Bench-Live and achieve >20% improvement in performance compared to the baseline for certain models. Furthermore, using our framework, we're able to make weaker models like GPT-5 and Claude Haiku 4.5 match or exceed the performances of stronger models like Claude Sonnet 4.5, showing that better tool design is often just as important as switching to a more expensive model. Finally, we conduct systematic ablations demonstrating the importance of both the subagent architecture and debugger integration.

Summary

Main Finding

Integrating interactive debugging into coding agents via a specialized Debug Subagent (Debug2Fix) substantially improves repository-level bug-fixing. The approach yields >20% relative improvement over baseline agents on some models and benchmarks, and—crucially—better tool and architecture design can let cheaper/weaker models match or exceed stronger models’ performance.

Key Points

  • Problem: Current coding agents rely on static analysis or iterative print-debugging (trial-and-error). They lack direct access to precise runtime state, which limits effectiveness and efficiency on harder bugs.
  • Solution (Debug2Fix): Introduce a Debug Subagent that encapsulates interactive debugger usage behind a simple, high-level question-answer interface for the main agent.
    • The main agent invokes the Debug Subagent with a Runtime Question plus metadata (test(s), path, lines, variable hints).
    • The subagent runs an internal debugging loop (set breakpoints, step, inspect) and returns a structured factual answer with evidence.
  • Tool design (LLM-friendly): concrete tools exposed to the subagent include
    • debug_start_session (atomic: build, launch test, attach, set initial breakpoints),
    • debug_control (continue / step over / step in / step out),
    • debug_inspect (evaluate expressions, inspect locals/objects, view call stacks),
    • debug_breakpoint (add/remove/list breakpoints),
    • plus file navigation/grep/read tools.
    • Output format enforces a block with Question, Answer, Evidence, Location.
  • Important engineering decisions:
    • Expose only the Debug Subagent to the main agent (not raw debugger tools), because direct exposure led to under‑utilization.
    • Disable file-editing tools until the main agent has invoked the Debug Subagent at least once—encourages root-cause analysis before edits.
    • Make debug_start_session atomic to avoid race conditions/timeouts seen when exposing lower-level steps.
  • Empirical claims:
    • Implemented with Java (JDB) and Python (pdb) debuggers.
    • Evaluated on repository-level bug-fix benchmarks (GitBug-Java, SWE-Bench-Live).
    • Observed >20% relative improvement over a vanilla agent baseline for certain model+setup combinations.
    • Using Debug2Fix enabled weaker/cheaper models (e.g., GPT-5, Claude Haiku 4.5) to match or exceed performance of stronger models (e.g., Claude Sonnet 4.5).
  • Ablations: show both the subagent architecture and the debugger integration are essential; exposing tools directly to the main agent or omitting atomic tooling lowers performance / utilization.

Data & Methods

  • Datasets / Benchmarks:
    • GitBug-Java (Java repository-level bug-fix benchmark).
    • SWE-Bench-Live (real-world software engineering bug-fix tasks; includes Python examples).
    • Motivating example: a deep repo Python bug (faker library) where _safe_now() fell back to epoch (1970-01-01), causing a negative timestamp; baseline agent did heavy print-debugging and proposed an incorrect change while Debug2Fix found the root cause quickly via breakpoints and variable inspection.
  • Models tested (representative mentions):
    • GPT-5, Claude Haiku 4.5, Claude Sonnet 4.5 (used to show model/tool tradeoffs).
  • System & Architecture:
    • Main agent: general-purpose repo-level coding agent with tools (bash, read, grep, etc.) plus Debug Subagent as a tool.
    • Debug Subagent: separate LLM instance with its own system prompt, context, and restricted toolset. It orchestrates the debugger tools and returns a concise evidence-backed answer.
    • Debug start session builds the project, launches tests, attaches debugger and sets breakpoints (defaults to test entry).
    • Debug Subagent performs iterative inspect/control/breakpoint actions until it answers the runtime question or exhausts turns.
  • Evaluation methodology:
    • Compare baseline agent (no debugger subagent) versus Debug2Fix on the benchmarks.
    • Measure repair/fix success rates (and report relative gains; >20% in some configurations).
    • Ablation studies: (a) expose debugger tools directly to the main agent vs via subagent, (b) disable/enable file-editing gating, (c) remove atomic start_session—assessing effects on utilization and success.
  • Qualitative analysis: traced trajectories show Debug2Fix mirrors expert developer debugger workflows (set breakpoint at test, step, inspect variables, find root cause) and avoids repeated print-debug cycles.

Implications for AI Economics

  • Tool design as a lever for cost-effective performance:
    • Investing in richer tool integration and agent architecture (subagents + debuggers) can substitute for upgrading to more expensive LLMs. The paper shows weaker/cheaper models can match stronger models when paired with better tooling—this changes the marginal value of model size vs tool engineering.
    • For firms evaluating product upgrades, ROI calculations should include engineering cost to integrate interactive debugging rather than only model API costs.
  • Pricing and product differentiation:
    • Coding-agent vendors can create tiered offerings where advanced runtime tooling (interactive debugger subagent) is a premium feature. Because tooling can boost cheaper models, vendors might monetize tooling rather than raw model access.
  • Productivity and labor effects:
    • Debug2Fix-style agents should reduce time-to-fix for complex bugs, increasing developer throughput and productivity. That has downstream effects on project timelines, staffing needs, and developer value-add metrics.
    • The technology complements developer skills (debugger-driven reasoning); demand may shift toward developers who can design/deploy tool-augmented workflows and integrate agents into CI/dev environments.
  • Cost structure and compute:
    • Fewer trial-and-error test runs and faster convergence to root causes reduce compute resources spent per bug-fix (fewer runs of tests / LLM calls), lowering operational costs for hosted agent services.
  • Evaluation and procurement:
    • Procurement decisions should weight agent-tool co-design and integration costs. Benchmarks that only measure static LLM performance will understate the value of integrated toolchains.
  • Risks & maintenance costs:
    • Integrating debuggers into production agents introduces operational complexity: build-system coupling, portability across languages/environments, security/sandboxing of runtime debugging, and ongoing maintenance as repos and toolchains change. These costs must be accounted for in economic assessments.
  • Market impact on benchmarking & competition:
    • Benchmarks and vendor comparisons should include tooling and orchestration quality. Firms emphasizing agent orchestration, subagent design, and engineering robustness may outcompete those that only optimize model choice.

If you’d like, I can: - Extract the paper’s reported numeric results and table(s) exactly (if you can provide the results section/tables). - Produce a short slide-style summary for stakeholders comparing model-upgrade vs tool-investment ROI scenarios.

Assessment

Paper Typequasi_experimental Evidence Strengthmedium — The paper reports sizable, consistent improvements (>20% for certain models) on multiple public benchmarks and includes ablation experiments that support the mechanism (debugger + subagent architecture). However, evidence is limited to benchmark tasks, a small set of languages (Java/Python) and models, lacks randomized or real-world deployment studies, and details on sample sizes, statistical significance, and robustness across diverse codebases are not provided. Methods Rigormedium — The authors implement tooling, evaluate on multiple established benchmarks, and run controlled ablations and cross-model comparisons, which are appropriate and informative for a systems paper; however, the work appears to lack detailed reporting of sample sizes, variance/CI/statistical tests, pre-registration, broader robustness checks (e.g., diverse real-world repos, developer-in-the-loop trials), and reproducibility artifacts are not fully described in the summary. SampleEvaluation uses two code-bug benchmarks (GitBug-Java and SWE-Bench-Live) containing bug-fix and runtime-debugging tasks for Java and Python; the framework integrates debuggers for Java and Python and is tested across multiple LLMs (reported examples include GPT-5, Claude Haiku 4.5, and Claude Sonnet 4.5) with ablation variants (no debugger, no subagent). Exact number of tasks/cases, dataset splits, and computing/hyperparameter details are not specified in the summary. Themesproductivity human_ai_collab IdentificationComparative benchmark evaluation: the authors implement an intervention (Debug2Fix) and compare bug-fixing success rates against baseline coding agents on standard benchmarks (GitBug-Java, SWE-Bench-Live), including systematic ablations (removing debugger integration and/or subagent architecture) and comparisons across multiple LLMs to attribute performance differences to the design choices; no randomization, formal causal identification, or external instrumental sources are used. GeneralizabilityLimited to Java and Python — other languages and runtime environments not evaluated, Benchmarks may not reflect the complexity and constraints of large, legacy, multi-module production codebases, Performance gains reported for specific models and configurations; effects may not generalize to all LLMs or future model architectures, Requires access to runtime/debugger-capable environments, which may not be available in many deployment settings (e.g., sandboxed cloud builds, restricted CI), Potential sensitivity to engineering choices (tooling integration, prompts, timeouts) and possible tuning to benchmark tasks, No measurement of real-world developer productivity, latency, cost, or integration overhead

Claims (9)

ClaimDirectionOutcomeConfidence & EvidenceDetails
There is still significant room for improvement in coding agents' bug fixing capabilities. Developer Productivity negative bug fixing capability of coding agents
Reading fidelity high
Study strength speculative
not reported
0.08
Debugging and investigation of runtime behavior remains largely a manual, developer-driven process. Task Allocation negative degree of automation in debugging/runtime investigation
Reading fidelity high
Study strength speculative
not reported
0.08
Popular coding agents typically rely on either static analysis of the code or iterative test-fix cycles, which is akin to trial-and-error debugging. Task Allocation negative techniques used by coding agents (static analysis or test-fix cycles)
Reading fidelity high
Study strength medium
not reported
0.48
There is a wealth of rich runtime information that developers routinely access while debugging code, which agents are currently deprived of due to design limitations. Developer Productivity negative availability/access to runtime debugging information for agents
Reading fidelity high
Study strength medium
not reported
0.48
We introduce Debug2Fix, a framework that incorporates interactive debugging as a core component of a software engineering agent via a subagent architecture. Developer Productivity positive integration of interactive debugging into an agent framework
Reading fidelity high
Study strength high
not reported
0.8
We incorporate debuggers for Java and Python into our agent framework and evaluate against GitBug-Java and SWE-Bench-Live and achieve >20% improvement in performance compared to the baseline for certain models. Output Quality positive agent performance on bug-fixing benchmarks (GitBug-Java, SWE-Bench-Live)
Reading fidelity high
Study strength medium
>20% improvement
0.48
Using our framework, weaker models like GPT-5 and Claude Haiku 4.5 can match or exceed the performances of stronger models like Claude Sonnet 4.5, showing that better tool design can be as important as switching to a more expensive model. Output Quality positive relative model performance on debugging/bug-fix tasks
Reading fidelity high
Study strength medium
weaker models match or exceed stronger models
0.48
We conduct systematic ablations demonstrating the importance of both the subagent architecture and debugger integration. Developer Productivity positive impact of architecture and tool integration on agent performance
Reading fidelity high
Study strength medium
not reported
0.48
Despite how prevalent debuggers are in modern IDEs and command-line tools, they have surprisingly not made their way into coding agents. Adoption Rate negative adoption of debuggers by coding agents
Reading fidelity high
Study strength low
not reported
0.24

Notes