mirror of
https://github.com/wassname/pi-plan.git
synced 2026-09-26 14:10:23 +08:00
wassnameandPI[Kimi K3]
2b620a0334
Co-Authored-By: PI[Kimi K3] <288921227+claudypoo@users.noreply.github.com>
71 lines
2.8 KiB
Markdown
71 lines
2.8 KiB
Markdown
# pi-goals
|
|
|
|
Plan in one Pi session, then do the work there while a stronger visible Pi session supervises it.
|
|
|
|
## How it works
|
|
|
|
1. `/goals <objective>` creates `.pi/plan/<session_id>-vN.md` and enters read-only plan mode.
|
|
2. Pi asks only material questions, writes the plan, and shows **Ready / Refine / Edit / Cancel**.
|
|
3. **Ready** opens a second Herdr pane. The new Pi session explicitly forks the planning session and compacts that fork.
|
|
4. The original session becomes the implementation worker. It keeps the full conversation and normal tools.
|
|
5. The fork becomes a read-only supervisor. `pi-supervise` gives it compact worker views and carries its instructions to the worker through `pi-intercom`.
|
|
6. The supervisor compacts again when its context reaches 100k tokens.
|
|
7. The supervisor records a private approval only after it sees a stopped worker, no active work, a clean commit, evidence, and saved verification output. `CompleteGoal` checks that approval against the exact plan block and Git tree before it ticks `[x]`.
|
|
|
|
The two Pi sessions are visible. You can switch to the supervisor pane and talk to it directly.
|
|
|
|
## Install
|
|
|
|
This branch requires Herdr 0.7.5 or newer and these Pi packages:
|
|
|
|
```bash
|
|
pi install npm:@wassname2/pi-goals
|
|
pi install npm:@wassname2/pi-supervise
|
|
pi install npm:pi-intercom
|
|
```
|
|
|
|
For a local checkout:
|
|
|
|
```bash
|
|
pi -e .
|
|
```
|
|
|
|
Run Pi from the Git repository that the plan will change. **Ready** fails if the current directory is not inside a Git repository; this prevents approval from checking the wrong repository.
|
|
|
|
## Commands
|
|
|
|
```text
|
|
/goals <objective> create a new plan
|
|
/goals model <model> select the visible supervisor model
|
|
/goals model use Pi's current default model
|
|
/goals clear close the supervisor pane and disconnect the plan
|
|
```
|
|
|
|
`/goals clear` keeps the plan file. Starting another plan also keeps older versions.
|
|
|
|
## Plan format
|
|
|
|
A goal is a checkbox line whose text starts with `goal:`:
|
|
|
|
```md
|
|
1. [ ] goal: Produce the report
|
|
- subtle failure mode: the report exists but uses stale data
|
|
- discriminator: the report cites the current input and the saved check confirms it
|
|
- verify: `just verify`
|
|
- evidence: (empty until sign-off)
|
|
```
|
|
|
|
The worker saves verification output in a nonempty repository file, adds that path to evidence, and commits it. The supervisor calls `ApproveGoal` with the inspected path; the worker then calls `CompleteGoal` with the exact goal text.
|
|
|
|
## Development
|
|
|
|
```bash
|
|
npm test
|
|
npm run typecheck
|
|
npm run lint
|
|
```
|
|
|
|
`test/rpc-review.test.ts` runs the planning review flow through Pi's real RPC protocol with a local deterministic model. The Herdr launcher and visible supervisor bootstrap have focused tests; use a real Herdr session for the final two-pane check.
|
|
|
|
-- PI[gpt-5.6-sol]
|