Repository navigation
Conversation
Size and stacks now defaults to one PR per change the operator asked for, with small ordered commits inside it. A stack needs a measured collision. The Commits paragraph no longer calls each commit a future PR.
Feature drops "Stack follow-ups", and Visual parity opens one PR instead of one per component. The multi-phase plan treats a PR as one requested change and names the collision behind each split. figure-it-out asks for verifiable units, not landable ones. The guide and the /poteto-help recipes stop asking for many small PRs.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Opening a PR told agents to prefer five narrow PRs to one large PR. In real use, operators kept collapsing agent-built stacks of narrow PRs back into one PR, so the default produced work they undid. The new default is one PR per requested change, with a stack only when a measured collision forces it.
What changed
Size and stacksinopening-a-pr.mdnow opens with the one-PR default and names the two collisions that justify a split./poteto-helprecipes stop asking for many small PRs. The version moves to 0.15.16.Scope
Blast Radius
Agents that run poteto-mode open one PR per change and stack only on a named collision. Stack mechanics and the autopilot queues do not change.
Verification
node scripts/validate-plugins.mjspasses.check-plan.mjson the multi-phase plan skeleton reports the same single unfilled-placeholder problem as trunk.pstack/for "five narrow", "small verifiable PRs", "future PR", and "Stack follow-ups" returns nothing.Note
Low Risk
Documentation and agent playbook guidance only; no product code or runtime behavior changes beyond how poteto-mode agents are instructed to open PRs.
Overview
pstack now tells agents to open one PR per change the operator asked for, with small ordered commits inside it, instead of defaulting to many narrow PRs or stacks.
The
Size and stackssection inopening-a-pr.mdis the anchor: split into a stack only when a measured collision forces it (e.g. an open PR rewrites the same hunk and must land first, or a part needs its own rollout). “Easier to review” or fewer files is no longer a reason to split. Related playbooks (feature,visual-parity,multi-phase-plan),figure-it-out, the user guide, andpoteto-helprecipes drop “small verifiable PRs,” per-component PRs, and “stack follow-ups” language while keeping commit and verification granularity (sequence-verifiable-units) unchanged.Plugin version bumps to 0.15.16.
Reviewed by Cursor Bugbot for commit 1d2de01. Bugbot is set up for automated code reviews on this repo. Configure here.