Dev Server Healer

Overview

Bring a dev server up cleanly using a repeatable loop: start it, wait for logs, extract actionable errors, fix them, restart, and stop only when logs are clean and the app URL is available.

Workflow (loop until clean)

1. Confirm context

   • Identify repo root and the correct dev command.
   • If the repo has an AGENTS.md, read it and follow its guidance.
   • Ask for missing prerequisites (env vars, secrets, services) early.

2. Run diagnostics first (when available)

   • Prefer quick diagnostics to surface environment or dependency issues before starting the server.
   • Use JSON or verbose modes when parsing results.

3. Start required services

   • Start any docker-compose or service dependencies noted by the repo instructions.

4. Start dev server

   • Run the repo's dev command from the correct directory.