| name | mechanism-edge-creation |
| description | SOP for creating a causal mechanism edge — documents how one variable causes changes in another. |
| execution | sop |
| used-by | mechanism-mapping, feedback-loop-detection |
Mechanism Edge Creation
Create an edge representing a causal mechanism between two variables.
Tool
vault_add_edge
Protocol
- Verify both variable pages exist
- Determine edge type: derived_from (direct causation), component_of (mediating variable)
- Call vault_add_edge with appropriate weight (strength of mechanism)
- Document mechanism description in the source variable's page body
- Inline wikilink: Ensure the source page contains
[[dir/slug]] pointing to the target (dir/slug = target path minus .md). Place inline where the mechanism is documented. If already present, skip.
HARD-GATE
Every causal edge must have a stated mechanism (HOW does X cause Y).
Weight must reflect mechanism strength: 1.0=strong, 0.5=moderate, 0.2=weak.
Yield
Returns: { success: boolean, mechanism: string, weight: number }