scripod.com

What a harness is and how to build one with Claude Agent SDK

How I AI

3 DAYS AGO
How I AI

How I AI

3 DAYS AGO
This episode demystifies the concept of an AI 'harness' by walking through the live construction of a custom bug-debugging tool. The host builds a terminal-based system using the Claude Agent SDK to automate the entire workflow of triaging, analyzing, and documenting software bugs, moving beyond general-purpose AI coding tools.
The host explains that a harness is structured code around an AI agent, designed to make it more effective for specific, repetitive tasks. The episode focuses on a bug-debugging harness built for the host's company, ChatPRD, which connects to Sentry, Linear, GitHub, and Vercel. The harness automates evidence gathering, root-cause analysis, and follow-up artifact creation, such as creating Linear issues and writing summaries. The architecture includes a CLI frontend, runs and tasks, opinionated adapters for external APIs, and custom prompts to enforce tool policies. The host demonstrates the harness investigating a Sentry error, identifying root causes like invalid ranges, and recommending next steps. The episode concludes with a guide on building a harness: identify a specific workflow, define runs and tasks, create adapters, structure artifacts, set rules, choose a model, and build an interface like a TUI, CLI, or web app.
00:00
00:00
A harness is code around an AI agent that makes it more effective for specific tasks.
03:19
03:19
Build a harness for repetitive workflows
04:34
04:34
Automating triage, root-cause analysis, and follow-up actions.
06:01
06:01
Custom harness automates the entire bug workflow without re-explaining intent.
09:49
09:49
The harness automates investigation runs without modifying files
11:04
11:04
Harness uses Claude Sonnet 4.6 and connects to Sentry, Linear, and GitHub.
13:45
13:45
Codex built the best agent but used the Claude Agent SDK
15:08
15:08
The harness is simple, with a high-level index for the TUI and eight files for specific tasks.
16:51
16:51
The harness constrains agents to solve specific problems efficiently.
19:18
19:18
Harness identified root causes and a blind spot
21:04
21:04
A harness is simply structured code around an AI agent.