Decision
Claude Code build agents run on a Linux VPS (currently Hetzner) under tmux, with each project assigned a dedicated git worktree. They do NOT run on Windows, in a Docker container, in Vercel Sandbox, in GitHub Actions, or in any other environment.
Rationale
- tmux + git worktrees give us per-agent isolation with shared filesystem visibility (the orchestrator can read
.orchestrator/* in each worktree).
- Vercel Sandbox was evaluated and rejected: cold-start cost, cgroup limits incompatible with long-running agents.
- Windows was rejected: path-separator and exec-bit issues throughout the agent-playbook bash scripts.
Scope
- Agent code may assume Linux:
/bin/bash, GNU coreutils, POSIX find.
- Tests for agent-playbook bin/ scripts may use bash-only constructs; portable-shell is a non-goal.
- Mission Control and the orchestrator daemon code remain cross-platform (they may be developed on Windows or macOS).
Reference
- Workspace CLAUDE.md hard constraint