backlog_remember
Record stable facts, procedures, or preferences to recall in future sessions. Correct or update existing knowledge by superseding or state keys.
Instructions
Write a durable memory — a stable fact, a procedure, or a preference you should know next session. Use when you learn something worth keeping: "this repo deploys via wrangler", "Goga prefers terse evidence bullets". To CORRECT existing knowledge, pass supersedes (the old MEMO- id is expired, lineage kept) or state_key (previous holders of the same evolving fact are closed). The optional collision_candidates receipt is tri-state: [] means the advisory scan completed clean; a non-empty array means nearby facts deserve adjudication; absent means the advisory scan did not run or failed, not that the write failed. Do not use for task events — completions are captured automatically.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as | No | OPTIONAL agent identity for this write — an AGENT- doc id or declared principal (e.g. "aime:granite"). Values are trimmed; whitespace-only is treated as absent. | |
| home | No | Select the document home for this call. Overrides bridge defaults: global uses the user-wide home; project uses project_root or the bridge project. | |
| kind | No | Temporal kind: current fact / historical fact / future plan / preference / timeless (exempt from recency decay). | |
| tags | No | Freeform labels for filterable recall. | |
| layer | No | semantic = stable fact (default). procedural = how-to/process. episodic = a specific event worth keeping. | |
| title | Yes | Memory title (required, like a task title) — a short human-readable label for the fact. Title and body are both first-class. | |
| content | Yes | The memory body (markdown) — the fact itself. | |
| context | No | Scope container id (e.g. "FLDR-0001") — enables scoped recall and wakeup. | |
| derived | No | Mark as inference (consolidator output). Requires non-empty entity_refs citing the sources. | |
| state_key | No | Evolving-fact key (e.g. "build.bundler"). Storing a new memory with an existing key closes the previous holder. | |
| supersedes | No | MEMO- id this memory replaces. The predecessor is soft-expired. | |
| entity_refs | No | Source entities this knowledge derives from (e.g. ["TASK-0676"]). | |
| occurred_at | No | When the remembered event occurred — ISO date/datetime. Decay uses this instead of write time. | |
| valid_until | No | Expiry — ISO date/datetime. After this the memory drops out of recall. | |
| project_root | No | Project root for this call. Overrides the bridge project root and selects the project home. |