Skip to content

Commit b7285bc

Browse files
christsochristso
committed
docs: migrate ADRs to adrs format
Entire-Checkpoint: 4f7325a9ab13
1 parent 2fcd72f commit b7285bc

15 files changed

Lines changed: 50 additions & 27 deletions

‎adrs.toml‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Keep the singular directory name: adr-tools and adrs use doc/adr by default.
2+
adr_dir = "docs/adr"
3+
mode = "compatible"
4+
5+
[templates]
6+
format = "nygard"
7+
variant = "bare"

docs/adr/2026-06-11-phoenix-observability-adapter.md renamed to docs/adr/0001-keep-phoenix-observability-integration-out-of-core.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,12 @@
1-
# ADR: Keep Phoenix observability integration out of core
1+
# 1. Keep Phoenix observability integration out of core
22

33
Date: 2026-06-11
44

5-
Status: Superseded in part by [2026-06-21 Phoenix read-only correlation boundary](2026-06-21-phoenix-read-only-correlation-boundary.md)
5+
## Status
6+
7+
Superseded
8+
9+
Superseded in part by [5. Keep Phoenix read-only at the AgentV artifact boundary](0005-keep-phoenix-read-only-at-agentv-artifact-boundary.md).
610

711
This ADR remains useful for the narrower point that Phoenix-specific behavior
812
does not belong in `packages/core`. Its earlier allowance for Phoenix dataset,

docs/adr/2026-06-17-harbor-runner-boundary.md renamed to docs/adr/0002-keep-harbor-benchmark-execution-behind-runner-boundary.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
1-
# ADR: Keep Harbor benchmark execution behind a runner boundary
1+
# 2. Keep Harbor benchmark execution behind a runner boundary
22

33
Date: 2026-06-17
44

5-
Status: Proposed
5+
## Status
6+
7+
Proposed
68

79
## Context
810

@@ -49,7 +51,7 @@ experiment concern. Harbor execution should follow the same split:
4951
- Harbor-authored YAML remains Harbor's own config surface when the standard
5052
suite needs Harbor-specific task packaging or verifier settings.
5153

52-
This means the examples below describe the desired logical fields, but new
54+
This means the examples below show the desired logical fields, but new
5355
runtime fields should be placed on an experiment unless they are genuinely part
5456
of the benchmark suite identity. Do not put candidate agent/model binding in the
5557
eval file for new AgentV-native examples.

docs/adr/2026-06-18-opik-post-run-export-boundary.md renamed to docs/adr/0003-keep-opik-export-as-post-run-adapter-over-agentv-result-bundles.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
1-
# ADR: Keep Opik export as a post-run adapter over AgentV result bundles
1+
# 3. Keep Opik export as a post-run adapter over AgentV result bundles
22

33
Date: 2026-06-18
44

5-
Status: Proposed
5+
## Status
6+
7+
Proposed
68

79
## Context
810

docs/adr/2026-06-18-sdk-surface-decision.md renamed to docs/adr/0004-replace-agentv-eval-with-agentv-sdk-as-public-typescript-sdk.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
1-
# ADR: Replace @agentv/eval with @agentv/sdk as the public TypeScript SDK
1+
# 4. Replace @agentv/eval with @agentv/sdk as the public TypeScript SDK
22

33
Date: 2026-06-18
44

5-
Status: Accepted
5+
## Status
6+
7+
Accepted
68

79
Update 2026-06-22: `@agentv/eval` has been deprecated on npm and removed from
810
this repository. `@agentv/sdk` is the only lightweight TypeScript SDK package

docs/adr/2026-06-21-phoenix-read-only-correlation-boundary.md renamed to docs/adr/0005-keep-phoenix-read-only-at-agentv-artifact-boundary.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
1-
# ADR: Keep Phoenix read-only at the AgentV artifact boundary
1+
# 5. Keep Phoenix read-only at the AgentV artifact boundary
22

33
Date: 2026-06-21
44

5-
Status: Accepted
5+
## Status
6+
7+
Accepted
68

79
## Context
810

docs/adr/2026-06-23-experiments-vs-eval-separation.md renamed to docs/adr/0006-separate-experiments-from-eval-definitions.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
1-
# ADR: Separate experiments from eval definitions
1+
# 6. Separate experiments from eval definitions
22

33
Date: 2026-06-23
44

5-
Status: Proposed
5+
## Status
6+
7+
Proposed
68

79
## Context
810

@@ -66,10 +68,10 @@ stop being the canonical home for experiment-level choices.
6668

6769
## Decision
6870

69-
AgentV will make experiments first-class configuration units separate from
70-
eval definitions.
71+
Experiments and eval definitions are separate public configuration surfaces in
72+
AgentV.
7173

72-
Eval files remain YAML-authored by default. They should describe what is tested:
74+
Eval files remain YAML-authored by default. They should capture what is tested:
7375
task inputs, datasets, assertions, and task fixtures. They should not be the
7476
canonical place for which agent, model, harness, setup injection, sandbox, or run
7577
matrix executes the task.

docs/adr/2026-06-24-no-force-push-results-sync.md renamed to docs/adr/0007-conflict-free-results-sync-without-force-push.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
1-
# ADR: Conflict-free results sync without force push
1+
# 7. Conflict-free results sync without force push
22

33
Date: 2026-06-24
44

5-
Status: Accepted
5+
## Status
6+
7+
Accepted
68

79
Bead: av-raf
810

‎docs/plans/2026-06-21-001-feat-av-quf-results-storage-plan.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -880,7 +880,7 @@ results:
880880
`apps/cli/src/commands/results/serve.ts`, and
881881
`apps/cli/src/commands/results/export.ts` for current CLI/Dashboard remote,
882882
metadata, serving, and export behavior.
883-
- `docs/adr/2026-06-18-opik-post-run-export-boundary.md` for the adapter boundary
883+
- `docs/adr/0003-keep-opik-export-as-post-run-adapter-over-agentv-result-bundles.md` for the adapter boundary
884884
that keeps AgentV run bundles canonical.
885885
- Backblaze B2 S3-compatible docs:
886886
`https://www.backblaze.com/docs/cloud-storage-call-the-s3-compatible-api` and

‎docs/plans/2026-06-23-002-experiments-separation-plan.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "feat: Separate experiments from eval definitions"
33
type: feat
44
date: 2026-06-23
5-
origin: docs/adr/2026-06-23-experiments-vs-eval-separation.md
5+
origin: docs/adr/0006-separate-experiments-from-eval-definitions.md
66
---
77

88
# feat: Separate experiments from eval definitions
@@ -222,7 +222,7 @@ experiment sidecars should use explicit path fields.
222222

223223
Files:
224224

225-
- `docs/adr/2026-06-23-experiments-vs-eval-separation.md`
225+
- `docs/adr/0006-separate-experiments-from-eval-definitions.md`
226226
- `docs/plans/2026-06-23-002-experiments-separation-plan.md`
227227

228228
Approach:

0 commit comments

Comments
 (0)