Skip to content

feat: sync latest pstack additions (teach, verification skills, Model the Domain) #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
HustleCoding merged 1 commit into from
Jul 13, 2026
Merged

feat: sync latest pstack additions (teach, verification skills, Model the Domain) #7

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -205,9 +205,9 @@
<div class="glyph" aria-hidden="true"><i></i><i></i><i></i></div>
<h1 class="wordmark">p<span>stack</span></h1>
</div>
<p class="count">20 principles · 17 playbooks · 16 skills</p>
<p class="count">21 principles · 17 playbooks · 19 skills</p>
<p class="tagline">Engineering skills that turn a coding agent into a careful crew. You describe a task, and pstack matches it to a <em>playbook</em>.</p>
<p class="intro-lead">Type <code>/poteto-mode</code> and describe a task. pstack matches it to a playbook and runs the skills as the steps fire. Twenty principles apply across every playbook, biasing the work toward small diffs and real verification.</p>
<p class="intro-lead">Type <code>/poteto-mode</code> and describe a task. pstack matches it to a playbook and runs the skills as the steps fire. Twenty-one principles apply across every playbook, biasing the work toward small diffs and real verification.</p>
</div>
</header>

Expand Down Expand Up @@ -269,7 +269,7 @@ <h2>Skills</h2>
<div class="sh">
<span class="num">04</span>
<h2>Principles</h2>
<p class="lead">Twenty rules in five families. Tap any one to see when it applies and what it says.</p>
<p class="lead">Twenty-one rules in five families. Tap any one to see when it applies and what it says.</p>
</div>
<div id="pstack"></div>
</div>
Expand Down Expand Up @@ -359,7 +359,10 @@ <h3 id="dtitle"></h3>
{cmd:"/typescript-best-practices", when:"You are reading or editing TypeScript. Grounds the type-system-discipline principle in syntax."},
{cmd:"/figure-it-out", when:"No bundled playbook fits. Designs a rigorous, auditable playbook for the task."},
{cmd:"/show-me-your-work", when:"You want a reviewable decision trail. Logs decisions to a TSV you can commit."},
{cmd:"/unslop", when:"You are cleaning up writing. Removes AI tells."}
{cmd:"/unslop", when:"You are cleaning up writing. Removes AI tells."},
{cmd:"/teach", when:"Explain a body of work plainly so a person actually understands it. Runs `how` and `why` and weaves what they find into one clear explanation."},
{cmd:"/create-verification-skill", when:"Generate a project-local verification skill that drives your app the way a user does — any language, framework, or platform."},
{cmd:"/maintain-verification-skill", when:"Periodic pass that keeps a project's verification skill and feature map honest."}
];

const GROUPS = [
Expand All @@ -386,6 +389,7 @@ <h3 id="dtitle"></h3>
{g:"arch", n:"Make Operations Idempotent", applies:"Designing commands, lifecycle steps, or loops that run amid crashes and retries.", rule:"Converge to the same end state regardless of partial prior runs."},
{g:"arch", n:"Migrate Callers Then Delete Legacy APIs", applies:"Introducing a new internal API while old callers exist.", rule:"Migrate callers and remove the old API in the same wave. No compatibility layers."},
{g:"arch", n:"Separate Before Serializing Shared State", applies:"Concurrent actors might write the same file, branch, key, or object.", rule:"Eliminate the sharing first. When sharing is real, enforce serialization structurally."},
{g:"arch", n:"Model the Domain", applies:"When writing stateful logic, or when code branches a lot or repeats a shape assumption across files.", rule:"Encode the real domain in a data structure instead of scattering it across conditionals. Reach for state machines, typed models, lookup tables, reducers, or small module boundaries that gather repeated behavior. Don't force an abstraction if the current shape is already clear and local."},

{g:"verif", n:"Prove It Works", applies:"After a task, before declaring done.", rule:"Verify against the real artifact. Not a proxy. Not that it compiles."},
{g:"verif", n:"Fix Root Causes", applies:"Debugging.", rule:"Trace each symptom to its root cause. Reproduce first. Ask why until you reach it."},
Expand Down
13 changes: 13 additions & 0 deletions llms-full.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,15 @@ When to use: You want a reviewable decision trail. Logs decisions to a TSV you c
### /unslop
When to use: You are cleaning up writing. Removes AI tells.

### /teach
When to use: Explain a body of work plainly so a person actually understands it. Runs `how` and `why` and weaves what they find into one clear explanation.

### /create-verification-skill
When to use: Generate a project-local verification skill that drives your app the way a user does — any language, framework, or platform.

### /maintain-verification-skill
When to use: Periodic pass that keeps a project's verification skill and feature map honest.

## Principles

Twenty rules in five families. Each principle has a name, when it applies, and the rule to follow.
Expand Down Expand Up @@ -202,6 +211,10 @@ Boundaries, types, and shared state across concurrent actors.
- Applies when: Concurrent actors might write the same file, branch, key, or object.
- Rule: Eliminate the sharing first. When sharing is real, enforce serialization structurally.

- **Model the Domain**
- Applies when: When writing stateful logic, or when code branches a lot or repeats a shape assumption across files.
- Rule: Encode the real domain in a data structure instead of scattering it across conditionals. Reach for state machines, typed models, lookup tables, reducers, or small module boundaries that gather repeated behavior. Don't force an abstraction if the current shape is already clear and local.

### Verification
Proving it works against the real artifact, and ordering the work so each step can be checked.

Expand Down