Skip to content

rlaope/oh-my-hermes / skills/omh-plan

omh-plan

Verified

[omh] Software feature or bugfix not yet planned: structured planning before execution. Use when the user says: plan, implementation plan, make a plan, write a plan, write the plan, task breakdown, safe feature, safely add a feature.

FileKindSize
SKILL.mdskill md14.7 KB
references/hermes-plan-mode.mdmarkdown2.4 KB
references/project-constitution.mdmarkdown3.3 KB

references/hermes-plan-mode.md

View on GitHub
# Hermes `/plan` and `plan`

Hermes ships a built-in planning command, `/plan`. This page says where its turn ends and this skill begins, so one request does not end up with two plans or two acceptance rules.

## The `/plan` turn

`/plan <task>`, or `/plan` alone to plan whatever the conversation is about, makes Hermes send a turn of its own that opens `[/plan — plan mode]`. That turn allows read-only inspection and nothing that changes the project apart from one markdown file: `.hermes/plans/<timestamp>-<slug>.md` in the workspace, or a path the runtime supplies. It closes with a short reply naming the file and an offer to carry the plan out.

In that turn, follow its instructions: write the file, reply, and stop. OMH's router does not route a turn Hermes wrote, and nothing in this skill overrides it there.

## After it: the file is the draft

When the user then asks to review, refine, accept, or hand off the plan, read that file and run this skill on it instead of writing another plan:

- Add what the file lacks among goals, non-goals, risks, acceptance criteria, and verification shape, and when it describes code changes, the `Review Focus` section, each task's id, dependencies, write scope and done check, and the closing gate task.
- Hold every step to this skill's step shape.
- Run the proportion check. `/plan` asks for complete code inside its steps, and this skill keeps code bodies out of a plan: reduce each body to the test name and what it asserts, an exact signature and its file, or a command and the output that passes. Say which steps you reduced. The file is the user's; change it only as part of the plan you put to them for acceptance.
- Take acceptance from the user's own answer, exactly as for any plan. The file existing is not acceptance, and neither is `/plan`'s offer to carry it out: nothing is handed off or started until the user accepts.
- Once the user accepts, offer the follow-on by this skill's rule, not only `/plan`'s offer to carry it out: when the tasks form a graph (ids, dependencies, write scopes and a closing verification task), name `dag-ulw` beside carrying it out directly, give the fit reason in one line, and start neither until the user picks one, unless their answer already named one.

## Two stores

The file stays where `/plan` wrote it. A reviewed plan that `ulw-plan` records goes under `.omh/plans/`; when a task has both, the closing brief names the one the user accepted.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall