Pular pro conteúdo

Planning With Files skill

O Claude trabalha com um plano em arquivo que sobrevive à compactação e às sessões novas, com a fase atual, os erros e o próximo passo sempre anotados.

por othmanadi

instalações
47 mil
estrelas no GitHub
27,6 mil
No skills.sh desde
janeiro de 2026
Licença
MIT

Atualizada no GitHub em 24 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

Trata a janela de contexto como memória RAM e o disco como memória permanente. Antes de uma tarefa longa, cria três arquivos: task_plan.md com fases e status, findings.md com o que foi descoberto e progress.md com o diário da sessão. A cada duas buscas ou páginas lidas, anota o que achou.

Relê o plano antes de decidir, marca cada fase concluída e anota todo erro numa tabela pra não repetir a mesma tentativa. Depois de três falhas no mesmo problema, para e pergunta. Ganchos do Claude Code colocam o plano no contexto, e ao voltar a uma tarefa ele lê os arquivos antes de continuar.

Aceita planos com nome em .planning/, um por tarefa, pra rodar vários agentes em paralelo. Tem modo autônomo e modo com trava, que segura o agente enquanto houver fase em andamento, com limite pra não virar loop. Traz scripts pra iniciar, validar e conferir o fim, e uma marca SHA-256 que detecta plano alterado.

Nas palavras de quem fez

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project…

othmanadi, no SKILL.md

Quando usar

  • Pesquisa ou construção que vai levar dezenas de passos
  • Tarefa que precisa continuar amanhã de onde parou
  • Rodar dois agentes em tarefas diferentes no mesmo projeto
  • Deixar o Claude trabalhando até todas as fases terminarem
  • Quando o Claude esquece o objetivo depois de compactar a conversa

Depois de instalar, é só pedir assim

  • Usa o planning-with-files pra migrar meu site de WordPress pra Next.js, com as fases no task_plan.md
  • Pesquisa os 10 maiores concorrentes do meu nicho e vai salvando tudo no findings.md
  • Retoma a tarefa de ontem pelo task_plan.md e me diz a fase atual e o próximo passo

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a Planning With Files no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Planning With Files, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que precisa ter instalado?

Os scripts são em shell e PowerShell, e a leitura de sessões antigas, que só roda se você pedir, usa Python. Não pede chave nem conta, e o SKILL.md diz que os scripts não enviam nada pra internet. Instalada como plugin do Claude Code, ganha também os comandos /plan-goal e /plan-loop.

Roda no Codex e no Antigravity?

Os três arquivos funcionam em qualquer agente, e o SKILL.md traz ganchos pro Codex, Cursor, Gemini CLI e OpenCode, entre outros; o Antigravity não aparece na lista. A trava que segura o agente até o fim só bloqueia de verdade no Claude Code, no Codex e no Continue; nos outros vira lembrete ou aviso.

Qual a diferença pra lista de tarefas do próprio Claude?

A lista de tarefas fica na conversa. O SKILL.md manda não usar ela pra guardar o estado e gravar tudo em task_plan.md, um arquivo no seu projeto que continua lá depois que a conversa acaba.

Levar essa skill

1x planning-with-filesR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/othmanadi/planning-with-files

Aprenda a usar

Mais da loja othmanadi

Ver a loja othmanadi