Skip to content

Awesome list for AI agent harness engineering: tools, patterns, evals, memory, MCP, permissions, observability, and orchestration.

Add Claude Code /doctor to Debugging & Developer Experience section

ai-boostdbd91c669778
diff --git a/README.md b/README.md
index cc91b17..17fd20d 100644
--- a/README.md
+++ b/README.md
@@ -337,6 +337,7 @@ Harness components organized by the problem they solve, not by vendor.
- [AgentOps](https://github.com/AgentOps-AI/agentops) — Open-source agent engineering platform (YC W24) with session replay, cost tracking, and failure detection across 10+ frameworks including CrewAI, LangGraph, and OpenAI Agents SDK. The step-by-step execution graph and cross-session metrics make it the most practical debugging layer for multi-agent systems in production. ![Stars](https://img.shields.io/github/stars/AgentOps-AI/agentops?style=flat-square&label=★&color=yellow)
- [claude-devtools](https://github.com/matt1398/claude-devtools) — February 2026 open-source DevTools for Claude Code that reconstructs hidden session internals from local logs: per-turn token attribution across 7 context categories, full subagent execution trees with cost breakdowns, and syntax-highlighted diffs for every tool call. Essential because Claude Code's default UI deliberately collapses tool details and thinking steps — this tool restores the visibility harness engineers need to debug context pressure, subagent delegation, and token budget leaks. ![Stars](https://img.shields.io/github/stars/matt1398/claude-devtools?style=flat-square&label=★&color=yellow)
+- [Claude Code `/doctor`](https://code.claude.com/docs/en/commands) — Anthropic's July 2026 bundled setup-checkup skill (alias `/checkup`) that audits harness hygiene: it deduplicates local and checked-in `CLAUDE.md` files, flags unused skills/MCP servers/plugins, identifies slow hooks, and proposes fixes only after confirmation. The clearest first-party example of treating harness configuration drift — not model output — as the debugging target.
- [Syncause/debug-skill](https://github.com/Syncause/debug-skill) — April 2026 agent debugging skill that stops guesswork with runtime evidence. Uses background tracing (Runtime Facts) to capture the exact execution path leading to failures, then constrains the agent to cite specific data points (stack traces, variable snapshots) before proposing fixes. Moves agent debugging from "patch and pray" to evidence-based repair with reviewable results. ![Stars](https://img.shields.io/github/stars/Syncause/debug-skill?style=flat-square&label=★&color=yellow)
- [AgentTrace: Causal Graph Tracing for Root Cause Analysis in Multi-Agent Systems](https://arxiv.org/abs/2603.14688) — March 2026 framework that localizes root causes in multi-agent execution traces using causal graph analysis rather than LLM inference. Processes traces in 0.12 seconds (69× faster than LLM-based analysis) with 93.6–95.8% accuracy across 550 synthetic failure scenarios. Distinguishes root causes from downstream symptom propagation — the key capability missing from most trace-inspection debugging workflows.
- [TraceCoder: A Trace-Driven Multi-Agent Framework for Automated Debugging of LLM-Generated Code](https://arxiv.org/abs/2602.06875) — February 2026 ICSE paper introducing a collaborative multi-agent debugging loop: Instrumentation Agent injects diagnostic probes, Analysis Agent performs causal trace diagnosis with a Historical Lesson Learning Mechanism (HLLM) that distills insights from prior failures, and Repair Agent executes validated fixes with rollback on regression. Achieves up to 34.43% relative improvement in Pass@1 over baselines.