docs/adr/0003-results-never-committed.md
23 lines · 879 B
ADR-0003: Raw results and artifacts are never committed
- Status: accepted
- Date: 2026-06-10 (practice predates; recorded here)
Context
Result JSONL, summaries, real-agent transcripts, and run workspaces are large, machine-specific, and in the transcript case may contain sensitive content. Committing them bloats the repo and invites accidental publication.
Decision
results/, run workdirs, and fixtures are oakignored. The durable home for
raw JSONL is external storage (R2, keyed as in
docs/results-and-dashboard.md), with D1 as a rebuildable index. The repo
contains scenarios, harness code, configs, schema, and docs only.
Consequences
- A fresh clone has no historical data; trend views come from the dashboard.
- Local validation runs write to
results/freely without commit noise. - Public claims must link the raw JSONL object, not a repo path.