plan

Writes actionable markdown implementation plans to .hermes/plans/ without executing code.

1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/Araara7/hermes-skills --skill plan-araara7
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/Araara7/hermes-skills/tree/main/software-development/plan
Command: npx skills add https://github.com/Araara7/hermes-skills --skill plan-araara7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you need a concrete, reviewable implementation plan before any code changes happen, this Skill enforces a strict planning-only mode that produces a structured markdown plan saved to your workspace. ## Core Features & Use Cases - Plan-Only Mode: Prevents code edits, mutating commands, commits, and external actions while allowing read-only inspection of the repository. - Structured Plan Output: Generates plans covering goal, context, approach, step-by-step tasks, files to change, tests, risks, and open questions. - Workspace-Aware Saving: Stores plans under .hermes/plans/ with timestamped filenames, working across local, docker, ssh, modal, and daytona backends. - Use Case: Before refactoring an authentication module, invoke plan mode to get a written plan listing exact file paths, test targets, and verification steps, then review it before any implementation begins. ## Quick Start Ask the agent to plan the implementation of your feature and save the plan to .hermes/plans/ without making any code changes.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I get an implementation plan without code changes?▼

Invoke plan mode with your task description, and the agent writes a markdown plan covering goal, approach, steps, files to change, and tests. It saves the plan under .hermes/plans/ and performs no code edits or mutating commands.

Where are plan files saved in the workspace?▼

Plans are saved under .hermes/plans/ with a timestamped filename like YYYY-MM-DD_HHMMSS-slug.md, relative to the active working directory. If the runtime provides a specific target path, that exact path is used instead.

Can the agent inspect my repository while in plan mode?▼

Yes, read-only inspection of the repository and other context is allowed during planning. However, editing project files, running mutating terminal commands, committing, pushing, or performing external actions is prohibited.

What should a good implementation plan include?▼

A plan should include the goal, current context and assumptions, proposed approach, step-by-step tasks, files likely to change, tests and validation steps, plus risks and open questions. Code-related plans should list exact file paths and test targets.

When should I use plan mode instead of direct implementation?▼

Use plan mode when a task is complex, touches many files, or needs stakeholder review before execution. It is less useful for trivial one-line fixes where planning overhead exceeds the implementation effort.