mcp_engram_record_reasoning_trace
Records structured reasoning traces to capture decision points, justifications, and forks for future agent continuation.
Instructions
Record a structured reasoning trace segment as first-class serial memory. This is the primary mechanism for automatic capture of decision points, justifications, and forks during active work (see engram-working-memory Rule 5 and Spatial Discipline). Produces well-named trace:* blocks that the ki_hijacker surfaces in the Ritual + Reasoning Trajectory and that session_end can later compress via 0x10 functors. PREFERRED over free-form notes for anything that affects future agent continuation. Call from within the ritual disciplines at major forks, pre-edit justifications, and post-delta decisions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deny | No | Alternatives, risks, or prior positions being rejected with justification (A/D/R triad; optional) | |
| affirm | No | Core positive claim, intent, or state being advanced (A/D/R triad: assertion/decision/rationale; optional but recommended for high-stakes traces) | |
| reconcile | No | Synthesis step — how this resolves tension or advances coherence (ZEDO-like 'fruit' carrier per logophysics mapping; optional) | |
| prev_trace | No | Exact concept name of the previous trace segment in this chain (for linking) | |
| goal_context | No | Goal ID this trace serves (optional but strongly recommended when goals are active) | |
| justification | Yes | Why this path was chosen (the positive reasons) | |
| decision_point | Yes | The question, fork, or decision at hand (short and precise) | |
| falsifiability | No | What new information or outcome would cause this decision to be reconsidered (optional) | |
| ritual_context | No | The active ritual or self-model anchor this trace relates to (e.g. 'ritual:wake_up_anchor') | |
| spatial_context | No | Code locus as file.rs:line (e.g. store.rs:706). Absolute paths normalized to file.rs:line. File-only accepted with soft warning; ENGRAM_REQUIRE_LINE_CONTEXT=1 hard-rejects missing :line. | |
| related_entities | No | Comma-separated list of related concepts (spatial AST nodes, ritual anchors, conv:arc, etc.) | |
| alternatives_considered | No | Alternatives that were seriously evaluated and why they were set aside (optional but strongly recommended) |