/remnic-memory-workflow

name: remnic-memory-workflow
description: Shared memory workflow for Claude Code agents connected to Remnic — recall before acting, observe during work, remember at the end. Trigger phrases include "what do you remember about", "save this for later", "any context from last time".
disable-model-invocation: true
allowed-tools:
  - remnic_recall
  - remnic_memory_store
  - remnic_lcm_search
  - remnic_entity_get
  - remnic_observe

When to use

Use this skill as the default playbook whenever Claude Code picks up a task that could benefit from prior context, or when the user explicitly asks the agent to remember or recall something. The individual `remnic-recall`, `remnic-remember`, `remnic-search`, `remnic-entities`, and `remnic-status` skills implement the detailed steps.

Triggers:

• New ticket, branch, or task begins.
• "What do you remember about …"
• "Save this for later."
• Long-running turn produces a durable outcome worth capturing.

Inputs

• Current user request (natural language).
• Optional: active project path, ticket number, branch name.
• Optional: topic keywords surfaced earlier in the session.

Procedure

1. **Recall first.** Call `remnic_recall` with a concise natural-language query built from the user's request. Pull 3–8 results and filter for relevance. 2. **Mention relevant memories briefly** to the user when they change the plan; otherwise use them as quiet context. 3. **Observe during work.** For significant tool results (Write/Edit/MultiEdit, Bash exits, test output) call `remnic_observe` so Remnic keeps its ambient context fresh. 4. **Deep search on demand.** If `remnic_recall` missed something the user insists exists, fall back to `remnic_lcm_search` with a more literal phrase. 5. **Browse entities.** When the user names a project, person, or concept, call `remnic_entity_get` to pull facts and relations. 6. **Remember at the end.** Before ending the turn, store durable decisions, preferences, and findings via `remnic_memory_store`.

Efficiency plan

• One broad recall beats several narrow ones.
• Skip recall for trivially local tasks (formatting, arithmetic, mechanical refactors).
• Reuse recall results within the same turn.
• Store each memory once; update rather than duplicate.

Pitfalls and fixes

• **Pitfall:** Storing transient state. **Fix:** Only store facts with durable value.
• **Pitfall:** Leaking secrets. **Fix:** Redact credentials and tokens before calling `remnic_memory_store`.
• **Pitfall:** Flooding the user with recalled context. **Fix:** Summarize in 1–3 bullet points.
• **Pitfall:** Forgetting the final write. **Fix:** Make "remember the decision" the last step of any non-trivial turn.

Verification checklist

• [ ] Recall was attempted before the agent committed to a plan.
• [ ] User-facing mentions of recalled context were concise and relevant.
• [ ] Durable decisions and findings were stored via `remnic_memory_store`.
• [ ] No secrets, credentials, or transient state were written.
• [ ] Canonical `remnic_*` tool names were used over legacy aliases.

> Tool names: this skill uses the canonical `remnic_*` MCP tools. Legacy `engram_*` aliases remain accepted during v1.x for backward compatibility.