feat(orchestrator): forge Atticus — first bearer of orchestrator soul template

Artifacts from the claude-prd-taskmaster gen1 → gen2 supervisor handoff.
Atticus is the archetype for multi-child orchestrators in this codebase.

Template (chezmoi-tracked): ~/.claude/templates/orchestrator-soul-template.md
Origin (project-tracked): this commit.

Memory entry at ~/.claude/projects/-home-anombyte-Shade-Gen-Projects-prd-taskmaster-v2-handoff-overhaul/memory/atticus_identity.md

Author: Hayden + Atticus.

Author: claude

docs/DEBRIEF-claude-prd-taskmaster-ash.md

@@ -0,0 +1,89 @@
+# Ash Debrief — claude-prd-taskmaster (supervisor session)
+
+**Timestamp**: 2026-04-16T10:43:17Z
+**Role**: Supervisor/orchestrator over Claude + Codex phoenix arms during plugin build
+**Status at ash**: Live, mid-supervision, 40 iterations in. Parent restarted once for MCP tool deployment. Both managed phoenixes still productive.
+
+---
+
+## What this session was
+
+The parent orchestrator for the `@atlas-ai/prd-taskmaster` + `@atlas-ai/atlas-coin` plugin builds. Ran `/atlas-ralph-loop:ralph-loop --max-iterations 100 --completion-promise SUPERVISOR_COMPLETE` with duties defined in `.claude/supervisor-loop-prompt.md`.
+
+## What it actually did (highest-signal deliverables)
+
+### Capabilities added to the platform
+- **atlas_session verifier DSL fix** — `_evaluate_pass_when` now supports bare-substring pass_when (fallback to literal `needle in haystack` with ANSI-strip + trim). Both authoritative + mirror source edited. 81/81 tests pass, 5 regression tests added. Deployed live.
+- **atlas_session create_bounty template fix** — atlas-coin API requires `template` ∈ `{ci, test_coverage, github, manual}`. Adapter was sending `soul_purpose`. Changed to `manual` + preserved soul_purpose in description/metadata. Schema now accepts. Settle still blocked on wallet `session-lifecycle` = 0 AC (separate issue).
+- **atlas-launcher session_respawn + mcp_reload tools** — new MCP tools at `atlas_launcher/server.py`. `session_respawn(session_name, backend, resume=True, model, ready_timeout)` captures cwd, kills tmux, relaunches with resume flag. `mcp_reload` auto-detects backend. Empirically tested both Claude + Codex preserve context. DEPLOYED post-parent-restart.
+- **codex-send.sh** — `/home/anombyte/bin/codex-send.sh SESSION "MSG"` — reliable Codex delivery handling (1) bash variable expansion (literal send-keys), (2) Codex "Working" state Tab-to-queue, (3) post-send fingerprint verification with auto-retry.
+- **auto-enter daemon regex extended** — added Codex patterns (`Reviewing approval request`, `Approve?`, `(y/n)`, `[y/N]`, `Allow command`, `Do you trust`, `waiting for approval`) + `SKIP_REGEX` for past-tense approvals. Chezmoi source + target both synced. Self-test flag added.
+
+### Patterns validated in live use
+- **Adversarial contract drafting** across 11+ contracts settled. Dominant failure modes caught: bare-substring pass_when (server bug), metachar sandbox rejections (`;`, `[`, `(`, `>=`), template-enum mismatch.
+- **Per-arm in-process adversarial drafter** — eliminates cross-session contamination. Codex arm pattern: Darwin → Cicero → Socrates named subagents (deprecated due to 2-5min MCP boot). Evolved to Hayden's **Claude-precision-for-Codex** pattern: Codex spawns dedicated Claude Opus 1M precision session whose only job is `inevitability-auditor` dispatches for criteria drafting. Cross-backend challenge preserved, boot overhead eliminated.
+- **Belt-and-suspenders auto-enter** — smart daemon (regex-matched) + spam daemon (blind Enter every 3s) on every managed session. Covers both Claude and Codex UX quirks.
+- **Triple-verify parent pings** — codex-send.sh handles delivery fingerprint check + Tab-to-queue during Codex "Working" state.
+- **Shell-flag session respawn** — `claude --continue` and `codex resume --last` preserve context across process restart; foundation for the new `session_respawn` tool.
+- **Self-handoff at ctx threshold** — gen1 Claude arm self-triggered `/atlas-handoff` at ~65% ctx, wrote `docs/DEBRIEF-gen1.md`, spawned `atlas-prd-plugin-builder-gen2` via tmux-first ordering (auto-enter daemon before Claude process). Zero parent intervention needed. This is the behaviour soul files were supposed to produce.
+
+### Blockers surfaced + partially resolved
+- atlas-launcher MCP intermittent disconnects (~3 in ~4hr) — session_respawn is the recovery path, not auto-reconnect (upstream client limitation)
+- Sandbox metachar scanner naive — still rejects `;` `[` `(` inside quoted python -c. NOT FIXED. Workaround: drafters emit metachar-free single commands; adversarial drafters instructed to apply rule on every future draft.
+- Implementer subagent overconfidence in DONE reports — Claude arm QA debrief flagged, gen2 mandate: pre-flight contract_run_tests inside implementer before returning DONE. NOT propagated to Codex arm yet.
+- Bounty wallet `session-lifecycle` = 0 AC → remote settle blocked. NOT FIXED. Both arms operating on `contract_status=active_local` pending wallet top-up.
+
+## Contract tally at ash
+
+**11 contracts settled build-wide:**
+- Claude arm: F3.2, F3.3, F3.4, F3.5, F3.6, F4.0, F4.1, F4.2 (gen1) = 8
+- Codex arm: P1 (18/18), C1 (15/15), C2 (26/26) = 3
+
+Claude arm gen1 progress at handoff: 15/40 tasks (38%). Gen2 picking up at F4.3.
+Codex arm: 3 tasks settled in Wave 1 + early Wave 2. Currently on C3 (taskmaster_bridge.py) via precision lane.
+
+## What's intentionally left out of the successor soul
+
+- 40 iterations of tmux captures + inbox ack/read activity (all in `session-context/supervisor-log.md` — archive, not standing rule)
+- Specific issue lists from earlier days (sandbox metachar, EDQUOT transient, Codex UX surprises) — these are now documented patterns, not open live issues
+- Named-drafter pattern (Darwin/Cicero/Socrates) — superseded by Claude-precision-for-Codex
+- Pre-restart MCP drop anxieties — now handled by session_respawn
+
+## What successor must inherit verbatim
+
+See successor soul file. Distilled to the minimum that still preserves correct behavior.
+
+## Git state at ash
+
+Branch `main`, clean-ish — only untracked files are session-context artifacts + this run's docs:
+- `.env.example`, `.taskmaster/config.json`, `.taskmaster/docs/prd-backup-*.md`, `.taskmaster/templates/`
+- `docs/v4-release/atlas-coin-arm-research-2026-04-16.md`
+- `session-context/CLAUDE-soul-purpose.md`, `session-context/supervisor-log.md`
+
+HEAD: `cb3f13e docs: pin atlas-ralph-loop (patched fork) as canonical over base ralph-loop`
+
+## Live managed sessions at ash
+
+| Session | Role | Ctx % | Daemons (smart/spam) |
+|---|---|---|---|
+| atlas-prd-plugin-builder | gen1 Claude arm (QUIESCENT, soul fulfilled post-handoff) | 54% frozen | 1/1 |
+| atlas-prd-plugin-builder-gen2 | gen2 Claude arm (LIVE, on F4.3) | 14% | 1/1 |
+| atlas-prd-plugin-builder-coin | Codex arm (LIVE, on C3 research) | compacted | 1/1 |
+| atlas-prd-plugin-builder-coin-precision | Codex's Claude precision drafter (LIVE) | ~72-74% | 1/1 |
+| prd-taskmaster-adversarial-contract-phoenix | gen1's drafter phoenix (scope-locked to gen1, now archive candidate) | unused | 1/1 |
+| precision-agent | parent's own Codex precision (unused this session) | unused | 1/1 |
+
+## Pending tasks at ash
+
+- **#32** — Synthesize combined QA feedback from both arms (Claude arm debrief in, Codex arm debrief in). Not yet written.
+- **#23** — Chezmoi secrets scrub egg (out of scope, carried forward)
+- **#7** — Manuscript template for chezmoi CLAUDE.md (out of scope, carried forward)
+- **#21** — Monitor AtlasLauncher-PersistentPhoenix-Tools-Phoenix to pytest completion (peer session, not my child, but pending)
+- **#27** — Auto-approve daemon for gen1 (stale — gen1 is now quiescent)
+
+## Parent notification plan
+
+Hayden is ntfy-only. Will notify on:
+- Ash complete + successor egg parked
+- Path to successor soul + egg for review
+- No auto-hatch per skill rule #5

docs/ashes/claude-prd-taskmaster-pane-20260416T104317Z.txt

@@ -0,0 +1,239 @@
+
+● Bash(echo "=== GEN2 ==="; tmux capture-pane -t atlas-prd-plugin-builder-gen2 -p -S
+      -30 | tail -25
+      echo ""…)
+  ⎿  === GEN2 ===
+          Iteration: 1
+          … +26 lines (ctrl+o to expand)
+     … +30 lines (ctrl+o to expand)
+
+● Bash(echo "=== INBOX ==="; sqlite3 /home/anombyte/.claude/state/messages.db "SELECT
+      id, sender, substr(payload,1,220), created_at FROM messages WHERE
+      target='claude-…)
+  ⎿  === INBOX ===
+     === coin ===
+     {
+     … +3 lines (ctrl+o to expand)
+
+● Gen2 auditor draft complete (52s). Codex starting C3 with research-before-coding
+  discipline. Quiet.
+
+  Read 1 file (ctrl+o to expand)
+
+● Iteration 37. Gen2 F4.3 draft delivered (52s). Codex doing research-before-coding on
+  C3 (taskmaster_bridge.py). Both disciplined cadence.
+  ⎿  Stop says: 🔄 Ralph iteration 38 | To stop: output
+     <promise>SUPERVISOR_COMPLETE</promise> (ONLY when statement is TRUE - do not lie
+     to exit!)
+  ⎿  Stop says: 🔄 Ralph iteration 38 | To stop: output
+     <promise>SUPERVISOR_COMPLETE</promise> (ONLY when statement is TRUE - do not lie
+     to exit!)
+
+● Ran 8 stop hooks (ctrl+o to expand)
+  ⎿  Stop hook error:
+  See .claude/supervisor-loop-prompt.md for full supervisor duties over Claude
+  and Codex phoenix children
+  ⎿  Stop hook error:
+  See .claude/supervisor-loop-prompt.md for full supervisor duties over Claude
+  and Codex phoenix children
+
+● Iteration 38.
+
+● Bash(echo "=== GEN2 ==="; tmux capture-pane -t atlas-prd-plugin-builder-gen2 -p -S
+      -30 | tail -25
+      echo "=== CODEX ==="; tmux capture-pane -t atlas-prd-plugin-builder…)
+  ⎿  === GEN2 ===
+          Iteration: 1
+          … +26 lines (ctrl+o to expand)
+     … +24 lines (ctrl+o to expand)
+
+❯ I think the correct approach is use this new reborn command for each. I'm going to
+  go ahead and restart you and then you can do so actually you know why don't you just
+   make a Claude session? You tell it to restart you. Restart the Claude arm and
+  restart the Kodak arm. You could even use the Kodak's precision Agent to do this. He
+   should have the MCP available. Should he not?
+
+  Read 1 file, called anombyte-notify (ctrl+o to expand)
+
+● Iteration 38. Clarified restart mechanics to Hayden (all live MCP children stale on
+  new tools). Option 1 selected — Hayden restarts me, I pick up new tools on reboot,
+  respawn arms. Pre-restart state logged: 11 contracts settled, gen2 on F4.3, Codex on
+  C3 research, all healthy.
+  ⎿  Stop says: 🔄 Ralph iteration 39 | To stop: output
+     <promise>SUPERVISOR_COMPLETE</promise> (ONLY when statement is TRUE - do not lie
+     to exit!)
+  ⎿  Stop says: 🔄 Ralph iteration 39 | To stop: output
+     <promise>SUPERVISOR_COMPLETE</promise> (ONLY when statement is TRUE - do not lie
+     to exit!)
+
+● Ran 8 stop hooks (ctrl+o to expand)
+  ⎿  Stop hook error:
+  See .claude/supervisor-loop-prompt.md for full supervisor duties over Claude
+  and Codex phoenix children
+  ⎿  Stop hook error:
+  See .claude/supervisor-loop-prompt.md for full supervisor duties over Claude
+  and Codex phoenix children
+
+● Iteration 39 — continuing (not restarted yet).
+
+● Bash(echo "=== GEN2 ==="; tmux capture-pane -t atlas-prd-plugin-builder-gen2 -p -S
+      -25 | tail -20
+      echo "=== CODEX ==="; tmux capture-pane -t atlas-prd-plugin-builder…)
+  ⎿  === GEN2 ===
+       count, then creating the contract.
+     … +32 lines (ctrl+o to expand)
+
+● Codex pane suspiciously empty — deep capture.
+
+● Bash(echo "=== CODEX deep (-80) ==="
+      tmux capture-pane -t atlas-prd-plugin-builder-coin -p -S -80 | tail -50…)
+  ⎿  === CODEX deep (-80) ===
+       └ context7.query-docs({"libraryId":"/python/cpython/v3.11.14","query":"subp
+     rocess.run
+     … +24 lines (ctrl+o to expand)
+
+● Bash(echo "=== codex processes any pattern ==="
+      ps aux | grep -i "codex" | grep -v grep | head -10…)
+  ⎿  === codex processes any pattern ===
+     anombyte  674828  0.0  0.0 751152 44368 pts/21   Sl+  18:00   0:00 node /home
+     /anombyte/.npm-global/bin/codex --dangerously-bypass-approvals-and-sandbox
+     … +22 lines (ctrl+o to expand)
+
+● Codex alive (PID 674828), just the regex missed it. Both arms productive. Logging
+  quietly.
+
+  Read 1 file (ctrl+o to expand)
+
+❯ okay you're back and just FYI your original claw Rhys Bond as a handoff for P2. Do
+  you know the correct Claude arm that you're running on? Was that your doing? I think
+   so if it wasn't that's a smart Claude but you need to make sure you point yourself
+  to the correct one?
+
+● Parent is back. Let me verify Claude arm state — gen1 vs gen2 — and confirm I'm
+  pointing to the right one.
+
+● Bash(tmux ls 2>&1 | grep -E "plugin-builder|taskmaster|precision|drafter" | head -15
+      echo ""…)
+  ⎿  atlas-prd-plugin-builder: 1 windows (created Thu Apr 16 16:39:32 2026) (attac
+     hed)
+     atlas-prd-plugin-builder-coin: 1 windows (created Thu Apr 16 17:58:25 2026) (
+     … +20 lines (ctrl+o to expand)
+
+● Confirmed — gen2 is the live Claude arm, gen1 is quiescent post-handoff. Gen1 did the
+   handoff itself (not my doing) — its soul rule "handoff at >60% ctx" self-triggered.
+  Smart-Claude behavior.
+
+  ★ Insight ─────────────────────────────────────
+  [AI] When a soul file encodes a self-management rule ("handoff at X% context, never
+  die with work incomplete"), and the model is given a proper tool for it
+  (/atlas-handoff), you get autonomic behavior without orchestrator intervention. This
+  is the difference between "prompt-engineering a one-shot" and "standing rules that
+  produce persistent behaviors". The test: did gen1 need parent intervention to
+  handoff? No. That's the win.
+  [SPARK] Gen1 is now a memorial process — soul fulfilled, context frozen at the
+  debrief moment. You can kill it safely, OR keep it as a read-only reference for gen2
+  to grep historical decisions. Which is more useful to gen2: a live sibling that can
+  answer questions, or a clean repo with the debrief file? The former wastes compute,
+  the latter respects the handoff contract.
+  ─────────────────────────────────────────────────
+
+● Update(.claude/supervisor-loop-prompt.md)
+  ⎿  PreToolUse:Edit hook error               ⎿  Hook JSON output validation failed —
+                                                 (root): Invalid input
+  ⎿  Added 2 lines, removed 1 line
+       4
+       5  | Child | Backend | Repo | tmux session | Role |
+       6  |---|---|---|---|---|
+       7 -| atlas-prd-plugin-builder | Claude | /home/anombyte/Shade_Gen/Project
+         -s/prd-taskmaster-plugin | atlas-prd-plugin-builder | Ship @atlas-ai/pr
+         -d-taskmaster to npm |
+       7 +| atlas-prd-plugin-builder-gen2 | Claude (gen2) | /home/anombyte/Shade
+         +_Gen/Projects/prd-taskmaster-plugin | atlas-prd-plugin-builder-gen2 |
+         +Ship @atlas-ai/prd-taskmaster to npm — LIVE, on F4.3+ after gen1 self-
+         +handoff at 65% ctx |
+       8 +| atlas-prd-plugin-builder | Claude (gen1) | /home/anombyte/Shade_Gen/
+         +Projects/prd-taskmaster-plugin | atlas-prd-plugin-builder | QUIESCENT
+         +post-handoff — soul fulfilled, archive candidate, do not send work |
+       9  | atlas-prd-plugin-builder-coin | Codex gpt-5.4 | /home/anombyte/Shade
+          _Gen/Projects/prd-taskmaster-plugin-coin | atlas-prd-plugin-builder-co
+          in | Ship @atlas-ai/atlas-coin to npm (decorator) |
+      10
+      11  You have precision assistants you can delegate to:
+
+  Read 1 file, called anombyte-notify (ctrl+o to expand)
+
+● Task #33 closed — tools deployed via parent restart. Supervisor resumes with full
+  tool access.
+  ⎿  Stop says: 🔄 Ralph iteration 40 | To stop: output
+     <promise>SUPERVISOR_COMPLETE</promise> (ONLY when statement is TRUE - do not lie
+     to exit!)
+  ⎿  Stop says: 🔄 Ralph iteration 40 | To stop: output
+     <promise>SUPERVISOR_COMPLETE</promise> (ONLY when statement is TRUE - do not lie
+     to exit!)
+
+● Ran 8 stop hooks (ctrl+o to expand)
+  ⎿  Stop hook error:
+  See .claude/supervisor-loop-prompt.md for full supervisor duties over Claude
+  and Codex phoenix children
+  ⎿  Stop hook error:
+  See .claude/supervisor-loop-prompt.md for full supervisor duties over Claude
+  and Codex phoenix children
+
+● Iteration 40 — post-restart, first full supervisor cycle with new tools available.
+
+  Called atlas-launcher 2 times (ctrl+o to expand)
+
+● Bash(echo "=== GEN2 ==="; tmux capture-pane -t atlas-prd-plugin-builder-gen2 -p -S
+      -25 | tail -20
+      echo ""…)
+  ⎿  === GEN2 ===
+       (ctrl+o to expand)
+     … +28 lines (ctrl+o to expand)
+
+● Gen2 about to settle F4.3 (11/11 preflight green, running contract_run_tests now).
+  Codex coordinating with precision for C3 draft via MCP.
+
+  Read 1 file (ctrl+o to expand)
+
+❯ I think you should do a Phoenix reignite on yourself to be honest
+
+● Invoking /phoenix-reignite on self per Hayden's suggestion.
+
+● Skill(phoenix-reignite)
+  ⎿  Successfully loaded skill
+
+● Phoenix-reignite workflow for claude-prd-taskmaster supervisor session. Harvesting
+  state.
+
+● Bash(mkdir -p
+      /home/anombyte/Shade_Gen/Projects/prd-taskmaster-v2-handoff-overhaul/docs/ashes
+      cd /home/anombyte/Shade_Gen/Projects/prd-taskmaster-v2-handoff-overhaul…)
+  ⎿  timestamp: 20260416T104317Z
+     === GIT STATUS ===
+     ?? .env.example
+     … +18 lines (ctrl+o to expand)
+
+● Bash(TS=20260416T104317Z
+      ASH=/home/anombyte/Shade_Gen/Projects/prd-taskmaster-v2-handoff-overhaul/docs/ash
+      es/claude-prd-taskmaster-pane-$TS.txt…)
+  ⎿  Running…
+
+✶ Supervising phoenix arms… (1m 59s · ↓ 2.0k tokens · thought for 8s)
+  ⎿  ◼ Supervisor /atlas-ralph-loop active over Claude + Codex phoenix arms
+     ◻ [IN-SCOPE] Add manuscript template to chezmoi-tracked ~/.claude/CLAUDE.…
+     ◻ [ADOPTED] Monitor AtlasLauncher-PersistentPhoenix-Tools-Phoenix to pyte…
+     ◻ [EGG] Chezmoi secrets scrub + templates for sensitive files
+     ◻ [AUTO-APPROVE ACTIVE] atlas-prd-plugin-builder for 6h (ends ~14:55 loca…
+     ◻ Collect + synthesize QA feedback from both phoenix arms
+     ✔ [IN-SCOPE] Answer: plan-mode vs writing-plans + related distinctions
+     ✔ [IN-SCOPE] Answer: monorepo vs subdirectory-scoped context question
+     ✔ [IN-SCOPE] Ask clarifying questions before delegating work
+     ✔ [SUB-AGENT: sonnet] Publish session learnings to shade-insights-rag vec…
+      … +19 completed
+
+───────────────────────────────────────────────────────────────────────────────────────
+❯ 
+───────────────────────────────────────────────────────────────────────────────────────
+  [Opus 4.6 (1M context)] 56% ctx · 558k tok hooks:206ms
+  ⏵⏵ bypass permissions on (shift+tab to cycle)
+