poteto-mode

Enforces a disciplined agent workflow with playbooks, principles, and verified subagent delegation.

4|1|Updated Dec 16, 2023
One-click install
npx skills add https://github.com/Shtian/AuthentiClash --skill poteto-mode-shtian
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: poteto-mode
Source: https://github.com/Shtian/AuthentiClash/tree/main/.claude/skills/poteto-mode
Command: npx skills add https://github.com/Shtian/AuthentiClash --skill poteto-mode-shtian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding agents often produce verbose prose, unverified claims, and ad-hoc changes without a consistent process. This Skill imposes a rigorous operating style: named engineering principles, task-matched playbooks, deliberate subagent delegation, and evidence-backed verification before anything ships. ## Core Features & Use Cases - Task-matched playbooks: Routes work to Investigation, Bug fix, Perf issue, Feature, Refactoring, Prototype, or Shipping playbooks, each with verbatim step lists and reply formats. - Named principles library: Applies core, architecture, verification, delegation, and meta principles (e.g., Laziness Protocol, Model the Domain, Prove It Works) with explicit citation of each principle that shaped a decision. - Subagent discipline: Prescribes background subagents, model roles for adversarial review, and owner-side diff review so delegated work is verified, not trusted. - Use Case: A developer asks the agent to fix a reported bug. The agent reproduces it via a control skill, binary-searches the root cause with runtime evidence, delegates the fix, verifies on the same surface, and opens a PR with a structured description. ## Quick Start Invoke /poteto-mode and ask the agent to fix a bug or build a feature so it follows the matching playbook end to end.

Frequently Asked Questions about poteto-mode

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

FAQPage Schema
How do I make an AI coding agent follow a structured workflow?▼

Invoke poteto-mode, which routes each task to a matching playbook such as Bug fix, Feature, or Refactoring. Each playbook defines verbatim steps covering planning, delegation, verification, and PR opening, so the agent follows a repeatable process instead of improvising.

How does the agent verify bug fixes before shipping?▼

The Bug fix playbook requires the agent to reproduce the defect itself on the matching surface, binary-search hypotheses with runtime evidence, and confirm the original repro passes after the fix. Inconclusive or wrong-surface results are flagged, not counted as passes.

Can poteto-mode handle shipping stacked pull requests?▼

Yes, the Shipping playbook independently verifies each PR with a separate subagent, lands only the contiguous verified run from the root, and re-checks patch IDs after rebases. It uses the GitHub CLI for merge, retarget, and watch operations.

When should I use the Prototype playbook instead of Feature?▼

Use Prototype when a design or behavioral decision is unresolved, such as choosing a layout or settling an empirical question by observation. It builds throwaway sketches in a scratch directory, then hands the chosen direction to the Feature playbook for the real build.

What are the limitations of this agent style?▼

The style adds process overhead, so trivial one-line changes may not justify full playbook routing. It also depends on companion skills like how, architect, interrogate, and unslop being available, and it pauses for irreversible actions such as deploys or force-pushes.