1.2 KiB
1.2 KiB
LEARNINGS.md - Mistakes & Lessons
Purpose: Append-only log of mistakes, bugs, and lessons learned. Review monthly.
2026-02-22: Memory Optimization Implementation
Lesson: BOOT.md vs BOOTSTRAP.md
Mistake: Initially confused about boot file naming. Reality: BOOTSTRAP.md is correct (one-time setup), BOOT.md is unrecognized. Fix: Verified only BOOTSTRAP.md exists, left it alone per AGENTS.md instructions.
Lesson: Skills Audit Required
Mistake: 58 skills loaded but many unused (iOS-specific skills when mainly doing web). Reality: Each unused skill burns tokens in system prompt. Fix: Documented active skills, archived unused ones to knowledge base.
2026-02-20: Mission Control Database Design
Lesson: Table Prefixes Critical
Mistake: Initially considered tables without project prefixes.
Reality: All Vercel apps share one Supabase - collisions possible.
Fix: Enforced <project>_<table> naming convention with underscores.
Format Template
## YYYY-MM-DD: [Brief Title]
### Lesson: [What was learned]
**Mistake:** [What went wrong]
**Reality:** [What actually happened]
**Fix:** [How it was resolved]