All plugins

pstack

Engineering rigor stack: poteto-mode orchestrator with 17 playbooks, plus how, architect, interrogate, swarm, unslop, and 46 other skills and principles. Disclosure — skills only, no tools or network calls of their own; when the user asks, the setup-pstack skill changes Hermes `delegation` model/provider/reasoning settings via `hermes config set`, the autopilot, shipping and babysit playbooks push and force-push the agent's own branches, squash-merge pull requests and arm hourly Hermes cron jobs to watch them, and the reflect skill files backlog issues in your team's tracker without asking per item.

Cloeille13Toolsv0.3.1Updated 11 days ago

About

Engineering rigor stack: poteto-mode orchestrator with 17 playbooks, plus how, architect, interrogate, swarm, unslop, and 46 other skills and principles. Disclosure — skills only, no tools or network calls of their own; when the user asks, the setup-pstack skill changes Hermes `delegation` model/provider/reasoning settings via `hermes config set`, the autopilot, shipping and babysit playbooks push and force-push the agent's own branches, squash-merge pull requests and arm hourly Hermes cron jobs to watch them, and the reflect skill files backlog issues in your team's tracker without asking per item.

pstack - Hermes Plugin

Poteto's engineering rigor stack, adapted for Hermes Agent.

Fork of pstack by poteto (Meta/Netflix, React core team). Originally built as a Cursor plugin, adapted here for Hermes Agent with native skills, delegate_task orchestration, and playbook routing.

What it does

One orchestrator skill (poteto-mode) routes tasks to playbooks. Supporting skills cover exploration, design, review, delegation, cleanup, memory, teaching, verification, and workflow.

| Skill | Purpose |
|-------|---------|
| pstack:poteto-mode | Orchestrator and playbook routing. |
| pstack:how | Codebase exploration. |
| pstack:architect | Design types and module boundaries. |
| pstack:interrogate | Adversarial multi-reviewer review. |
| pstack:swarm | Parallel workers and aggregation. |
| pstack:unslop | Clean AI writing patterns from prose. |
| pstack:deslop | Clean AI code slop from diffs. |
| pstack:setup-pstack | Configure the delegate model and reasoning budget. |
| pstack:automate-me, pstack:recall, pstack:reflect, pstack:show-me-your-work, pstack:why | Personalization, history, reflection, evidence, and intent. |
| pstack:benchmark-checklist, pstack:blast-radius, pstack:bro, pstack:create-verification-skill, pstack:figure-it-out, pstack:maintain-verification-skill, pstack:no-comments, pstack:tdd, pstack:teach, pstack:technical-writing, pstack:typescript-best-practices | Focused engineering workflows. |
| principle-* (20 skills) | Engineering principles used by the orchestrator. |

Playbooks

Loaded via skill_view(name='pstack:poteto-mode', file_path='playbooks/<name>.md'):

  • investigation.md - read-only question, trace behavior
  • bug-fix.md - reproduce, root-cause, fix with evidence
  • feature.md - plan, design, delegate, verify
  • perf-issue.md - measure, profile, fix, measure again
  • refactoring.md - behavior-preserving restructuring
  • autonomous-run.md - long task with falsifiable exit predicate
  • figure-it-out.md - large/cross-cutting work, design your own workflow

Guide

Read the guide in order the first time. After that, each page stands alone.

  1. Set up pstack - install, pick models, first task
  2. Route work through poteto-mode - give it a goal, watch it pick a playbook
  3. Understand the code - pstack:how before you edit anything
  4. Design the change - pstack:architect and pstack:interrogate before code locks in
  5. Build and clean - build playbooks, TDD, unslop
  6. Verify and ship - prove behavior, open a PR, merge
  7. Run work overnight - autonomous contracts, decision logs
  8. Principles - the full set in detail
  9. Make it yours - customize skills and playbooks
  10. Recipes and pitfalls - prompts to copy, mistakes to skip

Slash commands

Add the plugin's skills directory to skills.external_dirs so each skill registers as a slash command:

hermes config set skills.external_dirs '["plugins/pstack/skills"]'

Then in any chat session:

| Command | What it does |
|---------|--------------|
| /poteto-mode | Load the orchestrator (task routing, principles, delegation). |
| /how | Codebase exploration. "How does X work?" |
| /architect | Design types and boundaries before building. |
| /interrogate | Adversarial multi-reviewer code review. |
| /swarm | Fan out parallel workers. |
| /unslop | Strip AI writing patterns from prose. |
| /setup-pstack | Pick the delegate model and reasoning budget. |

Append an instruction after the command: /how how does auth work in this repo

Skills are also loadable programmatically via skill_view(name='pstack:<skill>').

Install

Symlink or copy into your Hermes profile plugins directory:

ln -s /path/to/pstack ~/.hermes/profiles/<profile>/plugins/pstack

# Enable slash commands
hermes config set skills.external_dirs '["plugins/pstack/skills"]'

Hermes loads it on next session start.

License

MIT

README from the reviewed commit d9454cc; it updates when the author re-pins.