{
  "id": "writing-plans",
  "handle": "writing-plans",
  "canonicalUrl": "https://bestskillsforclaude.com/en/skills/writing-plans",
  "language": "en",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/writing-plans",
    "es": "https://bestskillsforclaude.com/es/skills/writing-plans",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/writing-plans",
    "ja": "https://bestskillsforclaude.com/ja/skills/writing-plans"
  },
  "category": {
    "id": "planning-and-teamwork",
    "name": "Planning and teamwork"
  },
  "publisher": {
    "name": "Jesse Vincent (obra)",
    "url": "https://github.com/obra"
  },
  "source": "https://github.com/obra/superpowers",
  "documentation": null,
  "licenseAsStated": "MIT",
  "runtime": "Claude Code and other supported coding agents",
  "lastReviewed": "2026-08-05",
  "headline": "Why write a plan when the agent could just start?",
  "summary": "Because the plan is the only part of the work that survives a lost context.",
  "verdict": "The writing-plans skill produces detailed task breakdowns before implementation, so the work has a checkable structure rather than living inside one conversation. It is the single most useful planning skill for long tasks, because a written plan is what lets a new session, or a different agent, continue without starting over.",
  "bestFor": "Multi step work, anything spanning sessions, and tasks you might hand to someone else.",
  "skipIf": "The change is small enough to finish in one sitting and describe in one sentence.",
  "keyTakeaways": [
    "A plan is the recovery mechanism when context is lost, which happens constantly on long work.",
    "Steps without a definition of done are wishes, not steps.",
    "Reviewing a plan is far cheaper than reviewing a finished implementation.",
    "It is the natural bridge between brainstorming and subagent driven development."
  ],
  "quickStart": [
    "Install superpowers from obra/superpowers, published under MIT.",
    "Insist that each step names a file or a component and a way to tell that it is done.",
    "Keep the plan in the repository, so it is reviewable and survives the session."
  ],
  "sections": [
    {
      "heading": "What it changes in practice",
      "paragraphs": [
        "Long agent tasks fail in a specific way: the conversation grows, earlier decisions fall out of context, and the agent starts contradicting work it did an hour ago. A plan on disk is immune to that, because it is re-read rather than remembered.",
        "It also makes disagreement cheap. Arguing about a plan takes minutes, while arguing about a finished implementation costs whatever it took to build."
      ]
    },
    {
      "heading": "Where it disappoints",
      "paragraphs": [
        "Plans go stale. A plan that no longer matches the code is worse than none, because it is trusted, so update it when reality diverges.",
        "Over planning is real too. Small work does not need a document, and producing one is procedure for its own sake."
      ]
    }
  ],
  "faq": [
    {
      "question": "Where should the plan live?",
      "answer": "In the repository, so it can be reviewed, versioned and re-read by another session or another agent."
    },
    {
      "question": "What makes a step good?",
      "answer": "A named target and a way to tell it is finished. Without that, progress cannot be checked."
    },
    {
      "question": "When is planning too much?",
      "answer": "When the task fits in one sitting and one sentence. Then the plan is ceremony."
    }
  ],
  "sources": [
    {
      "label": "obra/superpowers on GitHub",
      "url": "https://github.com/obra/superpowers",
      "kind": "repository"
    },
    {
      "label": "Agent skills directory listing",
      "url": "https://skills.sh",
      "kind": "directory"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/en/skills/writing-plans/content.md",
    "json": "https://bestskillsforclaude.com/en/skills/writing-plans/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}