From cac2077456e9f8ec390b16ea42a1eb187e136c3d Mon Sep 17 00:00:00 2001 From: wassname <1103714+wassname@users.noreply.github.com> Date: Sun, 6 Sep 2026 15:54:19 +0800 Subject: [PATCH] docs: record intended supervision workflow --- AGENTS.md | 8 ++++++++ slop/audits/20260905_pi-goals-file-types.txt | 19 ++++++++++++++----- .../20260905_pi-goals-line-count-table.md | 6 +++--- .../20260905_pi-goals-text-line-counts.txt | 6 +++--- 4 files changed, 28 insertions(+), 11 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index fc2e5d4..f8cbb47 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,3 +14,11 @@ Run `npm test` before a commit. It includes unit and flow tests plus the RPC rev Run `/goals ` 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 diff --git a/slop/audits/20260905_pi-goals-file-types.txt b/slop/audits/20260905_pi-goals-file-types.txt index d47afa7..9b354db 100644 --- a/slop/audits/20260905_pi-goals-file-types.txt +++ b/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 diff --git a/slop/audits/20260905_pi-goals-line-count-table.md b/slop/audits/20260905_pi-goals-line-count-table.md index 317dca1..657623c 100644 --- a/slop/audits/20260905_pi-goals-line-count-table.md +++ b/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] diff --git a/slop/audits/20260905_pi-goals-text-line-counts.txt b/slop/audits/20260905_pi-goals-text-line-counts.txt index b293de6..cd6db77 100644 --- a/slop/audits/20260905_pi-goals-text-line-counts.txt +++ b/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