docs(memory): require provenance links and evidence metadata in workflow

This commit is contained in:
ZenchantLive 2026-03-01 16:55:07 -08:00
parent e1155c24cc
commit 4c6a78006d
4 changed files with 21 additions and 0 deletions

View file

@ -12,3 +12,4 @@ Fast path for agents:
1) Read memory_fabric_workflow.txt
2) Run query_and_injection.txt command sequence at task start
3) Follow schema_and_noise_budget.txt before creating new memory nodes
4) Verify provenance links on selected memory nodes (`bd show` + `bd dep list`)

View file

@ -29,6 +29,11 @@ Required lifecycle:
3) Index memory node
- Relate canonical node to exactly one primary domain anchor
bd dep relate <anchor-id> <memory-id>
- Relate canonical node to 2-5 source beads that justify the memory
bd dep relate <memory-id> <source-bead-id>
- Record provenance metadata:
- evidence_ids: comma-separated source bead IDs
- plan_refs: comma-separated plan file paths
4) Inject memory into execution
- At task start, query by domain and attach relevant nodes via relates_to
@ -44,3 +49,4 @@ Non-negotiables:
- No markdown-only memory source of truth
- No blanket blocker links for all memories
- Evidence before completion claims
- Every canonical memory must have source-bead provenance links

View file

@ -11,6 +11,12 @@ Step 2: Query canonical memory for that domain
bd query "label=memory AND label=mem-canonical AND label=<domain> AND status=closed" --sort updated --reverse
```
Step 2b: Inspect provenance on candidate memories (required for fresh agents)
```bash
bd show <memory-id>
bd dep list <memory-id>
```
Step 3: Query hard constraints subset
```bash
bd query "label=memory AND label=mem-canonical AND label=mem-hard AND label=<domain> AND status=closed" --sort updated --reverse
@ -33,6 +39,11 @@ Step 6: Record acknowledgement
bd update <active-task-id> --notes "Memory injection: related <memory-id list>; hard contracts <contract-id list>."
```
Step 7: Preserve provenance in active work notes
```bash
bd update <active-task-id> --append-notes "Memory provenance checked via bd show/dep list for <memory-id list>."
```
Expected response patterns:
- bd query: list of IDs + labels + titles
- bd dep relate: relation confirmation

View file

@ -28,6 +28,8 @@ Required metadata JSON keys:
- owner
- supersedes
- superseded_by
- evidence_ids
- plan_refs
Edge rules:
1) Anchor <-> Canonical memory
@ -47,6 +49,7 @@ Noise budget limits:
- Per active task: 3-7 related memory nodes
- Per active task: 0-2 blocker contracts
- Per canonical memory: 1 primary anchor domain
- Per canonical memory: 2-5 source-bead provenance links
- Promote incident/workaround memory only after repetition evidence
Promotion policy: