Skip to content

Cursor plugin specification and official plugins

TypeScript

pstack: add build-the-lever principle (#84)

lauren7b1c32e4c342
diff --git a/pstack/README.md b/pstack/README.md
index 37dc0178..e15fe758 100644
--- a/pstack/README.md
+++ b/pstack/README.md
@@ -103,9 +103,9 @@ pstack also ships a subagent that runs my style end to end. spawn it from a pare
## principles
-eighteen short skills, one principle each. `poteto-mode` indexes them inline and reads that index at task start. the standalone files are there so other skills can reference a principle by name, and so the index can point at the full rule for each.
+nineteen short skills, one principle each. `poteto-mode` indexes them inline and reads that index at task start. the standalone files are there so other skills can reference a principle by name, and so the index can point at the full rule for each.
-- core: laziness-protocol, foundational-thinking, redesign-from-first-principles, subtract-before-you-add, minimize-reader-load, outcome-oriented-execution, experience-first, exhaust-the-design-space.
+- core: laziness-protocol, foundational-thinking, redesign-from-first-principles, subtract-before-you-add, minimize-reader-load, outcome-oriented-execution, experience-first, exhaust-the-design-space, build-the-lever.
- architecture: boundary-discipline, type-system-discipline, make-operations-idempotent, migrate-callers-then-delete-legacy-apis, separate-before-serializing-shared-state.
- verification: prove-it-works, fix-root-causes.
- delegation: guard-the-context-window, never-block-on-the-human.
diff --git a/pstack/skills/poteto-mode/SKILL.md b/pstack/skills/poteto-mode/SKILL.md
index 7243dfe8..7f0f8555 100644
--- a/pstack/skills/poteto-mode/SKILL.md
+++ b/pstack/skills/poteto-mode/SKILL.md
@@ -38,6 +38,7 @@ Read the leaf skill in full for any principle you apply.
- **Outcome-Oriented Execution.** The **principle-outcome-oriented-execution** skill. Apply during planned rewrites and migrations with explicit phase boundaries. Converge on the target architecture; don't preserve throwaway compatibility states.
- **Experience First.** The **principle-experience-first** skill. Apply on product, UX, or feature-scope tradeoffs. Choose user delight over implementation convenience.
- **Exhaust the Design Space.** The **principle-exhaust-the-design-space** skill. Apply on a novel interaction or architectural decision with no precedent. Build 2-3 competing prototypes and compare before committing.
+- **Build the Lever.** The **principle-build-the-lever** skill. Apply when work is repetitive or bulk. Build the tool that amortizes it (codemod, script, generator) once you know the recipe, instead of grinding by hand.
**Architecture**
diff --git a/pstack/skills/principle-build-the-lever/SKILL.md b/pstack/skills/principle-build-the-lever/SKILL.md
new file mode 100644
index 00000000..b866f41b
--- /dev/null
+++ b/pstack/skills/principle-build-the-lever/SKILL.md
@@ -0,0 +1,20 @@
+---
+name: principle-build-the-lever
+description: "Apply when work is repetitive or bulk: many similar edits, a check you'll rerun, a population to transform. Build the tool that amortizes it (codemod, script, generator) once you know the recipe, instead of grinding by hand."
+disable-model-invocation: true
+---
+# Build the Lever
+
+When the work repeats, build the tool that does it instead of grinding by hand.
+
+**Why:** Doing the same edit a hundred times is slow and drifts into inconsistent mistakes. A codemod, generator, or script does it once, the same way every time, reruns for free, and gives a reviewer one artifact to check.
+
+**Pattern:** When you would otherwise repeat a transform, a check, or a setup more than a handful of times, build the lever instead.
+
+- Do the first few by hand to learn the exact recipe, then build the tool. Don't build on a guess.
+- Codemod or script for bulk edits, generator for repetitive files, a dump-to-sqlite query for repeated analysis, a rerunnable check for repeated verification.
+- Commit it when the work outlives the session, so the next run reruns it instead of redoing it.
+
+**Balance:** Leverage, not gold-plating. The [Laziness Protocol](../principle-laziness-protocol/SKILL.md) still holds. Build the lever only when it pays for itself across the remaining work, never for a one-off.
+
+Distinct from [Encode Lessons in Structure](../principle-encode-lessons-in-structure/SKILL.md), which makes a recurring instruction a durable guardrail. This is throughput on the work in front of you.