Skip to content

Instantly share code, notes, and snippets.

@bopbi
Last active July 30, 2026 11:50
Show Gist options
  • Select an option

  • Save bopbi/0f7a840344c1dde13225e50ee20209be to your computer and use it in GitHub Desktop.

Select an option

Save bopbi/0f7a840344c1dde13225e50ee20209be to your computer and use it in GitHub Desktop.
custom slash command so you never paste that again. Create .claude/commands/plan.md in your repo (or ~/.claude/commands/plan.md to have it in every project):
description Investigate a task and write a self-contained PLAN.md
model fable

Investigate the following task and write an implementation plan to PLAN.md at the repo root. Do not modify any other files.

Task: $ARGUMENTS

The plan will be executed by a separate Claude Code session with no memory of this conversation, so PLAN.md must be fully self-contained:

  • Context: what the task is and why, in 2-3 sentences
  • Relevant files: every file to be created or modified, with full paths
  • Current behavior: how the affected code works now (reference specific functions/classes you found while investigating)
  • Implementation steps: numbered, ordered steps. Each step names the file, describes the exact change, and includes code snippets where the change is non-obvious
  • Constraints: things the executor must NOT do (APIs to avoid, patterns to preserve, files to leave untouched)
  • Verification: how to confirm each step works (commands to run, expected output)

Assume the executor is competent but will not re-investigate. Anything you discovered that matters must be written down.

@bopbi

bopbi commented Jul 30, 2026

Copy link
Copy Markdown
Author

run with using /plan

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment