openagp/spec

The Agent Governance Protocol — specification, JSON Schemas, and reference fixtures.

What's here

• concept-and-spec.md — full v0.1 working draft (concepts + protocol spec + reference implementation plan + adoption strategy)
• schemas/ — JSON Schemas for canonical event, policy descriptor, decision request/response, discovery document (coming)
• fixtures/events/ — 50 example events covering all action.type values (coming)
• fixtures/policies/ — 10 example policies covering all rule patterns (coming)
• decisions/ — RFCs and decision records for substantive spec changes (coming)

Status

v0.1 — working draft. The spec is functional enough to start a reference implementation against, but is not yet a final RFC. Items marked [OPEN] in the spec are decisions for the standards working group once formed.

See §4 of the spec for the build order. The reference implementations live in sibling repos:

• openagp/sdk-python
• openagp/sdk-typescript
• openagp/cts — Conformance Test Suite
• openagp/registry — Public actor registry
• openagp/examples

Contributing

See CONTRIBUTING.md and GOVERNANCE.md at the org level.

For spec changes:

1. Open an issue describing the change and rationale.
2. PR adds a decision record in decisions/.
3. Substantive changes have a 2-week comment period; breaking changes have 4 weeks.

License

CC BY 4.0 — you may share and adapt the spec for any purpose, including commercially, with attribution.