Core concept

A configured agent is a product-specific runtime.

It combines a base harness, model policy, instructions, tools, skills, and permissions. Your server calls it with the `harness_id` path segment.

Configuration

Base: Execution engine such as codex, claude-code, or hermes.
Purpose: The product job this runtime is allowed to perform.
Instructions: Task rules, output contract, role mismatch behavior, and safety boundaries.
Tools and skills: Optional MCP servers, custom skills, and built-in document capabilities.
Model policy: The allowed models and default model fetched from the API.

Reuse or create

Reuse an existing configured agent only when purpose, data access, tools, permissions, and output contract match.
Update it when it is the canonical configured agent for the same feature.
Create a new configured agent when the risk boundary or output contract changes.