diff --git a/README.md b/README.md
index a4289d5..f20dd20 100644
--- a/README.md
+++ b/README.md
@@ -2,9 +2,23 @@
Make a short list of goals in one Markdown plan file. The main chat keeps the high-level context, supervises a worker in a visible Herdr pane, and checks whether each goal is complete.
-
+# User ask
-Abridged text from the isolated test, with approval and completion shown together. Paths are shortened; bracketed labels are annotations. Model names and token counts below illustrate the intended supervisor/worker split, not measurements from this capture.
+The hope is we can have a smart supervisor, with judgment and context. But it doesn't use many tokens as it checks in and sees an overview from a cheaper worker.
+
+The supervisor has a goal / plan that it agrees on with the user, and is reminded of it in a Ralph-loop-type repeat.
+
+It compacts every 150k or similar to avoid cost and context rot.
+
+It steers a smaller model, adding perspective and judgment.
+
+Since it's two panes, the user can review both, intervene in both and have visibility on sub-agent mis/communication.
+
+-- wassname (spelling and punctuation corrected by Pi/OpenAI)
+
+## Screenshot
+
+Mock up:
```text
+-----------------------------------------------------------+-----------------------------------------------------------+
@@ -33,6 +47,10 @@ Abridged text from the isolated test, with approval and completion shown togethe
+-----------------------------------------------------------+-----------------------------------------------------------+
```
+Real screenshot:
+
+
+
The plan file looks like this:
```md
@@ -81,7 +99,7 @@ resync-after-compaction from [tmonk/pi-goal-x](https://github.com/tmonk/pi-goal-
## Install
-Requires Herdr. The package includes the worker, messaging and scheduled-prompt extensions. Remove separate installations of pi-subagents, pi-intercom and pi-schedule-prompt to avoid loading them twice.
+Requires Herdr. Includes [edxeth/pi-subagents](https://github.com/edxeth/pi-subagents), pi-intercom and pi-schedule-prompt. Disable separately loaded copies to avoid duplicate commands.
```bash
pi install git:github.com/wassname/pi-goals@experiment/main-supervisor-edxeth
diff --git a/package.json b/package.json
index 7561972..0abed27 100644
--- a/package.json
+++ b/package.json
@@ -38,9 +38,9 @@
"scripts": {
"build": "tsc",
"prepublishOnly": "npm run lint && npm run typecheck && npm run test",
- "test": "vitest run",
- "test:rpc": "vitest run test/rpc-review.test.ts",
- "test:watch": "vitest",
+ "test": "vitest run --dir test",
+ "test:rpc": "vitest run --dir test rpc-review.test.ts",
+ "test:watch": "vitest --dir test",
"typecheck": "tsc --noEmit",
"lint": "biome check src/ test/",
"lint:fix": "biome check --fix src/ test/"