Open Source

The journal behind agent calibration

ADJ is the portable, append-only record format for agent deliberations — the substrate that lets calibration scoring, outcome tracking, and cross-deliberation learning actually close the loop.

5
Journal entry types
3
Compliance levels
3
Reference implementations

Why choose us

Decisions and outcomes are recorded separately

The split between deliberation_closed and outcome_observed is the load-bearing design choice — it's what makes calibration scoring possible in the first place.

Substrate-agnostic

JSONL files, SQLite, Postgres, an event log — anything append-only and orderable qualifies. A directory of JSONL files is a valid Level 1 implementation.

Tiered compliance

Level 1 writers, Level 2 query providers, Level 3 scoring engines. Start where you are; upgrade when you're ready. Every level is interoperable with every other.

Closes the ADP loop

ADP produces deliberation events; ADJ stores them; outcomes arrive; ADJ computes calibration; ADP reads those scores to weight future votes. The loop closes.

Capabilities

Five canonical entry types

deliberation_opened, proposal_emitted, round_event, deliberation_closed, outcome_observed — a shared envelope with optional hash-chain support.

JSON Schema validation

Every entry type validated by the shipped v0.json schema. CI-ready before entries ever land on disk.

Query contract

getCalibration, getDeliberation, getOutcome — the minimum read surface any Level 2+ implementation must serve.

Brier-score calibration

Reference scoring algorithm turns recorded (confidence, outcome) pairs into per-agent calibration values the protocol can weight votes by.

Signed calibration snapshots (§7.4)

Ed25519-signed per-domain snapshots served at /.well-known/adp-calibration.json — the primary cross-org trust mechanism.

CI validator

@ai-manifests/adj-validate checks individual entries and full deliberation records including hash-chain integrity and outcome timing.

Add a journal to your agent stack

Pick a substrate. Write conformant entries. Serve the query contract. The reference libraries handle the scoring for you.

Browse reference libraries