diff options
| author | main <main@swarm.moe> | 2026-03-20 01:11:39 -0400 |
|---|---|---|
| committer | main <main@swarm.moe> | 2026-03-20 01:11:39 -0400 |
| commit | 22fe3d2ce7478450a1d7443c4ecbd85fd4c46716 (patch) | |
| tree | d534d4585a804081b53fcf2f3bbb3a8fc5d29190 /docs/product-spec.md | |
| parent | ce41a229dcd57f9a2c35359fe77d9f54f603e985 (diff) | |
| download | fidget_spinner-22fe3d2ce7478450a1d7443c4ecbd85fd4c46716.zip | |
Excise git provenance from experiment ledger
Diffstat (limited to 'docs/product-spec.md')
| -rw-r--r-- | docs/product-spec.md | 21 |
1 files changed, 6 insertions, 15 deletions
diff --git a/docs/product-spec.md b/docs/product-spec.md index efa57df..85561ad 100644 --- a/docs/product-spec.md +++ b/docs/product-spec.md @@ -50,7 +50,7 @@ These are the load-bearing decisions to hold fixed through the MVP push. The canonical record is the DAG plus its normalized supporting tables. Frontier state is not a rival authority. It is a derived, rebuildable -projection over the DAG and related run/checkpoint/experiment records. +projection over the DAG and related run/experiment records. ### 2. Storage is per-project @@ -103,8 +103,6 @@ benchmark/decision bureaucracy while still preserving it in the DAG. A completed experiment exists only when all of these exist together: -- base checkpoint -- candidate checkpoint - measured result - terse note - explicit verdict @@ -112,13 +110,6 @@ A completed experiment exists only when all of these exist together: The write surface should make that one atomic mutation, not a loose sequence of low-level calls. -### 7. Checkpoints are git-backed - -Dirty worktree snapshots are useful as descriptive context, but a completed -core-path experiment should anchor to a committed candidate checkpoint. - -Off-path notes and source captures can remain lightweight and non-committal. - ## Node Model ### Global envelope @@ -203,9 +194,9 @@ The frontier is a derived operational view over the canonical DAG. It answers: - what objective is active -- what the current champion checkpoint is -- which candidate checkpoints are still alive -- how many completed experiments exist +- how many experiments are open +- how many experiments are completed +- how the verdict mix currently breaks down The DAG answers: @@ -316,10 +307,10 @@ The MVP is successful when: - an agent can record off-path sources and notes without bureaucratic pain - the project schema can softly declare whether payload fields are strings, numbers, booleans, or timestamps - an operator can inspect recent nodes through a minimal localhost web navigator filtered by tag -- a git-backed project can close a real core-path experiment atomically +- a project can close a real core-path experiment atomically - retryable worker faults do not duplicate side effects - stale nodes can be archived instead of polluting normal enumeration -- a human can answer "what changed, what ran, what is the current champion, +- a human can answer "what was tried, what ran, what was accepted or parked, and why?" without doing markdown archaeology ## Full Product |