catalan-adobe/memory-triage

Memory Triage

Step 1: Discover Memory

Find the auto memory directory for the current project. Use the /memory slash command output or resolve it directly:

1. Get the project root: git rev-parse --show-toplevel (or use cwd if not in a git repo)
2. Encode the path: strip leading /, replace remaining / with -, prepend -
3. Memory lives at: ~/.claude/projects/<encoded-path>/memory/

Read MEMORY.md and every other .md file in that directory.

If the directory doesn't exist or contains no .md files with content:

"No auto memory found for this project. Nothing to triage."

Stop here.

Step 2: Classify Entries

Parse each file into distinct entries using markdown headers (#, ##, ###) and top-level bullet groups as boundaries.

Classify each entry as either a promote candidate or ephemeral. The core question: would a different developer benefit from knowing this?

See classification examples for detailed examples of each category.

When uncertain, classify as promote candidate. A false positive costs the user one "discard" decision. A false negative buries useful knowledge.

Step 3: Redact and Present Candidates

Before presenting, scan each candidate for secrets: API keys, tokens, passwords, connection strings, credentials, or any string matching common secret patterns (e.g., sk-..., ghp_..., Bearer ..., -----BEGIN). Replace values with [REDACTED]. Never surface raw secrets in conversation history.

Present candidates grouped by theme with rationale. See output formats for format.

If there are no promote candidates:

"All N entries look task-specific. Nothing to promote. Say 'show filtered' if you want to review them anyway."

Step 4: Triage Decisions

For each promote candidate, ask: promote or discard?

When promoting, ask where it should go:

• Project CLAUDE.md — ./CLAUDE.md or ./.claude/CLAUDE.md (whichever exists; prefer .claude/CLAUDE.md if neither exists)
• Rules file — .claude/rules/<topic>.md (suggest a topic name based on the entry's theme, e.g., debugging.md, ci.md)
• Global CLAUDE.md — ~/.claude/CLAUDE.md (for rules that apply across all projects on this machine)

Support batch decisions: if the user says "promote all debugging entries to rules/debugging.md", do it in one pass.

If the user asks to "show filtered", present the ephemeral entries with the same promote/discard options.

Step 5: Apply

For each promoted entry:

1. Read the target file if it exists.
2. Find an appropriate section to append the entry (match by existing header if one fits, otherwise append under a relevant new header).
3. Write the entry using the Edit tool (append) or Write tool (new file).
4. Do NOT modify or delete the source memory files.

Report a summary of promoted, discarded, and unchanged entries. See output formats for format.

Important Notes

• Read-only on memory files. Never modify or delete auto memory. Those files are managed by Claude Code and get cleaned up with worktree removal or project pruning.
• No automatic commits. The user decides when and how to commit. The skill only writes to target config files.
• Works anywhere. No worktree requirement. Triages whatever auto memory exists for the current project context.
• Hook-triggered invocations. This skill may be invoked automatically by a Stop hook after PR creation or branch completion. When that happens, proceed normally — the user is still in control of every promote/discard decision.