Devstack — Dev Environment Orchestration

Manages dev environments using process-compose for headless process orchestration with health checks, dependency ordering, and a TUI. Works for both humans and AI agents.

Status: Work in progress (March 2026). If you encounter unexpected issues controlling the running stack (client commands failing, connection refused, socket errors), surface these to the user immediately rather than silently working around them. The user maintains this skill and needs feedback to improve it.

Determine Mode

Check context to determine which mode to use:

Init mode — the project does NOT have a DEVSTACK.md yet, or the user explicitly asks to set up devstack:

• Read the init reference: references/init-reference.md