docs: record intended supervision workflow

AGENTS.md

@@ -14,3 +14,11 @@ Run `npm test` before a commit. It includes unit and flow tests plus the RPC rev
 
   Run `/goals <objective>` in that pane. Tmux checks the rendered menu, editor focus, widget, and keyboard handling. RPC does not render the terminal UI.
 - `pi -p` has no UI, so it cannot test `Ready`, `Refine`, `Edit`, or `Cancel`.
+
+## Intended supervision workflow
+
+I already have pi-intercom-supervisor, but thought using pi-subagents could make it simpler. The idea is that the user makes a plan as in pi-goals, but on this branch, instead of a naive stateless subagent, we 1) fork, 2) compact, and 3) make it a supervisor with a prompt as in pi-intercom-supervisor. The supervisor is cheap because it sees only high-level material, which costs fewer tokens. It has good judgement because it sees a) compacted planning context, b) the plan, and c) summarised context (for example, my modified pi-vcc). This lets it operate read-only and steer the worker without losing track. It also compacts every 100k tokens to keep it cheap and high-level.
+
+I am now thinking the subagent implementation may be too difficult. To keep the plan and forking, this branch of pi-goals could make another Pi session, perhaps using the fork explicitly, and use pi-intercom or pi-messenger to communicate with it. The user can switch to it, or Herdr could open it automatically.
+
+-- wassname

slop/audits/20260905_pi-goals-file-types.txt

@@ -1,7 +1,6 @@
-text/plain	.gitignore
 text/plain	AGENTS.md
+text/plain	agents/pi-goals-worker-v1.md
 text/plain	ARCHIVED.md
-text/plain	README.md
 application/json	biome.json
 text/plain	docs/reviews/goals_menu2.md
 text/plain	docs/reviews/goals_menu2_r2.md
@@ -14,29 +13,39 @@ text/plain	docs/slop/plans/20260826_pi-plan-aligned-planning.md
 text/plain	docs/spec/2026-06-15_pi-goals.md
 text/plain	docs/spec/2026-06-29_complete-goal-fail-forward.md
 text/plain	docs/spec/2026-08-14_per-session-plan.md
+text/plain	.gitignore
 image/png	media/screenshot.png
 application/json	package-lock.json
 application/json	package.json
+text/plain	README.md
 text/x-shellscript	scripts/check-judge-footprint.sh
 text/x-shellscript	scripts/check-stale-fixmes.sh
 text/x-diff	scripts/inconclusive-fail-forward.diff
 text/x-diff	scripts/stale-fixme-removal.diff
 text/plain	slop/audits/20260905_goal-steward-validation.md
+text/plain	slop/audits/20260905_nested-supervisor-validation.txt
 text/plain	slop/audits/20260905_pi-goals-file-types.txt
 text/plain	slop/audits/20260905_pi-goals-line-count-table.md
 text/plain	slop/audits/20260905_pi-goals-text-line-counts.txt
 application/json	slop/audits/20260905_steward-probe.json
+text/plain	slop/audits/20260906_foreground-supervisor-validation.txt
+text/plain	slop/audits/20260906_nested-runtime-smoke.md
 text/plain	slop/plans/20260905_goal-steward.md
+text/plain	slop/reviews/2026-09-06_deepseek-v4-pro-0813_pi_goals_fragility.md
+text/plain	slop/reviews/20260906_foreground-worker-review.md
+application/javascript	src/approval.ts
 application/javascript	src/index.ts
 application/javascript	src/prompts.ts
-application/javascript	src/steward.ts
+application/javascript	src/supervisor-runtime.ts
+application/javascript	src/worker.ts
 application/javascript	test/append-log.test.ts
-application/javascript	test/decide-signoff.test.ts
 application/javascript	test/fixtures/offline-model.ts
 application/javascript	test/fold.test.ts
 application/javascript	test/goals-flow.test.ts
+application/javascript	test/package-agent.test.ts
 application/javascript	test/prompts.test.ts
 application/javascript	test/rpc-review.test.ts
-application/javascript	test/steward.test.ts
+application/javascript	test/supervisor-runtime.test.ts
 application/javascript	test/tick-goal.test.ts
+application/javascript	test/worker.test.ts
 application/json	tsconfig.json

slop/audits/20260905_pi-goals-line-count-table.md

@@ -12,7 +12,7 @@ git ls-files -z | while IFS= read -r -d '' f; do case "$f" in media/screenshot.p
 
 | File | Lines |
 | --- | ---: |
-| `AGENTS.md` | 16 |
+| `AGENTS.md` | 24 |
 | `agents/pi-goals-worker-v1.md` | 22 |
 | `ARCHIVED.md` | 3 |
 | `biome.json` | 23 |
@@ -36,7 +36,7 @@ git ls-files -z | while IFS= read -r -d '' f; do case "$f" in media/screenshot.p
 | `scripts/stale-fixme-removal.diff` | 30 |
 | `slop/audits/20260905_goal-steward-validation.md` | 31 |
 | `slop/audits/20260905_nested-supervisor-validation.txt` | 91 |
-| `slop/audits/20260905_pi-goals-file-types.txt` | 42 |
+| `slop/audits/20260905_pi-goals-file-types.txt` | 51 |
 | `slop/audits/20260905_pi-goals-line-count-table.md` | 66 |
 | `slop/audits/20260905_pi-goals-text-line-counts.txt` | 50 |
 | `slop/audits/20260905_steward-probe.json` | 15 |
@@ -61,6 +61,6 @@ git ls-files -z | while IFS= read -r -d '' f; do case "$f" in media/screenshot.p
 | `test/tick-goal.test.ts` | 32 |
 | `test/worker.test.ts` | 119 |
 | `tsconfig.json` | 15 |
-| **Total** | **4299** |
+| **Total** | **4316** |
 
 -- PI[gpt-5.6]

slop/audits/20260905_pi-goals-text-line-counts.txt

@@ -1,4 +1,4 @@
-16	AGENTS.md
+24	AGENTS.md
 22	agents/pi-goals-worker-v1.md
 3	ARCHIVED.md
 23	biome.json
@@ -22,7 +22,7 @@
 30	scripts/stale-fixme-removal.diff
 31	slop/audits/20260905_goal-steward-validation.md
 91	slop/audits/20260905_nested-supervisor-validation.txt
-42	slop/audits/20260905_pi-goals-file-types.txt
+51	slop/audits/20260905_pi-goals-file-types.txt
 66	slop/audits/20260905_pi-goals-line-count-table.md
 50	slop/audits/20260905_pi-goals-text-line-counts.txt
 15	slop/audits/20260905_steward-probe.json
@@ -47,4 +47,4 @@
 32	test/tick-goal.test.ts
 119	test/worker.test.ts
 15	tsconfig.json
-total	4299
+total	4316