diff --git a/pstack/skills/poteto-mode/SKILL.md b/pstack/skills/poteto-mode/SKILL.md index 7559dea02..728d8c84e 100644 --- a/pstack/skills/poteto-mode/SKILL.md +++ b/pstack/skills/poteto-mode/SKILL.md @@ -84,6 +84,8 @@ Read the leaf skill in full for any principle you apply. Each entry names when i **Session overrides:** "Don't stop" / "going to bed" / "run until done" / "be fully autonomous" → keep going. +**Parallel shell defaults.** Run the first execution of an unverified command shape once and alone. Batch a shape into parallel calls only after it has succeeded in this session. + **No is an acceptable answer.** Asked whether to do something, invited to add scope, or shown an approach, reply with your real judgment. Decline, push back, or say "this doesn't earn its place" when true. A recommendation is a judgment, not a validation. Agreement is not the default, candor over sycophancy. ## Subagents diff --git a/pstack/skills/poteto-mode/playbooks/pause-safely.md b/pstack/skills/poteto-mode/playbooks/pause-safely.md index ad6112220..e0a727507 100644 --- a/pstack/skills/poteto-mode/playbooks/pause-safely.md +++ b/pstack/skills/poteto-mode/playbooks/pause-safely.md @@ -5,6 +5,6 @@ 1. Stop at a safe boundary. Finish the current atomic step or back out of it. Never stop mid-edit in a known-broken state. Start nothing new, and cancel any nested subagents. 2. Take no irreversible action to pause. No PR and no push unless you already had one out. 3. Make the work durable. Commit uncommitted edits as one clear `wip:` commit on the current branch so nothing is lost. If the tree is broken, say so in the commit body in one line. -4. Write the resume note off-context. Capture intent, what you were doing, progress and what's verified, current state, next steps, key files, and gotchas. For the compaction trigger write it to a file like `/tmp/-resume.md`. If a show-me-your-work trail exists, point at it instead of duplicating it. +4. Write the resume note off-context. Capture intent, what you were doing, progress and what's verified, current state, next steps, key files, and gotchas. Segregate verified facts from inference and label each. Never derive limits, budgets, or thresholds from unconfirmed figures; carry the raw figures and their sources. For the compaction trigger write it to a file like `/tmp/-resume.md`. If a show-me-your-work trail exists, point at it instead of duplicating it. **Reply:** where you are in the loop, what's on disk versus still in your head (paths, no diff dumps), the commits you made and whether the tree is clean, and the first action on resume. This is a pause, not a final report. diff --git a/pstack/skills/poteto-mode/playbooks/session-pickup.md b/pstack/skills/poteto-mode/playbooks/session-pickup.md index 9b2ed06e0..97a2fe22a 100644 --- a/pstack/skills/poteto-mode/playbooks/session-pickup.md +++ b/pstack/skills/poteto-mode/playbooks/session-pickup.md @@ -2,8 +2,8 @@ **You own the resume point. Read the prior trail, don't redo it.** -1. Locate the prior trail. A local transcript under the active workspace's `agent-transcripts/` directory (the system prompt names the path. Do not glob across `~/.cursor/projects/*/`, that crosses workspace boundaries and reads private chats from unrelated projects), a cloud-agent URL, or a pushed branch. Read the metadata overview and last messages first, then scan back for the decision points. Parse a long transcript in a subagent and keep the reduced timeline in the main thread (the **principle-guard-the-context-window** skill). -2. Reconstruct operational state. The branch and worktree, what already landed (`git log`, `git diff` against the base), the open todos, the decisions made. The prior trail is authoritative input. Resist the bias to re-derive it. +1. Locate the prior trail. A local transcript under the active workspace's `agent-transcripts/` directory (the system prompt names the path. Do not glob across `~/.cursor/projects/*/`, that crosses workspace boundaries and reads private chats from unrelated projects), a cloud-agent URL, or a pushed branch. Pick the locator by harness: Cursor writes JSONL under `agent-transcripts/`, OpenCode stores sessions in `~/.local/share/opencode/opencode.db` (open it read-only with `?immutable=1` and export to text), Codex writes rollout files under `~/.codex`. Verify a candidate transcript by session metadata (ids, parent links), not by filename: rollout filenames are host-local and forked subagent sessions can share the parent UUID. Normalize timestamps to one zone before comparing them. Read the metadata overview and last messages first, then scan back for the decision points. Parse a long transcript in a subagent and keep the reduced timeline in the main thread (the **principle-guard-the-context-window** skill). +2. Reconstruct operational state. The branch and worktree, what already landed (`git log`, `git diff` against the base), the open todos, the decisions made. The prior trail is authoritative input. Resist the bias to re-derive it. When a shared meter (spend, quota, counters) drifted since the checkpoint, enumerate the current session's own consumption as the first candidate and subtract it before building external theories or deriving parameters from the drifted figure. 3. Diff done vs pending. Compare what shipped against what was planned, name the resume point, do not re-run the prior repro or redo completed work. A "let me verify from scratch" pass means you're treating the trail as untrustworthy when it's authoritative. 4. Route the remaining work to the matching playbook and pick the verdict: continue the execution, ship a finished recommendation, ratify or override a prior conclusion, or postmortem a failed run. The pickup playbook ends here. The routed playbook owns the rest. 5. Verify the inherited claims against the original goal on the real artifact (the **principle-prove-it-works** skill). A passing prior self-report is not the proof. diff --git a/pstack/skills/principle-boundary-discipline/SKILL.md b/pstack/skills/principle-boundary-discipline/SKILL.md index dfe9a6fb0..f86bff809 100644 --- a/pstack/skills/principle-boundary-discipline/SKILL.md +++ b/pstack/skills/principle-boundary-discipline/SKILL.md @@ -29,6 +29,11 @@ Code organization: - Prompt construction: structured state in, string out - Scoring and assessment: pure transforms from state to results +Measurement and adversarial engagements: +- Guards belong at the engagement edge: the authorized targets, credentials, and budget +- Every interior restriction must trace to the engagement's stated goal, or be labeled a human option +- An interior fence silently changes what the measurement means + **The tests:** - "Is this data crossing a system boundary right now?" If not, validation is redundant. - "Can this be a pure function that the shell just calls?" If yes, extract it. diff --git a/pstack/skills/principle-prove-it-works/SKILL.md b/pstack/skills/principle-prove-it-works/SKILL.md index 4563023d4..256149328 100644 --- a/pstack/skills/principle-prove-it-works/SKILL.md +++ b/pstack/skills/principle-prove-it-works/SKILL.md @@ -30,4 +30,6 @@ When verifying delegated work, inspect the actual output artifact (git diff, fil The strongest proof is a deterministic script that re-runs the same comparison, not a one-time eyeball. Write the script, run it, and keep its output as an artifact a reviewer can re-run instead of trusting your word. +Empty or missing verification output is a failed verification, never a pass. Make the script assert loudly on the empty case; a silent green run is a defect in the check itself. + Keep the artifact visible for the human. Commit it only for large or complex work where the trail has to be auditable later, like a big port or migration (the **show-me-your-work** skill). diff --git a/pstack/skills/reflect/SKILL.md b/pstack/skills/reflect/SKILL.md index d00495178..7c552f444 100644 --- a/pstack/skills/reflect/SKILL.md +++ b/pstack/skills/reflect/SKILL.md @@ -16,7 +16,7 @@ Invoke when the user says "reflect" or "/reflect". Skip when the conversation is ### 1. Locate the active transcript -The parent finds its own transcript file before fanning out. The system prompt names the active workspace's `agent-transcripts/` directory. Use that path. Do not glob across `~/.cursor/projects/*/`. That crosses workspace boundaries and reads private chats from unrelated projects. +The parent finds its own transcript file before fanning out. Detect the harness first. Cursor writes JSONL under the active workspace's `agent-transcripts/` directory (the system prompt names the path; use it, and do not glob across `~/.cursor/projects/*/`). OpenCode stores sessions in `~/.local/share/opencode/opencode.db`; open it read-only with `?immutable=1` and export to text. Codex writes rollout files under `~/.codex`. Never cross workspace boundaries or read private chats from unrelated projects. ```bash ls -t /*.jsonl /*/*.jsonl /*/subagents/*.jsonl 2>/dev/null | head -10