From 1412bd390ccdce852a6878bc70ab138967a6fc10 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Mon, 13 Jul 2026 12:56:41 +0000 Subject: [PATCH 1/9] feat: add teach, verification skills and Model the Domain principle from latest pstack Co-Authored-By: Florin --- index.html | 12 ++++++++---- llms-full.txt | 13 +++++++++++++ 2 files changed, 21 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index 3d5fedc..a434017 100644 --- a/index.html +++ b/index.html @@ -205,9 +205,9 @@

pstack

-

20 principles · 17 playbooks · 16 skills

+

21 principles · 17 playbooks · 19 skills

Engineering skills that turn a coding agent into a careful crew. You describe a task, and pstack matches it to a playbook.

-

Type /poteto-mode 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.

+

Type /poteto-mode 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.

@@ -269,7 +269,7 @@

Skills

04

Principles

-

Twenty rules in five families. Tap any one to see when it applies and what it says.

+

Twenty-one rules in five families. Tap any one to see when it applies and what it says.

@@ -359,7 +359,10 @@

{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 = [ @@ -386,6 +389,7 @@

{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."}, diff --git a/llms-full.txt b/llms-full.txt index a158eb3..6f74dd9 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -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. @@ -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. From 7c88c828fc8ed0ae19c33643a8dd7f50cb627bda Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Mon, 13 Jul 2026 19:53:25 +0000 Subject: [PATCH 2/9] feat: add Agent Templates section for lionbenjamin/agent-templates Co-Authored-By: Florin --- index.html | 97 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) diff --git a/index.html b/index.html index a434017..1c5cff0 100644 --- a/index.html +++ b/index.html @@ -30,6 +30,7 @@ --rule:#ededed; --rule2:#e0e0e0; --accent:#b45309; --accent-soft:#fdf4ea; --accent-line:#e8c39a; --core:#b45309; --arch:#1f6f8b; --verif:#4d7c2f; --deleg:#b13a5a; --meta:#7c4d9e; + --t-setup:#7c4d9e; --t-sdlc:#b45309; --t-orch:#b13a5a; --t-special:#1f6f8b; --maxw:880px; --navh:54px; --ff:"Hanken Grotesk",system-ui,-apple-system,sans-serif; --ff-mono:"IBM Plex Mono",ui-monospace,monospace; @@ -71,6 +72,8 @@ .sh .num{color:var(--accent); font-family:var(--ff-mono); font-size:12px; letter-spacing:.04em} .sh h2{font-weight:600; font-size:clamp(24px,3.6vw,31px); margin:7px 0 12px; letter-spacing:-.018em; line-height:1.15} .sh .lead{color:var(--dim); font-size:16px; line-height:1.6; margin:0; max-width:60ch} + .sh .lead a{color:var(--accent); text-decoration:none; border-bottom:1px solid var(--accent-line)} + .sh .lead a:hover{border-bottom-color:var(--accent)} /* routing */ .flow{margin:0 0 28px; font-size:15px; color:var(--dim); line-height:1.9} @@ -167,6 +170,8 @@ .kind.panel{color:var(--arch); border-color:rgba(31,111,139,.35); background:rgba(31,111,139,.06)} .mowns{color:var(--dim); font-size:13.5px; line-height:1.5} .models-note{color:var(--faint); font-size:13.5px; margin-top:20px; max-width:60ch; line-height:1.6} + .tmpl-note a{color:var(--accent); text-decoration:none; border-bottom:1px solid var(--accent-line)} + .tmpl-note a:hover{border-bottom-color:var(--accent)} /* modal */ .overlay{position:fixed; inset:0; background:rgba(20,20,20,.45); backdrop-filter:blur(4px); display:none; align-items:center; justify-content:center; z-index:60; padding:clamp(16px,4vw,24px)} @@ -218,6 +223,7 @@

pstack

Skills Principles Models + Templates Changelog @@ -287,6 +293,19 @@

Models per role

+
+
+
+ 06 +

Agent Templates

+

A companion toolkit by lionbenjamin: spec-driven agent workflows you install into Antigravity, Cursor, and Claude Code. Same idea as pstack — named workflows a coding agent runs — but organized as a spec-first SDLC, from a written constitution through spec, plan, code, and deploy.

+
+

/constitute → /specify → /plan → /implement → /deploy → /retro

+
+

Install every workflow with ./install-workflows.sh, which copies them into ~/.claude/commands/, ~/.cursor/commands/, and the Antigravity dirs. Every step reads a shared technical constitution and a lessons-learned memory file, so the spec, the plan, the code, and the review stay consistent across sessions — spec-driven rigor with an auditable trail instead of one-shot vibe coding. Source and full docs: lionbenjamin/agent-templates.

+
+
+