capture

capture

The capture organ. Writes stored memory for future discovery; the memory format and kind taxonomy live in the format spec below.

Prerequisite — load the format spec

Before classifying or writing anything, Read ~/.claude/claude-md/memory-capture.md (the frontmatter template, kind table, folder layout, and capture rules). It is not always-on context — it loads here, on demand, only when capture actually runs. Every reference to claude-md/memory-capture.md below assumes you have read it this turn.

When to run

• User types /capture [content] (explicit trigger).
• User says "remember that…", "save this as a memory," "capture this lesson."
• Another skill invokes capture programmatically (e.g. review's user-correction feedback loop).
• High-stakes auto-propose. Claude proposes a capture unprompted — at the moment it happens, mid-session — when a genuinely high-stakes item surfaces: (a) a decision that reverses or supersedes a prior shipped decision; (b) a correction the user phrases with finality ("never do X again", "this is the rule now"); (c) a kind: warning-shaped event ("I did X, it broke Z, hard to undo"). This is auto-propose, never auto-write — the standard accept/edit/reject (§7) still gates every write, so the collaborator principle holds. Fire on the event, not at session close — deferring to /recap loses it when no recap runs. Keep it rare: only the three shapes above; never auto-propose ordinary lessons.
• Otherwise do not auto-fire. No session-start or per-turn triggers. Mode B (silent episodic auto-write) stays parked — see the auto-propose bullet above.

Inputs

1. Content source.
   • Text passed after /capture → that text is the candidate rule / lesson / fact.
   • No arguments → infer content from the most recent user/assistant turns. If multiple recent turns could be the capture target, ask one clarifying question rather than guessing.
2. Triggering context. What in the session made this worth capturing — a correction, a decision, a surprise, a pattern. Use this to decide kind and to write the Why: line.
3. Target project. $CLAUDE_PROJECT_DIR if set, otherwise current working directory. Universal-applicable content may override to the global tree (see §"Universal vs project" below).