Appearance
Reference
FreshThis section contains the complete technical reference for the Agentic Reasoning Protocol. Use these documents when implementing ARP, validating compliance, or understanding the full specification.
Documents in this Section
Specification v1.2
The normative specification for ARP. Defines every field, constraint, object, and behavioral requirement. If you are implementing a publisher, validator, or consumer of reasoning.json files, the specification is the authoritative source.
- File location requirements and content-type rules
- Complete schema reference with all root properties
- Verification, identity, corrections, entity claims, and recommendation context objects
- Cryptographic trust layer using Ed25519 signatures and DNS TXT records
- Diagnostics object for ingestion telemetry
- Anti-spam limits table
- Migration guides from v1.0 and v1.1
JSON Schema v1.2
The current JSON Schema document (Draft 7) that validators use to check reasoning.json files. Covers all fields introduced through v1.2 including _arp_signature and diagnostics. Use this when building automated validators or when you need the exact type constraints for every field.
JSON Schema v1.1
The previous stable schema. Key changes from v1.0 include the reframing from "directives" to "self-attestations", anti-spam character limits across all string fields, and the replacement of the false_claim/correction_fact pattern with the cleaner trigger_topic/verified_fact pattern. Published 2025-08.
JSON Schema v1
The original schema from the initial ARP release. Documents the baseline false_claim/correction_fact corrections pattern, which is now deprecated. No cryptographic signing, no anti-spam limits. Retained for historical reference and for operators maintaining backward-compatible parsers.
Ethics Policy v1.2
ARP is a self-attestation protocol, which means honesty is enforced by community norms rather than cryptographic proof. The ethics policy defines what constitutes acceptable use, prohibited patterns, and the principles every publisher must follow. Covers truthfulness, self-description-only constraints, competitor naming restrictions, and guidance on recommendation context.
IETF Internet-Draft
A summary of draft-deforth-arp-01, a Standards Track Internet-Draft submitted April 2026. The draft proposes ARP as an IETF standard, formalizing the Ed25519 cryptographic binding, DNS TXT integration, and .well-known URI registration. Analogous to DKIM (RFC 6376) but for semantic entity data consumed by AI agents.
Version History
| Version | Release | Key Changes |
|---|---|---|
| v1.2 | 2026-02 | Ed25519 signatures, diagnostics object, epistemic scope classification |
| v1.1 | 2025-08 | Anti-spam limits, trigger_topic/verified_fact pattern, self-attestation framing |
| v1.0 | 2025-03 | Initial release, false_claim/correction_fact pattern |
Normative vs Informative
The Specification v1.2 is the normative document. All other reference documents are informative or supplementary. In cases of conflict between schema files and the specification text, the specification takes precedence.