# Lessons Learned
*What went wrong, what worked, what to do differently. Fed back into agent profiles.*

## 2026-02-07
- Kimi sub-agents sometimes web search instead of reading local files — always include explicit file paths in task prompts
- Sub-agents need explicit repo paths (/home/ccuser/the-50-dollar-app) — they don't inherit workspace context
- Error boundary agent worked well when given clear scope and existing component patterns to match
- **CRITICAL FAILURE:** Heartbeats returned HEARTBEAT_OK for 2 hours while 15+ open tasks existed. Root cause: treated "empty inbox" as "nothing to do" instead of scanning TODO.md for open items. Fix: added hard rule — MUST spawn agents when open tasks exist. Never be passive when work is available.

