agent-dx
Agent DX
The developer experience of a surface where an AI agent is the developer — an SDK, tool,
structured output, error envelope, or telemetry an agent consumes to build with or act
through. Provenance lives in skill.json; this file is runtime routing only.
Produces: a change-plan.md (DO), an audit-report.md plus a findings-ledger +
workflow-state when tracked (REVIEW), or a design-doc.md / refactor-runbook.md /
explanation.md (DESIGN).
Core principle
An agent consumes the surface alone, at machine speed, with no tooltip to fall back on. So
the bar for any SDK, tool, error, or span is whether a stochastic consumer can parse it,
recover from it, and not be harmed by it: typed contracts over prose; recovery designed in,
not hoped for; the trust boundary closed by default. It sits atop the HTTP-client floor that
dx-audit / dx-design own, never replacing it.