foreman

Global orchestration for Claude Code + Codex CLI (and Conductor / T3 Code). Tuned for dual Max plans — Fable writes the code; Sol is parallel volume and independent GPT review; Opus is constrained taste/UI/security.

• Claude side: Fable 5.1 manages at high (locked). Dispatches Fable 5.1 @ high for implement, Opus 5 @ high for taste/review/security, Sol for parallel/mechanical, Luna for PR watch.
• Codex side: Sol manages. Same ladder — Fable 5.1 for implement, Opus 5 for taste/security, Sol workers for fan-out, Luna for PR watch.

ROLE: WORKER on every dispatch prevents delegation loops. --model fable is Fable 5.1.

Worker ladder

Lane	Model + effort
Manager (Claude Code)	fable-5.1 + high (locked)
Manager (Codex)	sol
Small edit	yourself
Scoped feature / debug	fable-5.1 + high
Taste / UI / stay-in-spec	opus-5 + high
Bulk / mechanical	sol + low
Parallel fan-out	sol + xhigh / ultra
Independent GPT review	sol + xhigh
PR first-wave watch	luna + low
Security / cyber / bio	opus-5 + high
Judgment / architecture	fable-5.1 + high

No Terra, Sonnet, Haiku, Grok, or ultracode for dispatched workers. Luna only for PR watch.

What's in here

Path	Installs to
CLAUDE.md	~/.claude/CLAUDE.md
skills/codex-implementation/	~/.claude/skills/codex-implementation/
skills/codex-review/	~/.claude/skills/codex-review/
skills/pr-watch/	~/.claude/skills/pr-watch/
codex/AGENTS.md	~/.codex/AGENTS.md
codex/skills/dispatch-workers/	~/.codex/skills/dispatch-workers/
codex/skills/cross-review/	~/.codex/skills/cross-review/
codex/skills/pr-watch/	~/.codex/skills/pr-watch/

Setup on a new machine

Set up my foreman orchestrator config from https://github.com/kgarg2468/foreman

1. Clone: `gh repo clone kgarg2468/foreman` → ~/Documents/Projects/foreman

2. Prerequisites (report anything missing):
   - `claude` and `codex` CLIs installed + authenticated
   - `git` available

3. Symlink install:
   - Back up existing ~/.claude/CLAUDE.md / ~/.codex/AGENTS.md if non-empty
   - ln -sf <repo>/CLAUDE.md ~/.claude/CLAUDE.md
   - mkdir -p ~/.claude/skills ~/.codex/skills
   - ln -sfn <repo>/skills/codex-implementation ~/.claude/skills/codex-implementation
   - ln -sfn <repo>/skills/codex-review ~/.claude/skills/codex-review
   - ln -sfn <repo>/skills/pr-watch ~/.claude/skills/pr-watch
   - ln -sf <repo>/codex/AGENTS.md ~/.codex/AGENTS.md
   - ln -sfn <repo>/codex/skills/dispatch-workers ~/.codex/skills/dispatch-workers
   - ln -sfn <repo>/codex/skills/cross-review ~/.codex/skills/cross-review
   - ln -sfn <repo>/codex/skills/pr-watch ~/.codex/skills/pr-watch

4. Smoke Sol + Luna workers:
   codex exec -m gpt-5.6-sol --sandbox read-only --skip-git-repo-check \
     -c model_reasoning_effort="low" "Reply with exactly one word: READY" < /dev/null
   codex exec -m gpt-5.6-luna --sandbox read-only --skip-git-repo-check \
     -c model_reasoning_effort="low" "Reply with exactly one word: READY" < /dev/null

5. Smoke contracts:
   claude -p --model opus --effort high "In one sentence: per global instructions, default
   implement worker model+effort, and manager effort lock?" < /dev/null
   Expected: fable-5.1 at high; manager high locked.
   codex exec -m gpt-5.6-sol --sandbox read-only --skip-git-repo-check \
     -c model_reasoning_effort="low" "In one sentence: your role and default implement lane?" < /dev/null
   Expected: orchestrator; fable-5.1 at high for scoped implement.

6. Smoke ROLE: WORKER — same Sol prompt prefixed with ROLE: WORKER → says worker, no delegate.

7. Report results.

Notes

• Codex config.toml defaults are per-machine; contracts always set model/effort explicitly.
• --model fable resolves to Fable 5.1; --model opus resolves to Opus 5.
• Dual-Max: Fable implements; Sol parallels and cross-reviews.
• Opus 5 over-scopes and Fable 5.1 over-runs at extra-high — scope fence is mandatory; prefer high.
• Do not /model-toggle mid-session (kills cache); dispatch workers instead.
• On Max, Fable can use at most 50% of the weekly Claude pool; if that slice is gone, fall back to Opus for implement.