How to read this roadmap
Use this page as the public forward plan for the UAI-1 launch surface. It is synchronized with the canonical workspace roadmap, but it stays scoped to what readers and implementers can verify on the site.
- Current means the record is already published as a page, route, package, validator behavior, or release note.
- Next means launch-hardening work that should happen before a broader public push.
- Planned means adopted future work that still needs fixtures, tooling, or governance before it becomes a public claim.
- Research-track means useful input that is not a current launch commitment.
Already current, not roadmap work
- UAI-1 already publishes the shared envelope, six profiles, field registry, transport bindings, trust channels, error registry, conformance levels, schemas, registry entries, examples, validator guidance, implementation tracks, API Reference, Adoption Kit, OpenAPI route, Conformance Pack, implementation evidence checklist, conformance fixture pack, bridge evidence pack, mock exchange, and release trail.
- Public launch routes are clean locale-prefixed paths. Query-string URLs are not the public launch surface.
- The launch package path is scripted and smoke-tested through the WordPress publishing workflow.
- Project Handoff, the AGENTS.md
.uailinking specification, the Reports index, and the refining report are current public pages;.uaigenerators, templates, validators, SDKs, and CLI tools remain future support work.
Now before launch
- Production hardening: keep package output, root discovery files, sitemap delivery, security headers, locale routing, and launch audits aligned before going public.
- Content and accessibility QA: re-check mobile readability, headings, copy controls, validator flows, long route examples, and Chinese release copy when page text changes.
- Public operating layer: keep governance, references, policy pages, changelog entries, Project Handoff, AGENTS.md
.uaiguidance, reports, and the roadmap synchronized so readers do not need private notes. - Standards-fit explanation: keep explaining how UAI-1 sits beside A2A, MCP, OpenAPI, DID/VC, Trace Context, JCS, and Problem Details without claiming to replace them.
- Conformance maturity: keep validator results, conformance packets, implementation evidence checklist answers, fixture-pack expectations, bridge evidence examples, and implementation-track evidence together before widening support claims.
Current bridge evidence and next interoperability work
The strongest near-term interoperability story is bridge evidence, not replacement claims. UAI-1 should remain the public envelope and release-record layer while adjacent systems keep their runtime roles.
- A2A: use current bridge evidence examples and future formal bridge profiles to show how agent discovery, delegation, and task-flow coordination can carry UAI-1 records.
- MCP: use the current tool-call and resource-result evidence examples to show how host-client-server tool sessions can produce or consume UAI-1 messages when a record needs to travel outside a local application boundary.
- OpenAPI: keep the published OpenAPI document tied to the REST surface while UAI-1 remains the message-contract layer.
- DID/VC and signing: keep trust material declared in the envelope without making one identity stack mandatory.
- Trace Context: keep traceparent support testable where distributed tracing is part of the workflow.
Compact transfer and canonicalization
Compact forms are useful only if they preserve the reviewable keyed source record. The field registry is the public map for keyless transport; canonicalization and public conformance evidence should operate on reconstituted keyed JSON.
- Keyed JSON remains the readable source of truth.
- Keyless JSON must reconstruct through the field registry before schema validation, hashing, signing, or conformance evidence.
- JCS canonicalization should apply to the reconstructed keyed JSON record, not to an ambiguous transport shortcut.
- Alias-key and binary-envelope variants remain planned or research-track work until fixtures, validator normalization, and route behavior are published.
Evidence metrics
- Public conformance packet count.
- Normalization mode coverage for keyed, minified-keyed, keyless, alias, and future binary paths.
- Positive and negative conformance fixture coverage, canonical-hash equivalence coverage, traceparent and DID/VC trust-boundary coverage, and required-field, undeclared-field, and keyless-overflow regression coverage.
- Bridge evidence example count and future formal bridge-profile fixture coverage for A2A, MCP, OpenAPI, DID/VC, Trace Context, and Problem Details mappings.
- Project-handoff route coverage, AGENTS.md link-guidance coverage, and loader-guardrail coverage for repository-context handoffs.
- Implementation-evidence checklist completion, implementation-track evidence count, and byte-size deltas across compact formats.
- Release-note completeness for every public artifact, route, policy, or validator change.
What this roadmap does not claim
- UAIX is not publishing a certification program today.
- UAI-1 does not replace A2A, MCP, OpenAPI, identity, signing, tracing, or transport systems.
- Current bridge evidence examples are mapping examples, not completed bridge profiles, SDK support, or certification claims.
- Alias and binary transport formats are not public support until validator-backed fixtures and route behavior are published.
- Project Handoff and AGENTS.md-linked
.uaifiles are draft repository-context guidance, not UAI-1 conformance evidence, certification, or endorsement by themselves. - One passing validator result is evidence for one reviewed packet, not blanket ecosystem support.
Machine-readable roadmap
The public roadmap is also available as /wp-json/uaix/v1/roadmap. Use that route when automation needs the current priority list, interoperability adjacency map, normalization-mode boundary, metrics, and non-claims.
Follow the active proof path
When a roadmap item moves from planned work to current support, it should update the affected public page, the machine artifact, the validator expectation, the implementation evidence checklist, fixture pack, and the release trail together. Start from UAI-1, verify with the Validator, use the API Reference, carry the Adoption Kit and Conformance Pack, answer the checklist, then record the change on the Changelog and News.