mirror of
https://github.com/cursor/plugins.git
synced 2026-09-14 20:00:00 +08:00
lauren
71ed0d1076
* chore(pstack): bump plugin version to 0.15.0 Co-authored-by: lauren <poteto@users.noreply.github.com> * docs(pstack): sync playbook count and table to twenty-three The tree ships 23 playbooks, and the README table omitted opening-a-pr. Add the row and change the two README counts and the guide's front-door count from twenty-two to twenty-three. Co-authored-by: lauren <poteto@users.noreply.github.com> * docs(pstack): fix principle count in guide index and 08 heading The guide index and the 08 heading still said 21 while the tree and the 08 body list 23 principles. Co-authored-by: lauren <poteto@users.noreply.github.com> --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com>
72 lines
5.1 KiB
Markdown
72 lines
5.1 KiB
Markdown
# Steer with principle names
|
|
|
|
pstack ships 23 principles as individual skills. `/poteto-mode` reads their index at the start of every multi-step task, applies the ones the task triggers, and names each applied principle in its reply along with the decision it changed.
|
|
|
|
You don't invoke principles. You use their names to steer. Each name points at a complete rule the agent has already read, so one phrase redirects the work more precisely than a paragraph of instructions.
|
|
|
|
## Steering in practice
|
|
|
|
Say the agent is about to bolt a new adapter onto three existing ones:
|
|
|
|
```text
|
|
use subtract before you add. delete the obsolete adapters first, then design what's left.
|
|
```
|
|
|
|
Say it claims success because the build passed:
|
|
|
|
```text
|
|
apply prove it works. run the real import flow and show me the written records.
|
|
```
|
|
|
|
Say two parallel attempts are about to write to the same branch:
|
|
|
|
```text
|
|
separate before serializing shared state. give each attempt its own worktree, no locks.
|
|
```
|
|
|
|
Each phrase lands because the rule behind it is specific. The agent still has to say, in its reply, which decision the rule changed. A principle citation with no decision behind it is the tell that it name-dropped instead of applying.
|
|
|
|
## The 23, briefly
|
|
|
|
The core principles decide how much to build and when to rethink the design:
|
|
|
|
- [Laziness Protocol](../../skills/principle-laziness-protocol/SKILL.md) prefers deletion and the smallest change that solves the problem.
|
|
- [Foundational Thinking](../../skills/principle-foundational-thinking/SKILL.md) chooses the core data structures before writing logic.
|
|
- [Redesign from First Principles](../../skills/principle-redesign-from-first-principles/SKILL.md) integrates a new requirement as if it had been there from day one.
|
|
- [Attack the Premise](../../skills/principle-attack-the-premise/SKILL.md) questions the premise that two or more failed fixes shared, after a census of which actors hold the imbalance.
|
|
- [Subtract Before You Add](../../skills/principle-subtract-before-you-add/SKILL.md) removes dead weight before building on top of it.
|
|
- [Minimize Reader Load](../../skills/principle-minimize-reader-load/SKILL.md) collapses layers and hidden state a reader must hold in their head.
|
|
- [Outcome-Oriented Execution](../../skills/principle-outcome-oriented-execution/SKILL.md) converges rewrites on the target design instead of preserving throwaway compatibility states.
|
|
- [Experience First](../../skills/principle-experience-first/SKILL.md) chooses the user's result over implementation convenience.
|
|
- [Exhaust the Design Space](../../skills/principle-exhaust-the-design-space/SKILL.md) builds two or three competing prototypes when there's no precedent.
|
|
- [Build the Lever](../../skills/principle-build-the-lever/SKILL.md) builds the script that does or proves the work, so a reviewer can rerun it.
|
|
|
|
The architecture principles decide where state, validation, and compatibility live:
|
|
|
|
- [Model the Domain](../../skills/principle-model-the-domain/SKILL.md) encodes repeated rules in one structure, not scattered conditionals.
|
|
- [Boundary Discipline](../../skills/principle-boundary-discipline/SKILL.md) validates at the boundary and trusts internal types.
|
|
- [Type System Discipline](../../skills/principle-type-system-discipline/SKILL.md) makes illegal states unrepresentable.
|
|
- [Make Operations Idempotent](../../skills/principle-make-operations-idempotent/SKILL.md) converges retries on the same end state.
|
|
- [Migrate Callers Then Delete Legacy APIs](../../skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md) migrates and deletes in one wave.
|
|
- [Separate Before Serializing Shared State](../../skills/principle-separate-before-serializing-shared-state/SKILL.md) removes the sharing before adding coordination.
|
|
|
|
The verification principles define what counts as proof:
|
|
|
|
- [Prove It Works](../../skills/principle-prove-it-works/SKILL.md) verifies the real artifact, not a proxy.
|
|
- [Fix Root Causes](../../skills/principle-fix-root-causes/SKILL.md) reproduces and traces to the cause before changing code.
|
|
- [Sequence Work into Verifiable Units](../../skills/principle-sequence-verifiable-units/SKILL.md) ends each small unit in a check before starting the next.
|
|
- [Test Behavior, Not Implementation](../../skills/principle-test-behavior-not-implementation/SKILL.md) calls the code the way its users do and asserts a literal expected value, and deletes a test that would still pass if every imported function returned `undefined`.
|
|
|
|
The delegation principles keep parallel work sane:
|
|
|
|
- [Guard the Context Window](../../skills/principle-guard-the-context-window/SKILL.md) routes bulk reading to subagents and keeps findings in the main chat.
|
|
- [Never Block on the Human](../../skills/principle-never-block-on-the-human/SKILL.md) proceeds on reversible work and presents the result.
|
|
|
|
And one meta principle:
|
|
|
|
- [Encode Lessons in Structure](../../skills/principle-encode-lessons-in-structure/SKILL.md) turns advice you've repeated twice into a lint, check, or script.
|
|
|
|
Don't memorize the list. Skim it now, then come back when you catch the agent doing something a name here would have prevented. That's how the vocabulary sticks.
|
|
|
|
Next: [Make it yours](./09-make-it-yours.md).
|