From 46ab4cb19e4a93d923ceb1c95919eef1384ad40c Mon Sep 17 00:00:00 2001
From: SocialNerd42069 <118244303+SocialNerd42069@users.noreply.github.com>
Date: Mon, 19 Jan 2026 12:51:54 -0600
Subject: [PATCH] my local tweaks

---
 Peekaboo                     |  1 +
 skills/coding-agent/SKILL.md | 20 +++++++++++++++++++-
 2 files changed, 20 insertions(+), 1 deletion(-)
 create mode 160000 Peekaboo

diff --git a/Peekaboo b/Peekaboo
new file mode 160000
index 000000000..5c195f5e4
--- /dev/null
+++ b/Peekaboo
@@ -0,0 +1 @@
+Subproject commit 5c195f5e46ebfcc953af74fdd05fbc962d05a50c
diff --git a/skills/coding-agent/SKILL.md b/skills/coding-agent/SKILL.md
index 06ba47a92..d9216ebab 100644
--- a/skills/coding-agent/SKILL.md
+++ b/skills/coding-agent/SKILL.md
@@ -218,7 +218,9 @@ git worktree remove /tmp/issue-99
 ## ⚠️ Rules
 
 1. **Always use pty:true** — coding agents need a terminal!
-2. **Respect tool choice** — if user asks for Codex, use Codex. NEVER offer to build it yourself!
+2. **Respect tool choice** — if user asks for Codex, use Codex.
+   - Orchestrator mode: do NOT hand-code patches yourself.
+   - If an agent fails/hangs, respawn it or ask the user for direction, but don’t silently take over.
 3. **Be patient** — don't kill sessions because they're "slow"
 4. **Monitor with process:log** — check progress without interfering
 5. **--full-auto for building** — auto-approves changes
@@ -229,6 +231,22 @@ git worktree remove /tmp/issue-99
 
 ---
 
+## Progress Updates (Critical)
+
+When you spawn coding agents in the background, keep the user in the loop.
+
+- Send 1 short message when you start (what’s running + where).
+- Then only update again when something changes:
+  - a milestone completes (build finished, tests passed)
+  - the agent asks a question / needs input
+  - you hit an error or need user action
+  - the agent finishes (include what changed + where)
+- If you kill a session, immediately say you killed it and why.
+
+This prevents the user from seeing only "Agent failed before reply" and having no idea what happened.
+
+---
+
 ## Learnings (Jan 2026)
 
 - **PTY is essential:** Coding agents are interactive terminal apps. Without `pty:true`, output breaks or agent hangs.