From 490f873b26214d0a59bd45b5e09e072a532a04b8 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 5 Jun 2026 05:50:45 -0400 Subject: [PATCH] =?UTF-8?q?sandbox:=20PLAN=5FRUNNER=20=E2=80=94=20drop=20f?= =?UTF-8?q?ile-handoff=20framing=20from=20briefing?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- sandbox/plans/PLAN_RUNNER.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/sandbox/plans/PLAN_RUNNER.md b/sandbox/plans/PLAN_RUNNER.md index ca2f37886d64..9f1487324e0c 100644 --- a/sandbox/plans/PLAN_RUNNER.md +++ b/sandbox/plans/PLAN_RUNNER.md @@ -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/-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 /home/paulus/dev/hass/core <<'BRIEF' +…brief… +BRIEF +# …or from a scratch file you already have it in: ~/dev/claude-screen /home/paulus/dev/hass/core < /tmp/-brief.md ```