# 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

```markdown
## YYYY-MM-DD: [Brief Title]

### Lesson: [What was learned]
**Mistake:** [What went wrong]
**Reality:** [What actually happened]
**Fix:** [How it was resolved]
```