| name | remember |
| description | Store a fact, decision, or instruction into the right context file. Project-scoped facts go to .claude/primitives/. Global facts (coding rules, workflow patterns, skill knowledge) go to ~/.claude/ files. Use when the user says 'remember', 'note that', 'add to context', 'don't forget', or wants something saved for future sessions. Auto-detects scope. |
| allowed-tools | Read, Edit, Glob |
Remember
Zero-friction memory. Say it, the agent stores it in the right place — project or global — automatically.
Step 1: Detect Scope
Every fact is either project-scoped or global. This determines which files get read and written.
| Signals | Scope |
|---|
| This project's stack, deploy commands, scripts, ports, env vars, current work, conventions | Project |
| Coding rules ("always do X", "never do Y"), workflow patterns, how to use skills, decision rules, default tech choices | Global |
| A skill that exists or how to find it | Global (→ skills/AGENTS.md) |
| Ambiguous | Ask the user: "Should this be project-specific or global (applies to all projects)?" |
Step 2: Read (scope-dependent)
Project scope
Read these files. Requires /scaffold-project to have been run first — if .claude/primitives/ doesn't exist, warn and stop.
