Smux Compozy Pairing

Procedures

Step 1: Validate inputs and build the launch plan

1. Require a feature name that resolves to .compozy/tasks/<feature-name>/.
2. Execute eval "$(python3 .agents/skills/smux-compozy-pairing/scripts/render-session-plan.py --feature-name "<feature-name>" --repo-root "$PWD")" to load the emitted shell assignments into the current shell.
3. Confirm that tmux, tmux-bridge, codex, claude, and compozy are available in PATH.
4. Read references/runtime-contract.md before launching the worker TUIs.
5. Treat "$CODEX_LAUNCH" and "$CLAUDE_LAUNCH" as authoritative. The helper already injects a Codex workflow overlay via developer_instructions and a Claude workflow overlay via --append-system-prompt-file.
6. Prefer the shell wrappers under scripts/ when you need a concrete command string:
   • scripts/print-session-command.sh --feature-name "$FEATURE_NAME" --repo-root "$REPO_ROOT" --kind codex-launch
   • scripts/print-session-command.sh --feature-name "$FEATURE_NAME" --repo-root "$REPO_ROOT" --kind claude-launch
   • scripts/print-session-command.sh --feature-name "$FEATURE_NAME" --repo-root "$REPO_ROOT" --kind start
   • scripts/run-codex-worker.sh --feature-name "$FEATURE_NAME" --repo-root "$REPO_ROOT"
   • scripts/run-claude-worker.sh --feature-name "$FEATURE_NAME" --repo-root "$REPO_ROOT"
   • scripts/run-compozy-start.sh --feature-name "$FEATURE_NAME" --repo-root "$REPO_ROOT"