sandbox: PLAN_RUNNER — drop file-handoff framing from briefing

Now that claude-screen pastes multi-line directly, the brief no longer
needs a tempfile + "Read /tmp/X" pointer. Step 1 reads "Compose the brief"
(source it from a heredoc or any scratch file) instead of "Write the
brief"; step 2 shows both heredoc and file pipes. The brief is just stdin,
not a handoff artifact.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Paulus Schoutsen
2026-07-07 15:12:23 -04:00
co-authored by Claude Opus 4.7
parent 30c4b3a63d
commit 490f873b26
+10 -4
View File
@@ -16,13 +16,14 @@ the window. One plan per session, sequentially.
## Steps
### 1. Write the brief
### 1. Compose the brief
The brief is the sub-session's whole instruction set: which plan to read, the
locked decisions, hard rules, build steps, the exact tests/greps to run, and —
critically — to **write a STATUS marker file LAST**. Keep it in a file
(`/tmp/<name>-brief.md`) or compose it inline — either way you pipe it on
stdin in the next step.
critically — to **write a STATUS marker file LAST**. You pipe it on stdin in
the next step (claude-screen pastes whatever you pipe, multi-line and all), so
source it from wherever is convenient — a heredoc, or a scratch file you
already have it in.
Hard rules every brief repeats:
- **Execute the plan with the `phx:work` skill** — step through the plan's
@@ -41,6 +42,11 @@ included — using bracketed paste and a separate submit keystroke, so the whole
brief lands as one message:
```bash
# from a heredoc:
~/dev/claude-screen <name> /home/paulus/dev/hass/core <<'BRIEF'
…brief…
BRIEF
# …or from a scratch file you already have it in:
~/dev/claude-screen <name> /home/paulus/dev/hass/core < /tmp/<name>-brief.md
```