What problem does it solve?
Maintain a per-repo napkin file that tracks mistakes, corrections, and what works. This living document activates every session, unconditionally. Read the napkin before doing anything, and write to it continuously as you work — not just at session boundaries. Log your own mistakes, not just user corrections. The napkin lives in the repo at .scratch/napkin.md.
Core Features & Use Cases
- Always-on memory: napkin is read at session start and updated continuously as you work.
- Structured sections: Corrections, User Preferences, Patterns That Work, Patterns That Don't Work, and Domain Notes help you organize lessons and decisions.
- Local provenance: the napkin lives in your repository for versioning and collaboration.
- Adaptable to any project: redesign sections to fit the repo's domain and workflow.
Quick Start
Create or open the file .scratch/napkin.md in your repository at the start of each session and begin logging notes continuously.