open-agent-teams

# open-agent-teams Run any CLI agent as an executor inside a detached tmux session. Communication is: prompt in via CLI arg / `send-keys`, completion out via a **file sentinel** the agent touches, summary out via a **result file** the agent writes. File sentinels are used instead of `tmux wait-for` because a `wait-for -S` with no waiter is silently lost; files never race and allow timeouts. All commands via the helper (make sure it runs from the skill dir): ``` SKILL_DIR/scripts/tdel ``` ## Initial setup (once per repo) If the repo's `CLAUDE.md` (or `AGENT.md`) has no delegation rules yet, add the contents of `references/CLAUDE.delegation-template.md` to it — it defines the coordinator/executor roles and the `ROLE: EXECUTOR` prompt marker used below. ## Workflow 1. **Start** an agent on a task: ``` tdel start <session> "<agent-cmd>" "<prompt>" # e.g. tdel start hello "claude --dangerously-skip-permissions" "make a hello world page" ``` This appends the done-protocol to the prompt automatically (write summary to result file, then `touch` the done file). 2. **Wait** for completion — ALWAYS via a background Bash task so you get woken up instead of blocking or polling: ``` tdel wait <session> [timeout-sec] # run with run_in_background: true ``` Exit 0 = done (prints the agent's summary). Exit 124 = timeout (prints last pane lines for diagnosis). Non-zero also if the session died. 3. **Review** the output (`tdel result <session>`, plus inspe...