The AI Amnesia Fix - Starter Kit
by Eric McCormick
$5
Every AI coding session starts the same way: you re-explain the database schema, remind it about the auth decision you already made, and warn it not to touch the files you refactored yesterday. Fifteen minutes gone before any real work happens.
This kit fixes that.
What's inside:
CLAUDE.md starter template — A production-tested instruction file that tells your AI to read a session briefing before doing anything. Includes sections for project context, architecture decisions, off-limits files, and behavioral rules. Works with Claude Code out of the box. Rename for Cursor (.cursorrules) or Windsurf (.windsurfrules).
brain-resume.sh — A shell script that generates a session briefing from your git history, queued messages, working tree status, and active context. Run it at session start and your AI knows what happened, what's pending, and what changed.
brain-message.sh — Queue messages between sessions. "Fix the login bug." "The deploy needs the new env var." "Shipped the API refactor." Messages show up in the next session's briefing automatically.
brain-checkpoint.sh — Save mid-session state before risky operations or at end of day. Captures git status, recent commits, and your notes. Picks up where you left off.
active-context.md — A template for tracking your current focus, recent decisions, open questions, and scope boundaries. Your AI reads this every session so it knows what you're building and what's off-limits.
Setup guide — Step-by-step instructions. 30 minutes from download to working sessions. Includes optional Claude Code hook configuration for automatic briefings.
Requirements:
Claude Code, Cursor, Windsurf, or any AI tool that reads project files
Git
Bash (macOS, Linux, or WSL)