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.