Skip to main content
command CX Codex

plan · othmanadi, hermes — Claude Code command: what it does, how to install

Loads the planning-with-files skill and starts planning in the current project. Handy when you want to begin a new plan or continue an existing one.

MIT ★ 28,179 updated 2026-10-24

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files
Open on GitHub

What plan does

The plan command starts the planning-with-files workflow in whatever project you are working in. It pulls in the planning-with-files skill first and hands control to it.

The agent finds the real project root for the task, calls planning_with_files_init with cwd pointing at that root, then reads task_plan.md, findings.md and progress.md from the same folder. After that it either starts a fresh plan or picks up the one already there.

The root matters. If the agent picks the wrong folder, initialization and file reads happen in that folder. In Codex the command file is ~/.codex/prompts/plan.md.

What it helps with

  • start a plan for a new task in a project
  • resume an earlier plan from progress.md
  • load task_plan.md and findings.md into the agent's context
  • tie plan initialization to the project root instead of a subfolder
  • launch the planning-with-files skill with one command

Example prompts for the agent

  • /planning-with-files:plan
  • Run /planning-with-files:plan and continue the plan for the current task
  • Start planning-with-files in this project and read task_plan.md first

How to install plan

1Plugin marketplace

/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files

2Manually: put the files in place

.claude/commands/planning-with-files-plan.md

The built-in /plan overrides a file with the same name, so the file is renamed. Call it with /planning-with-files-plan. For all projects use ~/.claude/commands/

Questions about plan

How do I install plan in Claude Code?

Add the marketplace with /plugin marketplace add OthmanAdi/planning-with-files, then run /plugin install planning-with-files@planning-with-files.

What does the plan command do?

It loads the planning-with-files skill, finds the project root and runs planning_with_files_init with cwd set to it. The agent then reads the plan files and starts or continues the work.

Which files does plan read, and from where?

task_plan.md, findings.md and progress.md. The agent reads them from the same directory it passed to planning_with_files_init as cwd.

Source text

plan.md · MIT
---
description: "Start Hermes planning-with-files workflow in the current project."
---

Load the `planning-with-files` skill and follow it.

1. Determine the actual project root for the current task.
2. Run `planning_with_files_init` with `cwd` set to that project root.
3. Read `task_plan.md`, `findings.md`, and `progress.md` from that same directory.
4. Begin or continue the planning workflow.

© OthmanAdi · MIT · OthmanAdi/planning-with-files

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

plan by other authors comes first.

plan OthmanAdi Starts Manus-style file-based planning for complex engineering workflows. Generates task_plan.md, findings.md, and progress.md or restores an active session. CX Codex +1 ★ 28,179repo stars plan Affaan Mustafa Command invokes a planner sub-agent that breaks down the task into phases, assesses risks, and waits for confirmation before touching any code. CX Codex +1 ★ 6,739repo stars plan disler Turns a task description into a step-by-step implementation plan saved under specs/. Useful when a feature needs thinking through before any code. CX Codex +1 ★ 3,990repo stars plan CloudAI-X Creates and maintains a structured PLAN.md file in your project root to track phases, task dependencies, and progress logs. CX Codex +1 ★ 1,424repo stars plan OthmanAdi Creates task_plan.md, findings.md and progress.md in the project root, so the goal, research and session log sit next to the code. CX Codex +1 ★ 540repo stars build disler build reads a plan file, applies it to your codebase and prints the report section from that plan. Useful once the plan is written and only the implementation is left. CX Codex +1 ★ 3,990repo stars ce-plan EveryInc ce-plan builds structured technical implementation plans without touching production code. Useful when scoping features before passing work to execution agents. CX Codex +1 4,000installs ralph-plan mastra-ai ralph-plan — an interactive planning skill for Claude Code and coding agents. It helps build structured ralph-loop commands through guided dialog and codebase exploration. CX Codex +1 2,600installs speckit-plan github-spec-kit speckit-plan executes implementation planning workflows inside spec-kit projects to produce research notes and interface contracts. CX Codex +1 2,600installs alan-plan tryalan-ai alan-plan walks the agent through planning: analyze the task, ask clarifying questions, draft the plan and persist it as an Alan artifact. CX Codex +1 1,800installs re0-plan LilMGenius The re0-plan Claude Code skill creates a paperthin iteration folder and seeds it with planning files. It runs on request when a new build cycle starts in the repository. CX Codex +1 1,400installs

From the same set14

The whole set →
planning-with-files planning-with-files keeps a task plan, findings and progress in project Markdown files. It suits agent work that needs 5+ tool calls. CX Codex +1 49,300installs plan Starts Manus-style file-based planning for complex engineering workflows. Generates task_plan.md, findings.md, and progress.md or restores an active session. CX Codex +1 ★ 28,179repo stars pwf pwf is a Claude Code command that plans tasks through three project files. The agent invokes it for a request to map out work. CX Codex +1 ★ 28,179repo stars pwf The pwf command sets up the planning-with-files workflow, generating a task plan, findings log and progress file for the current project. CX Codex +1 ★ 28,179repo stars status Displays current task phases, completion percentage, and errors from task_plan.md. Runs when you need a quick status check without loading companion files into context. CX Codex +1 ★ 28,179repo stars plan-doctor The plan-doctor command for Claude Code checks planning-with-files plan lookup, injection, and attestation. Run it when hooks go silent or on a new machine. CX Codex +1 ★ 28,179repo stars plan-goal plan-goal builds a completion condition out of task_plan.md and feeds it to /goal, so the agent keeps moving through the whole plan. CX Codex +1 ★ 28,179repo stars plan-attest plan-attest locks the active task_plan.md file using a SHA-256 hash. Built-in hooks prevent plan injection into model prompts whenever the file content diverges from the attested hash. CX Codex +1 ★ 28,179repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open