main.zig was 1,174 lines doing env parsing, component init, signal handling, and the entire HTTP API. now main.zig is 265 lines (entry point + wiring) and api.zig has all handlers, response helpers, and query string parsing. adds docs/design.md covering data flow, threading model, memory model, persistence, and an honest scaling limits table for 10x growth. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>