The recurring traps (a :has() rule slowing every canvas frame, fixes left on an unpushed local main, release checks, imports lost in a module split) are now docs/architecture/lessons.md, so the links from ARCHITECTURE.md, AGENTS.md and the docs indexes open for everyone. AGENTS.md: tests live in tests/, .agents stays a local folder for screenshots and logs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>