Harness blueprints

Harness blueprints

A coding agent, a personal assistant and a support desk look nothing alike from the outside. Inside, they are the same parts: a loop, tools, context, state, a workspace, a surface and sometimes a team. What changes is which parts carry the weight. Each blueprint below lists the primitives a harness uses, what you write yourself, and how it deploys.

If the parts are new to you, read First principles first. If you are about to build something and want to know whether it already exists, check the primitives map.

Every blueprint draws from the same three layers. Glove builds the harness, Foundry runs many of them as a system, Kuiper runs the system in production.

Same parts, different weight

Read a column top to bottom and the pattern shows: every harness has a surface and context, most have state, and only some need a workspace or a team. The system column is where the agent stops being one conversation and becomes a service.

HarnessSurfaceContextStateWorkspaceTeamSystem
Coding agentTerminal or web client over a socket; plan approval with pushAndWaitRepository guides as skills, the task list, compactionTranscript, permission decisionsA sandbox, or the host directory behind permission gatesRead-only explorer and reviewer subagentsOptional: Foundry for background runs
Personal agentTelegram, email or WebChatPinned preferences and live state at the tailMemory of people, events and notesA browser, documents, a sandboxA research subagentOne instance per person, schedules, sleep, approvals
Support deskThe ticket thread or chat widgetThe customer's record as live contextForms, facts and goals per conversationUsually none: MCP or tables over your systemsA read-only research subagentInstance per customer, transmissions, playbooks, subscriptions, classifiers, approvals
Voice agentSpeech: a pipeline or a realtime modelRuntime context, refreshed silentlyForms that work over speechNone in the voice loopA fast front agent and a heavy worker over meshDurable work delegated to Foundry
Research & documentsChat, with files handed over by presentSkills in /skills; the script libraryVFS snapshots between runsWorking environment, a REPL, format adaptersA reviewer subagentVFS persistence, background work
Multi-agent workforceThe inspector, plus your own briefing UIOne prompt per roleWorkspace entries, tasks, the shared inboxShared VFS paths passed by referenceSpawn, mesh, subagentsSubscriptions that provision agents, schedules

The blueprints

How to read a blueprint

Each page opens with a bill of materials: for each of the three layers, the parts the harness uses and the primitives it takes from each, then the parts it doesn't need. The dashed box is what you write: usually your domain tools, your prompts, and the adapter for your own channel or data. Everything else is already built.

Then comes one request or event walked through the harness, a skeleton you can start from, the things people most often hand-build for that shape (and what to use instead), and the steps to deploy it on Kuiper.

To build the same parts up one at a time instead, follow Build it up, which takes one agent from a single tool to a deployed Foundry system in eight steps.