Skip to content
CloeillePublic

About

Poteto's engineering rigor stack, adapted as a Hermes Agent plugin

Resources

Stars

17 stars

Watchers

0 watching

Forks

Latest commit

 

History

38 Commits

Folders and files

Repository files navigation

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 Adversaries break a change; only run-proven findings survive.
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 Adversaries break a change; only run-proven findings survive.
/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.

Releasing

Bump version in plugin.yaml in every PR, as CI requires. Nothing else is manual.

.github/workflows/release.yml runs hourly. Once the plugin.yaml version on main has no GitHub release and main has been quiet for 3 hours, it tags that commit, publishes a release with generated notes, and opens (or updates) the plugin-catalog/pstack.yaml bump PR on NousResearch/hermes-agent. Several merges in one burst produce one release for the latest. To release immediately, use Actions, Release, Run workflow, with force checked.

The catalog PR needs a CATALOG_TOKEN repository secret: a classic personal access token from Cloeille with the public_repo scope. Without it the workflow still tags and releases, and logs a warning. To preview a run, use DRY_RUN=1 bash scripts/release.sh.

License

MIT

About

Poteto's engineering rigor stack, adapted as a Hermes Agent plugin

Resources

Stars

17 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages