Planning with Files
OthmanAdi/planning-with-filesRevisado por IA
Verificado pelo RepoPicks Radar em
O que é Planning with Files?
Planning with Files é uma skill que você adiciona a um assistente de IA para código. Ela mantém o plano do trabalho atual em três arquivos de texto simples dentro do seu projeto (task_plan.md, findings.md, progress.md) e os devolve ao assistente no início de cada turno, para que o trabalho continue depois de um /clear, uma falha ou uma redefinição de contexto. Também pode impedir que o assistente declare o trabalho concluído antes que o plano diga que está. Um único comando a instala no Claude Code, Codex, Cursor, Copilot e dezenas de outros assistentes. A skill é gratuita; o assistente geralmente não é.
Quão fácil é instalar Planning with Files?
C · instalar 1 ou 2 ferramentas · Windows
- Windows C
- macOS C
- Linux C
C nos três sistemas: você já precisa ter um assistente de IA para código instalado, e então rodar um único comando, `npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g`, que precisa do Node.js. As peças que fazem o trabalho são scripts de shell (a linguagem principal do repositório é Shell, e o portão de conclusão é o `check-complete.sh`, que compara com `grep -F`), então no Windows elas esperam um ambiente Bash; o caminho do Qoder é documentado como precisando de "Bash and Python 3.10+".
Planning with Files no GitHub
- Estrelas
- 27.989em 10 de nov. de 2026
- Downloads
- —todas as versões
- Crescimento
- +105estrelas em 6 dias
Estrelas ao longo do tempo
Fatos
- Roda em
- Windows, macOS, Linux
- Você precisa instalar
- Node.js, Outras ferramentas
- Espaço em disco
- não determinado
- Contas ou chaves
- Nenhuma
- Custo
- Grátis, a API é paga · A skill é gratuita sob a licença MIT. Ela só faz algo dentro de um assistente de IA para código, como Claude Code, Codex ou Cursor, e esses geralmente precisam de um plano pago ou de uso pago de API.
- Licença
- MIT (Permissiva)
- Pode substituir
- Manus
- Última mudança no GitHub
- 10 de nov. de 2026
Sinais de risco de Planning with Files (7)
- Atençãoinstala scripts que rodam por conta própria em cada sessão
A instalação rápida é `npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g`, uma instalação global direto do repositório do GitHub, e o projeto se descreve como "Not a prompt it might follow. A hook that fires every turn". O repositório tem uma pasta `hooks/` e outra `scripts/`, além de pastas de plugin para 17 assistentes, então depois de um único comando esses scripts passam a rodar automaticamente dentro das sessões do seu assistente, com os seus arquivos.
revisão por IA
- Infoos números do benchmark são dos próprios autores
Os selos "benchmark-96.7% pass (29/30)" e "blind A/B 3/3 wins", a afirmação de que o plano "turned a 13.3-turn re-orientation into 5.0 turns" e "One hook fire measures 289ms wall-clock" vêm todos do próprio docs/evals.md do projeto. O próprio README aponta para "numbers and limits", e nenhum teste independente é citado.
revisão por IA
- Infoo readme promove um patrocinador pago para conectar ao seu agente
Um bloco de Sponsor perto do topo anuncia "Scrape.ly by evomi" com links de rastreamento (scrape.ly/?utm_source=github&utm_medium=readme&utm_campaign=planning-with-files) e convida você a "Connect the Scrape.ly MCP server to Claude Code, Cursor or any MCP client". Há também um bloco de "OSS code review support" para o CodeRabbit. Essa recomendação está no mesmo README que os passos de instalação.
revisão por IA
- Infoos arquivos do plano são descartados por design
FAQ: "They are working memory, not a tracked deliverable. `task_plan.md`, `findings.md`, `progress.md`, and the `.planning/` directory are gitignored by default and are not archived automatically: the next task overwrites the root plan." As notas que você quer manter precisam ser movidas à mão para outro lugar, ou arquivadas com `set-active-plan.sh --archive <slug> --yes`.
revisão por IA
- Infoo que você recebe depende do seu assistente
O README diz "Commands and model-callable tools depend on the host; Qoder CLI loads the skill and lifecycle hooks without the Claude-specific command prompts", lista 13 hosts com plugins nativos e chega aos seus números de "60+" e "70+ others" através do padrão de arquivo Agent Skills, com "the `npx skills` installer alone targets 71 agents". Só algumas dessas integrações são testadas.
revisão por IA
- Inforitmo de lançamentos muito rápido
Criado em 2026-01-03, o repositório já tem 127 releases, o mais recente v3.28.1 de 2026-11-07 (um dia antes desta checagem), e o README documenta mudanças de comportamento em v3.6.0, v3.7.0, v3.10.0, v3.11.0 e v2.36.0. Com 27953 estrelas e 17 issues abertas o projeto está bem movimentado, mas uma skill que se reinstala globalmente muda com frequência.
revisão por IA
- Infoo site do projeto está num endereço gerado
O campo de homepage do repositório é https://gilded-laurel-c7nj.here.now/, um subdomínio de hospedagem com cara de gerado automaticamente em vez de um nome próprio do projeto, enquanto as contagens de instalação são mostradas por serviços externos de selo (skills.sh, skillsplayground.com, skill-history.com).
revisão por IA
As evidências aparecem no idioma original.
O que o Radar não conseguiu verificar em Planning with Files
- Se o plano realmente sobrevive ao /clear e à compactação no seu assistente, já que cada host integra de um jeito diferente
- Se os hooks deixam suas sessões mais lentas na prática, já que o número de 289ms é uma medição dos próprios autores
- O que a instalação global grava na sua pasta pessoal e quais arquivos de hook cada assistente acaba executando
- Se os mais de 60 agentes compatíveis se comportam todos como descrito, algo que o próprio README qualifica
- Quanto o texto extra injetado em cada turno acrescenta ao custo de um assistente pago