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
|
||||
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`)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue