Agent context complements human help with a small, stable JSON description of
commands, inputs, output modes, interaction, and mutation boundaries. A common
application convention is context --json; cargo-orthohelp uses
--format agent-context for generation.
The smallest valid context created by AgentContext::new("acme") serializes to
this shape:
{
"schema_version": "1",
"kind": "acme.agent_context",
"package": "acme",
"commands": [],
"profiles": { "supported": false },
"feedback": { "supported": false },
"policy": { "agent_native": "warn" },
"skill_manifests": []
}
Fill AgentCommand entries only with claims the executable honours.
SkillManifest and SkillCommandRef link skills to real commands. They do not
replace command validation or grant an agent capabilities that the CLI does not
have.