MEMORY.md
Great Minds Agency -- Shared Memory
Agency Knowledge
Project History
Key Learnings
Dispatch
- tmux send-keys dispatch FAILED -- unreliable, agents get stuck, no error recovery
- Agent tool with worktree isolation WORKS -- safe parallel execution, clean git state per agent
- Each agent gets its own worktree branch; merges happen through PRs
Architecture
- Decoupled crons (bash + haiku) prevent bottleneck -- never run crons inside conversations
- In-memory state always loses data -- persist to DB, never use Maps for production state
- Hybrid AI router: Cloudflare Workers AI for fast/cheap, Claude for complex
Process
- 2 debate rounds is the sweet spot -- enough to align, not so many it wastes cycles
- Establish canonical personas/facts as shared doc BEFORE parallel build
- Board of Directors pattern: 4 advisors + 1 tie-breaker (Marcus) works better than single reviewer
- GSD integration: wave-based execution with fresh context prevents context rot
- Feature branch workflow MANDATORY: all agents use branches + PRs, no direct pushes to main
Content & Products
- Honesty pass: never market features that don't exist
- Shared Header/Footer in root layout prevents orphan pages
- Remotion for product videos -- 5 rendered, pipeline proven
- WordPress plugins (Dash, Pinned) ship faster in their own repos
Agent Economics
- Haiku for sub-agents: conserves usage limits ~5x
- Only directors and orchestrator need Sonnet-class models
- 14 agents is current ceiling -- more creates coordination overhead