What problem does it solve? Local development stacks fail in confusing ways: stale ports, unsupervised processes, migration guards blocking startup, and schema drift. This Skill provides a canonical runbook for starting, diagnosing, and recovering the Multica local dev environment so you spend time coding instead of fighting infrastructure. ## Core Features & Use Cases - Supervised Startup: Uses make dev as the canonical path with defined port contracts (frontend 3500, backend 3501, postgres 3502, daemon 3503) and health-check verification. - Guarded Migration Recovery: Walks through the 103_drop_legacy_daily_rollups guard failure, including the backfill_task_usage_hourly recovery procedure and correct upgrade ordering. - Failure Diagnosis: Covers port-conflict cleanup, split-state detection (processes running outside make dev supervision), Postgres routing checks, and frontend CPU/memory profiling. - Use Case: Your make dev run fails with listen tcp :3501: bind: address already in use. Follow the Skill to identify the owning process, confirm which checkout owns it, clean up safely, and restart under supervision. ## Quick Start Start the local Multica stack with make dev and verify all health endpoints using this skill's checklist.
