Briefing

Back to Articles Harness, Scaffold, and the AI Agent Terms Worth Getting Right

ai-dev
Claude

Review: Map your current agent architecture to harness, scaffold, and sub‑agent definitions to ensure clear separation.

What to do now

Review: Map your current agent architecture to harness, scaffold, and sub‑agent definitions to ensure clear separation.

Summary

On May 25 2026 the AI Agent community published a glossary that clarifies the often‑confused terms harness, scaffold, and sub‑agent in LLM‑based agent systems. The guide explains that a harness is the execution layer that calls the model, handles tool calls, and decides when to stop, while a scaffold is the system prompt, tool descriptions, and context‑management logic that shapes the model’s behaviour. An agent is defined as Model + Harness + Scaffold, and the document stresses that harness engineering involves stop criteria, error handling, and guardrails. Sub‑agents are separate agents invoked by a main agent to perform specialised sub‑tasks, and orchestrators manage multiple agents as units. The glossary also covers training pipelines, noting that the harness runs many episodes in parallel and feeds results back to the trainer for weight updates. The article highlights that products like Claude Code, Codex, and Antigravity CLI use the same terminology but differ in their harness implementations. By mapping existing architectures to these definitions, developers can better reason about component responsibilities and improve modularity. The guide serves as a practical mental model for both new and experienced practitioners working with agentic LLMs.

Key changes

  • Harness = execution layer that calls model, handles tool calls, decides stop
  • Scaffold = system prompt, tool descriptions, context management
  • Agent = Model + Harness + Scaffold
  • Harness engineering includes stop criteria, error handling, guardrails
  • Sub‑agents are separate agents invoked by main agent
  • Orchestrator manages multiple agents
  • Training pipeline uses harness for many episodes
  • Products like Claude Code, Codex, Antigravity CLI differ in harness implementations

Affects

internal

Customer impact

Analyzing matches…

Ask about this story

Impact on an agency? Which customers? Compare historically Risks of waiting