docs(memory): require provenance links and evidence metadata in workflow
This commit is contained in:
parent
e1155c24cc
commit
4c6a78006d
4 changed files with 21 additions and 0 deletions
|
|
@ -12,3 +12,4 @@ Fast path for agents:
|
||||||
1) Read memory_fabric_workflow.txt
|
1) Read memory_fabric_workflow.txt
|
||||||
2) Run query_and_injection.txt command sequence at task start
|
2) Run query_and_injection.txt command sequence at task start
|
||||||
3) Follow schema_and_noise_budget.txt before creating new memory nodes
|
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`)
|
||||||
|
|
|
||||||
|
|
@ -29,6 +29,11 @@ Required lifecycle:
|
||||||
3) Index memory node
|
3) Index memory node
|
||||||
- Relate canonical node to exactly one primary domain anchor
|
- Relate canonical node to exactly one primary domain anchor
|
||||||
bd dep relate <anchor-id> <memory-id>
|
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
|
4) Inject memory into execution
|
||||||
- At task start, query by domain and attach relevant nodes via relates_to
|
- 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 markdown-only memory source of truth
|
||||||
- No blanket blocker links for all memories
|
- No blanket blocker links for all memories
|
||||||
- Evidence before completion claims
|
- Evidence before completion claims
|
||||||
|
- Every canonical memory must have source-bead provenance links
|
||||||
|
|
|
||||||
|
|
@ -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
|
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
|
Step 3: Query hard constraints subset
|
||||||
```bash
|
```bash
|
||||||
bd query "label=memory AND label=mem-canonical AND label=mem-hard AND label=<domain> AND status=closed" --sort updated --reverse
|
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>."
|
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:
|
Expected response patterns:
|
||||||
- bd query: list of IDs + labels + titles
|
- bd query: list of IDs + labels + titles
|
||||||
- bd dep relate: relation confirmation
|
- bd dep relate: relation confirmation
|
||||||
|
|
|
||||||
|
|
@ -28,6 +28,8 @@ Required metadata JSON keys:
|
||||||
- owner
|
- owner
|
||||||
- supersedes
|
- supersedes
|
||||||
- superseded_by
|
- superseded_by
|
||||||
|
- evidence_ids
|
||||||
|
- plan_refs
|
||||||
|
|
||||||
Edge rules:
|
Edge rules:
|
||||||
1) Anchor <-> Canonical memory
|
1) Anchor <-> Canonical memory
|
||||||
|
|
@ -47,6 +49,7 @@ Noise budget limits:
|
||||||
- Per active task: 3-7 related memory nodes
|
- Per active task: 3-7 related memory nodes
|
||||||
- Per active task: 0-2 blocker contracts
|
- Per active task: 0-2 blocker contracts
|
||||||
- Per canonical memory: 1 primary anchor domain
|
- Per canonical memory: 1 primary anchor domain
|
||||||
|
- Per canonical memory: 2-5 source-bead provenance links
|
||||||
- Promote incident/workaround memory only after repetition evidence
|
- Promote incident/workaround memory only after repetition evidence
|
||||||
|
|
||||||
Promotion policy:
|
Promotion policy:
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue