Side by side
Scaffold & Agent Harness
A useful narrow distinction: the harness runs the interaction; the scaffold shapes how the model behaves.
This distinction is useful but not universal. Read each author’s boundary.
Swap columns ⇄| Dimension | Scaffold | Agent Harness |
|---|---|---|
| Purpose | Configure behavior and available context. | Execute model–tool interactions. [Hugging Face][Anthropic] |
| Role in the system | Instructions and setup. | Runtime control. [Hugging Face][Anthropic] |
| Inputs and outputs | Instructions and tool descriptions presented to the model. | Requests and results. [Hugging Face][Anthropic] |
| Persistence | Implementation-dependent. | Implementation-dependent. [Hugging Face][Anthropic] |
| Example | Provide project conventions. | Dispatch a requested file read. [Hugging Face][Anthropic] |
| Boundary caveats | Can overlap with harness. | Can include broader surrounding software. [Hugging Face][Anthropic] |
Evidence for this distinction
- Harness, Scaffold, and the AI Agent Terms Worth Getting Right ↗ (opens in new tab)Hugging Face · 2026-05-25
Relevant section: Scaffolding; Harness - Scaling Managed Agents: Decoupling the brain from the hands ↗ (opens in new tab)Anthropic · 2026-04-08
Relevant section: Virtualized components; Decouple the brain from the hands
Last editorial review: 2026-09-13.