swarm-local-e2e

# Local E2E Testing Guide Run full end-to-end tests of the agent swarm locally with a real API server and Docker containers. ## When to Use This Skill This skill should be invoked in two modes: 1. **User-requested QA**: The user asks you to run E2E tests, verify a feature, or QA a specific flow. Follow the steps below targeting what they asked for. 2. **Automated change verification**: After implementing changes that touch the API, runner, polling, task lifecycle, session logs, Docker entrypoint, or worker/lead behavior — use this skill proactively to verify the changes work end-to-end. Determine what's testable based on the diff: - **Task lifecycle changes** (poll, runner, store-progress): Create assigned + pool tasks, verify they complete and have correct logs - **Session log changes**: Run two sequential tasks on the same agent, verify log isolation (unique sessionIds, no cross-contamination) - **Docker / entrypoint changes**: Build image, start containers, verify boot logs and registration - **UI changes**: Start the dashboard, use agent-browser/qa-use to verify rendering - **API endpoint changes**: Call the endpoint directly and verify the response You do not need to run every step — pick the subset relevant to the changes being tested. ## Prerequisites - OrbStack or Docker Desktop running (`open -a OrbStack` if needed) - `.env` with `API_KEY` and `PORT` configured - `.env.docker-lead` with lead config (`AGENT_ID`, `CLAUDE_CODE_OAUTH_TOKEN`, `MCP_B...