agent-orchestrator.yaml.example

# Agent Orchestrator Configuration
# Copy to agent-orchestrator.yaml and customize.

# Where to store session metadata
dataDir: ~/.agent-orchestrator

# Where to create workspaces (git worktrees, clones)
worktreeDir: ~/.worktrees

# Web dashboard port
port: 3000

# Terminal server ports (defaults: 14800/14801 — chosen to avoid conflicts with dev tools)
# Override when running multiple dashboards to avoid EADDRINUSE
# terminalPort: 14800
# directTerminalPort: 14801

# Default plugins (these are the defaults — you can omit this section)
defaults:
  runtime: tmux           # tmux | process | docker | kubernetes | ssh | e2b
  agent: claude-code      # claude-code | codex | aider | goose | custom
  # CLI-keyed model defaults (preferred over a single global model)
  # modelByCli:
  #   claude-code:
  #     model: claude-sonnet-4-20250514
  #     orchestratorModel: claude-opus-4-20250514
  #   codex:
  #     model: gpt-5-codex
  #   cursor:
  #     model: composer-2
  # orchestrator:
  #   agent: claude-code
  # worker:
  #   agent: codex
  workspace: worktree     # worktree | clone | copy
  notifiers: [desktop, openclaw]    # desktop | slack | discord | webhook | email | openclaw

# NOTE: agentRules is only supported under projects.<name>.agentRules (not under defaults).
# The evidence guidance below is shown in the supported project-scoped location.
# bd-n047: Centralized auto-merge control — applied to all projects unless overridden.
# Set enabled: false here to disable auto-merge globally, then selectively re-enable per project.
# Per-project overrides: set projects.<name>.autoMerge.enabled to override the global default.
# autoMerge:
#   enabled: true          # set to false to globally disable auto-merge
#   waitSeconds: 300      # default wait time for GitHub's native auto-merge
#   mergeMethod: squash   # default merge method (merge | squash | rebase)

# Projects — at minimum, specify repo and path
projects:
  my-app:
    name: My App
    repo: org/my-app
    path: ~/my-app
    defaultBranch: main
    sessionPrefix: app

    # Fix 2 (bd-4ze23): PR evidence media — user-scope skills (live under ~/.claude/skills/, not this repo).
    agentRules: |
      Evidence / PR body (integration+ claim classes — integration, pipeline-e2e, pr-lifecycle-e2e, merge-gate, or higher):
      - Before creating or updating a PR body, run the user-scope `tmux-video-evidence` skill at `~/.claude/skills/tmux-video-evidence/` to capture **Terminal media** as a captioned HTTPS URL to a real artifact (prefer .mp4/.gif/.webm/.mov/.cast, gist.github.com, asciinema.org, or user-attachments); unknown URLs may still pass CI with a warning (bd-vidcap). Caption must mention tmux or terminal.
      - If the PR changes `.tsx`, `.jsx`, `.vue`, or `.svelte`, include **UI media** as a captioned HTTPS video URL (.mp4/.gif/.webm/.mov or GitHub user-attachments), or exact `N/A - no UI changes`.
      - For integration+ claims, also run `smoke-test-local` at `~/.claude/skills/smoke-test-local/` when a local smoke flow applies.
      - Never write `N/A` for **Terminal media** on code-change PRs when the claim class is integration or higher.

    # Issue tracker (defaults to github issues)
    # tracker:
    #   plugin: linear
    #   teamId: "your-team-id"

    # SCM webhook acceleration (optional)
    # scm:
    #   plugin: github
    #   webhook:
    #     path: /api/webhooks/github
    #     secretEnvVar: GITHUB_WEBHOOK_SECRET
    #     signatureHeader: x-hub-signature-256
    #     eventHeader: x-github-event
    #     deliveryHeader: x-github-delivery
    #     maxBodyBytes: 1048576

    # Files to symlink into workspaces
    # symlinks: [.env, .claude]

    # Commands to run after workspace creation
    # postCreate:
    #   - "pnpm install"

    # Agent-specific config
    # agentConfig:
    #   permissions: skip    # --dangerously-skip-permissions
    #   model: opus

    # Per-project CLI-keyed model overrides (wins over defaults.modelByCli)
    # modelByCli:
    #   codex:
    #     model: gpt-5-codex

    # Optional role-specific agent overrides
    # orchestrator:
    #   agent: claude-code
    #   agentConfig:
    #     model: claude-sonnet-4-5
    # worker:
    #   agent: codex
    #   agentConfig:
    #     model: gpt-5-codex

    # Inline rules included in every agent prompt for this project
    # agentRules: |
    #   Always run tests before pushing.
    #   Use conventional commits (feat:, fix:, chore:).
    #   Before spawning new work or making GitHub API calls, check `gh api rate_limit`.
    #   If graphql.remaining < 100, use REST fallback exclusively.
    #   If core.remaining < 500, defer non-critical reads.
    #   Before dispatching multiple workers, check `tmux list-sessions | wc -l` and do not spawn if active sessions > 20.

    # Path to a rules file (relative to project path)
    # agentRulesFile: .agent-rules.md

    # Rules for the orchestrator agent (reserved for future use)
    # orchestratorRules: |
    #   Prefer to batch-spawn related issues together.

    # Pollers — scan external systems for work and spawn fix sessions
    # bd-awq: PR poller scans GitHub for non-green PRs and spawns sessions.
    # Respawn cap: max 10 sessions per PR per 12-hour window (prevents spam).
    # pollers:
    #   github-pr:
    #     type: github-pr              # Poller plugin type
    #     enabled: true                # Enable this poller
    #     interval: 5m                 # Poll interval (e.g., 1m, 5m, 10m, 1h)
    #     agent: claude               # Agent plugin name (e.g., claude, codex) — omit to use default
    #     promptTemplate: |            # Prompt template for spawned sessions (optional)
    #       Fix the GitHub PR: {{url}}
    #       PR: {{title}}
    #       Session ID: {{id}}         # Supported: {{url}}, {{title}}, {{id}}
    #     respawnCap:
    #       max: 10                    # Max 10 sessions per PR
    #       window: 12h                # Per 12-hour window

    # OpenCode issue session strategy (only for agent: opencode)
    # opencodeIssueSessionStrategy: reuse   # reuse | delete | ignore

    # Per-project reaction overrides
    # reactions:
    #   approved-and-green:
    #     auto: true         # enable auto-merge for this project
    #   worker-signals-completion:
    #     auto: true
    #     action: skeptic-review
    #     skepticModel: codex
    #     skepticPostComment: true

    # bd-n047: Per-project auto-merge override — set enabled: false to disable
    # for this project while keeping it enabled globally, or set enabled: true
    # to re-enable even when defaults.autoMerge.enabled is false.
    # autoMerge:
    #   enabled: false

  # Fork: jleechanorg/agent-orchestrator — builtin manager evolve loop (bd-elcfg).
  # Mirror under projects.agent-orchestrator in ~/.openclaw/agent-orchestrator.yaml when self-hosting.
  # Template: see projects.jleechanclaw.evolveLoop in the same file for a fuller scope list (e.g. antig-dispatch).
  agent-orchestrator:
    name: Agent Orchestrator
    repo: jleechanorg/agent-orchestrator
    path: ~/projects_reference/agent-orchestrator
    defaultBranch: main
    sessionPrefix: ao
    # evolveLoop — opt-in per project; injects evolve-loop instructions into the orchestrator prompt when enabled: true.
    # Kill switch: EVOLVE_LOOP_ENABLED=false disables all projects. See docs/design/manager-evolve-loop-design.md
    evolveLoop:
      enabled: true
      pollCadence: lightweight # lightweight | standard | fast
      autonomousFixScopes:
        - config-edit # agentRules / reaction YAML edits
        - claw-dispatch # ao spawn for fixes
        - bead-create # beads create/update via tracker
      blockedScopes: [] # e.g. bead-delete — extra denials beyond global deny list
      knowledgeBaseDir: ~/.ao-evolve-knowledge # expanded by config loader
      zeroTouchWindow: 24h # anomaly window for MEASURE phase (e.g. 24h, 7d)

# Notification channels
# notifiers:
#   slack:
#     plugin: slack
#     webhook: ${SLACK_WEBHOOK_URL}
#     channel: "#agent-updates"
#
#   openclaw:
#     plugin: openclaw
#     url: http://127.0.0.1:18789/hooks/agent   # default — omit to use this value
#     token: ${OPENCLAW_HOOKS_TOKEN}              # or set OPENCLAW_HOOKS_TOKEN env var
#     sessionKeyPrefix: "hook:ao:"
#     wakeMode: now                               # now | next-heartbeat
#
# OpenClaw server requirements (set in your openclaw.yaml or env):
#   hooks:
#     enabled: true
#     allowRequestSessionKey: true
#     allowedSessionKeyPrefixes: ["hook:"]
#   Environment: OPENCLAW_HOOKS_TOKEN=<your-token>

# Notification routing by priority
# notificationRouting:
#   urgent: [desktop, openclaw]   # agent stuck, needs input, errored
#   action: [desktop, openclaw]   # PR ready to merge
#   warning: [openclaw]           # auto-fix failed
#   info: []                      # summary, all done

# Reactions — auto-responses to events (these are the defaults)
# reactions:
#   ci-failed:
#     auto: true
#     action: send-to-agent
#     retries: 2
#     escalateAfter: 2
#
#   changes-requested:
#     auto: true
#     action: send-to-agent
#     escalateAfter: 30m
#
#   merge-conflicts:
#     auto: true
#     action: send-to-agent
#     message: "Resolve merge conflicts and push the resolution."
#     retries: 3
#     escalateAfter: 1h
#
#   approved-and-green:
#     auto: false              # set to true for auto-merge
#     action: notify
#     priority: action
#
#   agent-stuck:
#     threshold: 10m
#     action: notify
#     priority: urgent

# =============================================================================
# TECHNIQUE SELECTION — AO library (autor research: all techniques converge)
# =============================================================================
# All 9 autor techniques converge within rubric noise (~80-85 CI overlap).
# SR-prtype (Self-Refine with PR-type classification) is the safe default (84.45, n=16).
# Per-type routing requires statistically significant matched-PR evidence — none proven yet.
#
# NOTE: This block belongs under a projects.<name> stanza, not at the document root.
# Example (root-level config does NOT activate technique routing — it is documentation only):
# projects:
#   agent-orchestrator:
#     technique:
#       default: SR-prtype
#
# technique:
#   default: SR-prtype  # safe default — all techniques converge, no routing justified
#   # Per-type overrides (none proven — all converge within rubric noise)
#   # perType:
#   #   data-norm: SR-prtype  # was SR-fewshot in error; corrected 2026-04-21
#   # thresholds:
#   #   minScoreDiff: 2.0    # minimum delta before switching from default
#   #   confidenceN: 10     # matched PR evaluations needed before override enabled