{
  "id": "writing-plans",
  "handle": "writing-plans",
  "canonicalUrl": "https://bestskillsforclaude.com/pt-br/skills/writing-plans",
  "language": "pt-BR",
  "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": "Planejamento e trabalho em equipe"
  },
  "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": "Por que escrever um plano se o agente já poderia começar?",
  "summary": "Porque o plano é a única parte do trabalho que sobrevive a um contexto perdido.",
  "verdict": "A skill writing-plans produz decomposições detalhadas antes da implementação, para o trabalho ter estrutura verificável em vez de morar dentro de uma conversa. É a skill de planejamento mais útil em tarefas longas, porque um plano escrito é o que permite outra sessão, ou outro agente, continuar sem recomeçar.",
  "bestFor": "Trabalho de várias etapas, tarefas que atravessam sessões e coisas que você pode delegar.",
  "skipIf": "A mudança cabe em uma sessão e é descrita em uma frase.",
  "keyTakeaways": [
    "Um plano é o mecanismo de recuperação quando o contexto se perde, o que em trabalho longo acontece o tempo todo.",
    "Passos sem definição de pronto são desejos, não passos.",
    "Revisar um plano é muito mais barato que revisar implementação terminada.",
    "É a ponte natural entre brainstorming e desenvolvimento com subagentes."
  ],
  "quickStart": [
    "Instale o superpowers a partir de obra/superpowers, sob licença MIT.",
    "Exija que cada passo nomeie um arquivo ou componente e um jeito de saber que terminou.",
    "Guarde o plano no repositório, para ser revisável e sobreviver à sessão."
  ],
  "sections": [
    {
      "heading": "O que muda na prática",
      "paragraphs": [
        "Tarefas longas com agente falham de um jeito específico: a conversa cresce, decisões antigas saem do contexto e o agente começa a contradizer o que fez uma hora atrás. Um plano em disco é imune, porque é relido em vez de lembrado.",
        "Ele também barateia a discordância. Discutir um plano leva minutos, discutir uma implementação pronta custa o que ela custou para ser feita."
      ]
    },
    {
      "heading": "Onde decepciona",
      "paragraphs": [
        "Planos envelhecem. Um plano que não bate mais com o código é pior que nenhum, porque nele se confia, então atualize quando a realidade divergir.",
        "Excesso de planejamento também existe. Trabalho pequeno não precisa de documento, e produzir um é procedimento por procedimento."
      ]
    }
  ],
  "faq": [
    {
      "question": "Onde o plano deve ficar?",
      "answer": "No repositório, para poder ser revisado, versionado e relido por outra sessão ou outro agente."
    },
    {
      "question": "O que faz um passo ser bom?",
      "answer": "Um alvo nomeado e um jeito de saber que terminou. Sem isso não dá para conferir o progresso."
    },
    {
      "question": "Quando planejar é demais?",
      "answer": "Quando a tarefa cabe em uma sessão e em uma frase. Aí o plano é cerimônia."
    }
  ],
  "sources": [
    {
      "label": "obra/superpowers no GitHub",
      "url": "https://github.com/obra/superpowers",
      "kind": "repository"
    },
    {
      "label": "Diretório de agent skills",
      "url": "https://skills.sh",
      "kind": "directory"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/pt-br/skills/writing-plans/content.md",
    "json": "https://bestskillsforclaude.com/pt-br/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."
}