Planning

Writing Plans

Split the spec into a file-level, step-by-step, and verifiable implementation plan.

Use it when

Multi-step feature/migration; when the intent is not clear, brainstorming should be done first.

Install command

This is the command stored in the directory. Read the source, then run it on work you can undo.

npx skills add obra/superpowers --skill writing-plans

Source

Inspect it before you install it

Treat the skill like a dependency. The directory entry is a shortlist, and the source is the thing you are about to run.

  • Read the instructions and any scripts before you grant tools, files, or credentials.
  • Test it on reversible work. Keep deploy, send, publish, and payment steps for a person.
  • Keep it when the output is easier to review. Remove it when it only adds steps.

Keep going