Dejavu

Deja Vu

Persistent memory for Claude Code mistakes.

Claude Code forgets everything between sessions. You fix a mistake, close the session, start a new one, and Claude makes the same mistake again. Wrong approach. Ignored the docs. Confidently wrong about something it was confidently wrong about last time.

I started tracking these in a `LEARNINGS.md` file and it grew to hundreds of lines of painful lessons. I hoped Claude would pay attention to it, but it never did. Then I found [EveryInc's Compound Engineering](https://github.com/EveryInc/compound-engineering-plugin) plugin, which solves this exact problem. It's pretty neat, but it felt heavy: YAML schemas, category directories, npm packages. I wanted something simpler.

Deja Vu is two things:

1. /dejavu is a slash command you run after Claude screws up (and it will, over and over again). It captures what happened, tags it, and writes it to LEARNINGS.md.
2. "facepalm" is a word you type when Claude is doing something dumb again. Claude stops what it's doing, searches its file of shame for the relevant lesson, and course-corrects on the spot.

That's it. One file, freeform tags, and grep.

Install

# 1. Copy the slash command (capture mode)
cp dejavu.md ~/.claude/commands/

# 2. Create your learnings file
cp LEARNINGS-template.md ~/.claude/LEARNINGS.md

Then add this to your `CLAUDE.md` so Claude knows what "facepalm" means:

## Rules

When the user says "facepalm":
STOP. Something you're doing has been done wrong before.
Search ~/.claude/LEARNINGS.md for error messages, symptoms, or keywords
from whatever just went wrong. Show matching entries. If a past lesson
applies, follow it immediately.

Before starting any task, check LEARNINGS.md for relevant past mistakes.

Two behaviors, three files.

Usage

**After Claude screws up:**

/dejavu                        # Full reflection (5 questions)
/dejavu "auth migration"       # Specific topic
/dejavu --quick