From c8e17ae90c59a590f7788146c4ca26a6744b47f9 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 9 Nov 2026 03:01:34 +0000 Subject: [PATCH 1/2] Point multi-phase plan reads at the installed plugin. The check-plan command and skeleton reads use skills/ under the installed pstack plugin dir from grok plugin list. Drop the check-plan git show origin/main: marker. Co-authored-by: Kaitian Xie --- .../poteto-mode/playbooks/multi-phase-plan.md | 20 +++++++++---------- skills/poteto-mode/scripts/check-plan.mjs | 2 +- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/skills/poteto-mode/playbooks/multi-phase-plan.md b/skills/poteto-mode/playbooks/multi-phase-plan.md index 2fd78d1..3a0e523 100644 --- a/skills/poteto-mode/playbooks/multi-phase-plan.md +++ b/skills/poteto-mode/playbooks/multi-phase-plan.md @@ -7,7 +7,7 @@ 3. Explore in subagents with `subagent_type: "pstack:poteto-agent"` and an explicit model per the Subagents section (the **guard-the-context-window** principle skill). Pick each subagent's reasoning effort for the job, per the Subagents section. Each returns file pointers, conventions, test commands, and entry points. No inlined dumps. 4. Copy the skeleton below into the plan file and fill every placeholder. Unless the operator names a path, write the file under the agent store's `docs/`. Keep every heading and every sub-block in the order shown. One section per PR. One PR is one change with its own evidence (the **sequence-verifiable-units** principle skill). Name the execution playbook in **How to read this**. Pick `playbooks/autopilot-full.md` when the run may merge. Pick `playbooks/autopilot-stack.md` when the operator lands the PRs. A standing program takes `playbooks/orchestrate.md`. 5. Write under `/technical-writing` in full, then `/unslop`. The body is one Diátaxis mode, how-to. Appendices hold explanation and reference. Each heading states the task or the finding. No long dashes. No mid-sentence colons. -6. Run `node pstack/skills/poteto-mode/scripts/check-plan.mjs ` and fix every line it prints (the **encode-lessons-in-structure** principle skill). +6. Run `node /skills/poteto-mode/scripts/check-plan.mjs ` and fix every line it prints (the **encode-lessons-in-structure** principle skill). `` is the installed path from `grok plugin list` for the copy whose `plugin.json` name is `pstack`. 7. Hand back. Post the plan path and the script's output, then stop. Execution starts on the operator's explicit go, under the execution playbook the plan names. **Verification.** Tests alone are not sufficient verification. A PR is verified only when its unit, live, and perf boxes are all checked (the **prove-it-works** principle skill). That sentence is the verification rule. Every verification block opens with it. The live block is mandatory. Ten lanes at the PR head drive the real surface through its control skill, per the **swarm** skill, on the `swarm workers` model (default `grok-4.6` at `xhigh`). Each lane is one box with a concrete scenario, the screenshot it saves, and its pass predicate. One lane is the **Regression lane against trunk.** It runs the same load-bearing scenario on trunk and head. If trunk does not have the feature, the lane records that fact and gates the behavior the diff adds plus the end state the user waits for instead of inventing a trunk result. The perf gate is dual-sided. Trunk and head must both produce the named metric. If trunk lacks the feature, also isolate the work the diff adds and set an absolute budget for that work plus the end-to-end state the user waits for. Do not claim a ratio between unlike scenarios. The perf block names the metric, the interleaved probe, the trunk baseline measured first, and the rule with the number that fails. A PR that changes an interaction is review-gated. The operator reviews it in chat with screenshots and a video before merge. A PR that changes no interaction writes `**Review gate.** None. is not review-gated.` and no boxes under it. @@ -23,7 +23,7 @@ One box is one unit of work. Every box names the evidence that checks it. A nested box is a sub-step of the box above it. Check a box only when its evidence exists, a file, a log line, a screenshot, a test run, or a SHA. The body is a how-to. The appendices explain and record. -The program runs `pstack/skills/poteto-mode/playbooks/.md`. +The program runs `/skills/poteto-mode/playbooks/.md`. `` is the installed path from `grok plugin list` for the copy whose `plugin.json` name is `pstack`. Tests alone are not sufficient verification. A PR is verified only when its unit, live, and perf boxes are all checked. @@ -32,12 +32,12 @@ Tests alone are not sufficient verification. A PR is verified only when its unit ### Arm the program - [ ] State the protocol and this plan to the operator, then stop. Start execution only on the operator's explicit go. -- [ ] Read these from trunk at program start. Re-read them at every tick. - - [ ] `git show origin/main:pstack/skills/poteto-mode/playbooks/.md` - - [ ] `git show origin/main:pstack/skills/swarm/SKILL.md` - - [ ] `git show origin/main:` - - [ ] `git show origin/main:pstack/skills/poteto-mode/playbooks/opening-a-pr.md` - - [ ] `git show origin/main:pstack/skills/` +- [ ] Read these from the installed pstack plugin dir at program start. Re-read them at every tick. + - [ ] `/skills/poteto-mode/playbooks/.md` + - [ ] `/skills/swarm/SKILL.md` + - [ ] `/` + - [ ] `/skills/poteto-mode/playbooks/opening-a-pr.md` + - [ ] `/skills/` - [ ] On the operator's go, arm the audit tick as `/loop 1h` with the tick prompt below. Never leave the cadence to memory. - [ ] Use this tick prompt, verbatim. "Re-read the execution playbook from trunk. Audit the operation against it and fix drift in this tick. Probe every active lane and judge progress by side effects only. Stand down a stuck lane and dispatch its replacement now. Then post a short status message to the operator in chat only when the audit found a tracked change that no earlier status message reported, such as a PR opened, a code-ready head, a round launched or closed, a verdict, a merge, a stuck agent and the action taken, a blocker added or cleared, or a decision only the operator can make. Name every such change and nothing else. Do not repeat a table, the merged list, or an unchanged blocker. If the audit found none, end the turn with no reply text. Either way, log this tick's row in your decision trail. The row names the items reported, or none." - [ ] On the operator's hold or stand-down, send every owner a zero-writes order at once. @@ -62,7 +62,7 @@ Tests alone are not sufficient verification. A PR is verified only when its unit ### Verdict and merge, for every PR -- [ ] A full swarm runs once, at the code-ready head. Another full swarm runs only for new behavior, a redesign, or a large new diff. A rebase, a merge-conflict resolution, or a minor fix gets a single verifier at the new head, and a wording-only change gets none. Run each full swarm per `pstack/skills/swarm/SKILL.md`. One gates lane. The ten live lanes from the PR's **Verify, live** block. The perf lane from its **Verify, perf** block. Two or more audit lanes, each with its own focus, that read the diff and the receipts and distrust the PR body. The root audits the receipts in the merge-ready report before the verdict. +- [ ] A full swarm runs once, at the code-ready head. Another full swarm runs only for new behavior, a redesign, or a large new diff. A rebase, a merge-conflict resolution, or a minor fix gets a single verifier at the new head, and a wording-only change gets none. Run each full swarm per `/skills/swarm/SKILL.md`. One gates lane. The ten live lanes from the PR's **Verify, live** block. The perf lane from its **Verify, perf** block. Two or more audit lanes, each with its own focus, that read the diff and the receipts and distrust the PR body. The root audits the receipts in the merge-ready report before the verdict. - [ ] Judge every finding by the execution playbook's blocking rule. The verdict is clean when none blocks. A failure on trunk behavior in a lane marked `Regression lane against trunk.` is recorded against trunk and does not block the PR. A new head gets a fresh verdict, except for results that stay valid under the patch-id rule in `playbooks/shipping.md`. - [ ] @@ -149,7 +149,7 @@ Each live lane runs in its own worktree at the PR head, with `isolation: "worktr ## Appendix D. Links and reading list - +/skills/how/SKILL.md` and `/skills/interrogate/SKILL.md`. The trail per `/skills/show-me-your-work/SKILL.md`.> ```` **Reply:** the plan path, the PR ids with their dependencies and the review-gated set, what the prototypes proved and what stays unproven, and the check script's output. diff --git a/skills/poteto-mode/scripts/check-plan.mjs b/skills/poteto-mode/scripts/check-plan.mjs index c3ddc39..2bf3442 100755 --- a/skills/poteto-mode/scripts/check-plan.mjs +++ b/skills/poteto-mode/scripts/check-plan.mjs @@ -17,7 +17,7 @@ const SUB_BLOCKS = [ "Merge.", ]; const PROGRAM_H3 = ["Arm the program", "Spawn owners", "PR mechanics", "Verdict and merge", "Boot recipe"]; -const PROGRAM_MARKERS = ["git show origin/main:", "/loop 1h", "status message"]; +const PROGRAM_MARKERS = ["/loop 1h", "status message"]; const HOW_TO_READ_MARKERS = [ "One box is one unit of work", "names the evidence", From b737c5ba8eca5683f8cd7646aa05ac8ad9193c57 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 9 Nov 2026 03:05:08 +0000 Subject: [PATCH 2/2] Restore the app-repo control skill read. Keep upstream git show origin/main: and the check-plan marker. Plugin reads stay on skills/ under the installed pstack dir. Co-authored-by: Kaitian Xie --- skills/poteto-mode/playbooks/multi-phase-plan.md | 2 +- skills/poteto-mode/scripts/check-plan.mjs | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/poteto-mode/playbooks/multi-phase-plan.md b/skills/poteto-mode/playbooks/multi-phase-plan.md index 3a0e523..2f734d8 100644 --- a/skills/poteto-mode/playbooks/multi-phase-plan.md +++ b/skills/poteto-mode/playbooks/multi-phase-plan.md @@ -35,7 +35,7 @@ Tests alone are not sufficient verification. A PR is verified only when its unit - [ ] Read these from the installed pstack plugin dir at program start. Re-read them at every tick. - [ ] `/skills/poteto-mode/playbooks/.md` - [ ] `/skills/swarm/SKILL.md` - - [ ] `/` + - [ ] `git show origin/main:` - [ ] `/skills/poteto-mode/playbooks/opening-a-pr.md` - [ ] `/skills/` - [ ] On the operator's go, arm the audit tick as `/loop 1h` with the tick prompt below. Never leave the cadence to memory. diff --git a/skills/poteto-mode/scripts/check-plan.mjs b/skills/poteto-mode/scripts/check-plan.mjs index 2bf3442..c3ddc39 100755 --- a/skills/poteto-mode/scripts/check-plan.mjs +++ b/skills/poteto-mode/scripts/check-plan.mjs @@ -17,7 +17,7 @@ const SUB_BLOCKS = [ "Merge.", ]; const PROGRAM_H3 = ["Arm the program", "Spawn owners", "PR mechanics", "Verdict and merge", "Boot recipe"]; -const PROGRAM_MARKERS = ["/loop 1h", "status message"]; +const PROGRAM_MARKERS = ["git show origin/main:", "/loop 1h", "status message"]; const HOW_TO_READ_MARKERS = [ "One box is one unit of work", "names the evidence",