subagentspec

.com a2a.terse.v1
the a2a.terse.v1 spec primitive

A durable, D1-backed catalog of the terse YAML interchange style.

a2a.terse.v1 is a narrow, opinionated style for authoring agent-to-agent tool/task/routine/manifest YAML: two files, style.yaml (the emission rules) and rubric.md (the 7-criterion scoring rubric), governing artifacts shaped around exactly four top-level keys -- inputs, outputs, steps, and a trailing self-eval array, eval. This site exists to make that narrow spec durable and queryable rather than a fact that only lives in a skill's own SKILL.md.

This site is deliberately scoped narrow -- the broad Agent2Agent / MCP / e2m protocol landscape is covered on subagentprotocols.com. subagentspec.com covers exactly one house style within that landscape: the terse one.

Start here: the live rubric + structural elements catalog →

Two files, one shape

style.yaml defines how a terse artifact is emitted; rubric.md defines how it's graded. Both are small and fixed by design.

Self-eval tail

Every terse artifact ends with an eval array -- assertions the artifact carries about its own correctness, not just prose describing intent.

7 rubric criteria

structural_fidelity, terseness, io_contract, self_eval_tail, cross_platform, determinism, traceability -- browse them all →.

The terse YAML shape

keywhat it holds
inputsTyped parameters the artifact accepts, declared up front.
outputsTyped result(s) the artifact produces.
stepsThe ordered, terse sequence of actions turning inputs into outputs.
evalThe trailing self-eval tail -- an array of assertions the artifact checks about its own output.

See what the terse style actually is and how the rubric grades it.