feat: add orchestration workflows and harness skills

scripts/orchestrate-codex-worker.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -ne 3 ]]; then
+  echo "Usage: bash scripts/orchestrate-codex-worker.sh <task-file> <handoff-file> <status-file>" >&2
+  exit 1
+fi
+
+task_file="$1"
+handoff_file="$2"
+status_file="$3"
+
+timestamp() {
+  date -u +"%Y-%m-%dT%H:%M:%SZ"
+}
+
+write_status() {
+  local state="$1"
+  local details="$2"
+
+  cat > "$status_file" <<EOF
+# Status
+
+- State: $state
+- Updated: $(timestamp)
+- Branch: $(git rev-parse --abbrev-ref HEAD)
+- Worktree: \`$(pwd)\`
+
+$details
+EOF
+}
+
+mkdir -p "$(dirname "$handoff_file")" "$(dirname "$status_file")"
+write_status "running" "- Task file: \`$task_file\`"
+
+prompt_file="$(mktemp)"
+output_file="$(mktemp)"
+cleanup() {
+  rm -f "$prompt_file" "$output_file"
+}
+trap cleanup EXIT
+
+cat > "$prompt_file" <<EOF
+You are one worker in an ECC tmux/worktree swarm.
+
+Rules:
+- Work only in the current git worktree.
+- Do not touch sibling worktrees or the parent repo checkout.
+- Complete the task from the task file below.
+- Do not spawn subagents or external agents for this task.
+- Report progress and final results in stdout only.
+- Do not write handoff or status files yourself; the launcher manages those artifacts.
+- If you change code or docs, keep the scope narrow and defensible.
+- In your final response, include exactly these sections:
+  1. Summary
+  2. Files Changed
+  3. Validation
+  4. Remaining Risks
+
+Task file: $task_file
+
+$(cat "$task_file")
+EOF
+
+if codex exec -p yolo -m gpt-5.4 --color never -C "$(pwd)" -o "$output_file" - < "$prompt_file"; then
+  {
+    echo "# Handoff"
+    echo
+    echo "- Completed: $(timestamp)"
+    echo "- Branch: \`$(git rev-parse --abbrev-ref HEAD)\`"
+    echo "- Worktree: \`$(pwd)\`"
+    echo
+    cat "$output_file"
+    echo
+    echo "## Git Status"
+    echo
+    git status --short
+  } > "$handoff_file"
+  write_status "completed" "- Handoff file: \`$handoff_file\`"
+else
+  {
+    echo "# Handoff"
+    echo
+    echo "- Failed: $(timestamp)"
+    echo "- Branch: \`$(git rev-parse --abbrev-ref HEAD)\`"
+    echo "- Worktree: \`$(pwd)\`"
+    echo
+    echo "The Codex worker exited with a non-zero status."
+  } > "$handoff_file"
+  write_status "failed" "- Handoff file: \`$handoff_file\`"
+  exit 1
+fi