Vibeleaderboard
← All Intel
Intel / post

Steering coding agents with named principle skills in pstack

Source
x.com
Date
lauren@poteto
Thread · 8 parts

perhaps one of the most durable parts of pstack are its engineering principles: very concise skills (~10-20 loc) that distill down good practices into its core. as models get smarter, i expect most of pstack skills to compress into short principles or workflows (a generic list of steps) and that i will be able to delete a few of them. how it works is that /poteto-mode contains a short index of available principles and tells agents "In your reply, name each principle that shaped a decision and the specific choice it changed." this is why you'll often see a Principles Named or Used section at the end of the agent's response many of these principles were extracted from my sessions correcting agents since the start of this year. some are inspired by problems i see people talk about, like Attack the Premise, inspired by @VictorTaelin's post https://t.co/qTGVfoKSyD you can also use the principles as skills if you want greater control, by invoking /principle-<name> https://t.co/wuTWsflVN3

https://t.co/lOpojdZtT2

i like the flexibility of skills since you can omit or invoke on demand! but in general i'm a big advocate of moving prose into deterministic code: lint rules, strong types, good API design are superior to comments, agents.md, rules, skills for pstack efficiency, definitely run /setup-pstack and choose your budget level, and when you invoke /poteto-mode you can also tell your agent not to create large swarms of subagents and it should remember that for the rest of the session. that's usually where the cost comes from

@talleman21 yeah you can tell your bot to always spawn cloud agents with the mode set to poteto-mode by default, that's a param in the spawn agent tool

Read the full thread on X

Context

In pstack, engineering principles work as a shared vocabulary between the person and the coding . pstack is an open-source pack for Cursor agents published by lauren, whose README calls them the skills the author uses every day at Cursor (repository). It ships 24 principles, each a short skill holding one rule; in the thread lauren puts them at roughly 10 to 20 lines each. The main /poteto-mode skill carries an index of them, reads it at the start of every multi-step task, applies the ones the task triggers, and is told to name in its reply each principle that shaped a decision and the specific choice it changed. That instruction is why pstack replies often end with a list of the principles named or used. Anyone who wants more direct control can invoke a single rule as a skill, with a /principle- command followed by that principle’s name.

The project's principles guide says you don't invoke principles so much as steer with their names. Because each name points to a complete rule the agent has already read, a short phrase can redirect it more precisely than a paragraph of new instructions. If an agent claims success because the build passed, "apply prove it works" plus a request to run the real flow sends it back to check the actual result rather than a proxy. If it is about to add a fourth adapter next to three old ones, "subtract before you add" tells it to delete the obsolete ones first. The required citation also gives the reader something to check: the guide says a principle cited without a decision behind it is the sign the agent name-dropped the rule instead of applying it.

lauren treats the prose itself as provisional. The thread says many principles came from lauren's own sessions correcting agents this year, that most pstack skills are expected to shrink into short principles or step lists as models improve, and that some can probably be deleted. The author also generally prefers moving guidance into deterministic code, since lint rules, strong types and good API design beat comments, agents.md files, rules and skills. pstack's own meta principle, Encode Lessons in Structure, says the same thing: turn advice you've repeated into a lint, check or script. In an earlier post lauren argued that letting agents verify their own work comes first and that skill packs are an optional extra. On cost, the thread says the main expense comes from large swarms of subagents, and that you can tell /poteto-mode not to spawn them.

Terms in this piece · Glossary
  • AI agent — An AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.
  • agent skill — A reusable instruction file that teaches an agent how to do one job well — the procedure, the tools, and what counts as done.
More from lauren
Recommended reads
Comments

Checking sign-in…

Loading comments…