poteto-mode

Routes engineering tasks to playbooks with principles, subagent delegation, and verified delivery.

Updated Sep 23, 2026
One-click install
npx skills add https://github.com/lucasheriques/pstack --skill poteto-mode-lucasheriques
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: poteto-mode
Source: https://github.com/lucasheriques/pstack/tree/main/skills/poteto-mode
Command: npx skills add https://github.com/lucasheriques/pstack --skill poteto-mode-lucasheriques

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, and includes scripts (resource) and references (resource) components.

What problem does it solve? Engineering tasks handled ad hoc by an AI agent often skip reproduction, verification, design exploration, and review, producing unverified code and sloppy prose. This Skill imposes a disciplined operating mode that matches each task to a playbook, applies named engineering principles, and requires runtime evidence before declaring work done. ## Core Features & Use Cases - Playbook routing: Matches tasks to over twenty playbooks covering bug fixes, features, refactoring, perf, investigations, PR babysitting, shipping, autonomous runs, and multi-phase plans, copying steps into a todo list. - Principle-driven decisions: Applies a catalog of core, architecture, verification, delegation, and meta principles (laziness protocol, model the domain, prove it works) and cites each one that shaped a decision. - Subagent orchestration: Delegates code to typed subagents with per-role model assignments from references/models.md, plus swarm verification, adversarial interrogate reviews, and arena bakeoffs. - Use Case: Ask the agent to fix a reported defect. It reproduces the bug on the real surface, binary-searches the root cause, delegates the fix, verifies the repro passes, stages the failing test before the fix, and opens a PR. ## Quick Start Ask the agent to enter poteto mode and fix the login timeout bug, verifying the reproduction passes before opening a PR.

Frequently Asked Questions about poteto-mode

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use poteto-mode for a bug fix?▼

Invoke it with /pstack:poteto-mode or let it activate on an engineering task. It matches the Bug fix playbook, reproduces the defect on the real surface, isolates the root cause, delegates the fix, and verifies the original repro passes before opening a PR.

What playbooks does poteto-mode include?▼

It bundles playbooks for investigation, bug fix, perf issue, hillclimb, runtime and trace forensics, feature, refactoring, prototype, visual parity, eval, babysit, shipping, autonomous run, orchestrate, autopilot variants, session pickup, multi-phase plans, and opening PRs.

How does poteto-mode delegate work to subagents?▼

It spawns pstack:poteto-agent subagents with run_in_background and explicit models from references/models.md. Code delegates use sonnet, the hardest tasks escalate to opus, and review panels fan out across multiple models.

Does poteto-mode work with GitHub pull request workflows?▼

Yes. The Babysit playbook drives PRs to merge-ready using gh and a watch-pr script, triaging review-bot comments skeptically. The Shipping playbook independently verifies a green stack and lands the contiguous verified run bottom-up.

When should I not use poteto-mode?▼

Skip it for casual conversational turns or when the user opts out. It is designed for engineering tasks matching a playbook or needing rigor, and its overhead is not warranted for trivial questions.