Contracts Reference
ADR Index
Architecture Decision Records, and what they govern.
Hard-to-reverse, public-facing decisions are recorded as ADRs under
adrs/. This index maps each one to the documentation pages it governs.
Read the relevant ADR before changing what it covers.
| ADR | Decision | Governs |
|---|---|---|
| 0001 | Architecture boundary: Core / Harness / Skill | System Boundary |
| 0002 | Package manager: uv | Repo tooling |
| 0003 | Linter / formatter: ruff + mypy strict | Repo tooling |
| 0004 | SonarCloud as informational signal | Repo tooling |
| 0005 | CLI & config boundary: argparse + PyYAML | CLI · Run Config |
| 0006 | Open-convention trace mapping subset | Integrations |
| 0007 | Subprocess TaskRunner contract | Integrations |
| 0008 | CI annotations & exit-class taxonomy | CI Exit Codes · Reports & Exits |
| 0009 | Baseline format & explicit promotion | Baseline Comparability · Compare Baselines |
| 0010 | EvalGlass Skill home & shape (naming superseded by 0026) | EvalGlass Skill |
| 0011 | Vendoring namespace & invocation | Host Layout · Revendor Safely |
| 0012 | Manifest & lock formats | Revendor Safely |
| 0013 | Host discovery depth | EvalGlass Skill |
| 0014 | JudgeModel port & fake adapter | Judges |
| 0015 | Judge evidence / calibration formats | Judge Calibration |
| 0016 | Optional live judge provider lane | Optional Lanes |
| 0017 | Extension-lane framework | Extension Lanes · framework |
| 0018 | Trace backend adapter (stub-first) | Optional Lanes |
| 0019 | ScoreSink export lane contract | Optional Lanes |
| 0020 | Richer EvalUnit model | EvalUnit · Runner |
| 0021 | Generated-evidence governance | Evidence Approval |
| 0022 | Claude Code plugin packaging & delivery boundary | CLI Reference · EvalGlass Skill |
| 0023 | Codex second-runtime packaging | Codex Runtime |
| 0024 | Score subject identity (additive provenance) | Read a Scorecard · Score Semantics |
| 0025 | Authoring tier & advanced extensions (v1.1) | Add a Metric · Promote a Gate |
| 0026 | Rename the integration package evalglass.skill → evalglass.installer (drop legacy SKILL.md) | CLI Reference · EvalGlass Skill |
| 0027 | Name the marketplace after the publisher (evalglass@syntelesis-lab) | Install the plugin · CLI Reference |
| 0028 | authority.json is a host-owned ledger; the runtime never reads it | Authority · Evidence Approval |
| 0029 | Frozen public-surface snapshots & the capability-status taxonomy | Status Taxonomy |
| 0030 | Companion-ontology drift guard (vendored artifact, two tracks) | Machine ontology (companion artifact) |
| 0031 | Runner-attach seam, lanes: config & the RunRecord.lane_results side channel | Runner · Extension Lanes |
| 0032 | Companion-ontology reconciliation (edit the vendored copy; strict Track B) | Machine ontology (companion artifact) |
| 0033 | Live trace-connector boundary & optional provider-SDK policy | Connectors · Optional Lanes |
| 0034 | Langfuse trace connector | Connectors |
| 0035 | Phoenix trace connector | Connectors |
| 0036 | LangSmith trace connector | Connectors |
| 0037 | Per-source-function score view is not built (a deliberate non-goal) | Read a Scorecard · Agent Commands |
| 0038 | M7 epistemic core — honest Estimates, DecisionPolicy, typed authority | Read a Scorecard (confidence guide forthcoming) |
| 0039 | Metric Discovery — an agentic capability that derives domain-meaningful metrics | Discover Metrics |
| 0040 | Generic OpenAI-compatible judge lane | Judges · Optional Lanes |
| 0041 | The discovery scaffolder conforms to the canonical host layout | Discover Metrics · Host Layout |
| 0042 | Host command judge (subprocess JudgeModel) | Judges |
| 0043 | HTML Scorecard report (report.html — dashboard + deltas) | Read a Scorecard (report guide forthcoming) |
| 0044 | Interval bounds rounded to a platform-independent precision | Read a Scorecard (confidence guide forthcoming) |
| 0045 | Config-reachable trajectory / session unit ladder (unit:) | Run Config (trajectories guide forthcoming) |
| 0046 | connect --live verb over the shipped connector lanes | Connectors · Agent Commands |
| 0047 | Diagnostic clusters in the Scorecard (Scorecard.clusters) | Read a Scorecard (clusters guide forthcoming) |
| 0048 | Continuous drift watcher (evalglass watch) | Compare Baselines (watch guide forthcoming) |