plan

Generate timestamped Markdown implementation plans without modifying repository files.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill plan-afel6
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/software-development/plan
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill plan-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a safe, planning-only workflow for autonomous agents and engineers who need a concrete, reviewable plan before any code changes or executions are performed.

Core Features & Use Cases

  • Non-mutating planning: Inspects repository context in read-only mode and produces a Markdown plan without modifying files or running commands.
  • Workspace-native output: Saves timestamped, human-readable plans under .hermes/plans for review, handoff, and audit.
  • Use Case: When asked to implement a feature or fix, produce a step-by-step plan listing goals, assumptions, affected files, tests, and risks so a developer or sub-agent can execute later.

Quick Start

Write a timestamped markdown plan for the requested task and save it to .hermes/plans/YYYY-MM-DD_HHMMSS-<slug>.md.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I generate a development plan without modifying repository files?▼

A non-mutating development plan is generated by inspecting repository context read-only and saving a Markdown plan without modifying files. This creates a reviewable document of goals and implementation strategies for handoff or staging before execution.

What is a read-only planning workflow for autonomous agents?▼

A read-only planning workflow is a process where an agent inspects repository context without making code changes, producing a saved plan for handoff or audit. It ensures safe, reviewable documentation of implementation strategies before any execution occurs.

Can I create a step-by-step implementation plan for a feature without writing code?▼

Yes, you can create a step-by-step implementation plan without writing code by listing goals, assumptions, affected files, tests, and risks in a Markdown file. This provides a developer or sub-agent with a concrete strategy to execute later.

How do I save a timestamped plan for an engineering review?▼

To save a timestamped plan for an engineering review, write the Markdown plan to a file formatted as .hermes/plans/YYYY-MM-DD_HHMMSS-<slug>.md. This workspace-native output ensures plans are organized and traceable for audit purposes.

Does this planning workflow support identifying files to change before execution?▼

Yes, this planning workflow supports optional repository inspection to identify likely files to change before execution. It examines the repository context in read-only mode to determine which files will be affected by the proposed implementation strategy.

What are the limitations of plan-mode documentation for software development?▼

The limitation of plan-mode documentation is that it strictly adheres to non-mutating constraints, meaning it cannot perform code changes or run commands. It only produces a saved plan for staging and handoff, requiring a separate execution step afterward.