Um conjunto de skills para agentes que permite delegar tarefas de programação a CLIs de codificação instaladas, revisar o diff e fazer o commit manualmente.
2,6 mil+33 esta semana220JavaScriptMITBem mantidoAtualizado anteontem
OthmanAdi/planning-with-files
Skill de planejamento baseado em arquivos para agentes de programação com IA, que mantém planos de tarefas em disco para sobreviver a resets de contexto, /clear e falhas.
- Estrelas
- 27,923
- Forks
- 2,313
- Issues abertas
- 11
- Último commit
- há 3 dias
O que é?
Planning with Files é uma skill para agentes de programação com IA que armazena o plano de uma tarefa, notas de pesquisa e progresso em três arquivos Markdown dentro do projeto: task_plan.md, findings.md e progress.md. Como o estado fica no disco, e não na janela de contexto, o agente pode retomar na etapa atual após /clear, compactação do contexto ou uma falha.
Hooks de ciclo de vida reinjetam o contexto do plano ativo no início de cada turno, e uma verificação de conclusão informa se todas as etapas do plano foram concluídas. Tarefas paralelas podem usar diretórios separados em .planning/, selecionados por meio de um ponteiro para o plano ativo. A recuperação automática lê apenas arquivos do projeto; para ler registros locais de sessões do agente, é necessário ativar explicitamente o modo catchup.
A skill pode ser instalada via npx skills, pelo marketplace de plugins do Claude Code ou pelo npm. Também oferece integrações nativas de plugin para Claude Code, Codex CLI, Cursor, OpenCode, Hermes Agent e outros, além de variantes traduzidas em vários idiomas.
Recursos principais
- 01Armazena o plano, as descobertas e o progresso em arquivos Markdown no projeto
- 02Reinjeta o plano ativo em cada turno por meio de hooks de ciclo de vida
- 03Recupera o plano após /clear, compactação ou falhas na sessão
- 04A verificação de conclusão informa se todas as etapas do plano foram concluídas
- 05Diretórios de plano isolados para tarefas paralelas
- 06Instala-se em diversos agentes de programação por meio do padrão Agent Skills
Casos de uso
- Refatorações ou migrações de longa duração que se estendem por várias sessões
- Tarefas de programação com várias etapas em que o agente não pode perder o fio após /clear
- Manter um registro auditável das decisões e dos resultados de testes durante o trabalho do agente
Em coleções
Tópicos
Perguntas frequentes
- O que é planning-with-files?
- Skill de planejamento baseado em arquivos para agentes de programação com IA, que mantém planos de tarefas em disco para sobreviver a resets de contexto, /clear e falhas. Planning with Files é uma skill para agentes de programação com IA que armazena o plano de uma tarefa, notas de pesquisa e progresso em três arquivos Markdown dentro do projeto: task_plan.md, findings.md e progress.md. Como o estado fica no disco, e não na janela de contexto, o agente pode retomar na etapa atual após /clear, compactação do contexto ou uma falha.
- planning-with-files é gratuito? Qual é a licença?
- planning-with-files é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- planning-with-files ainda é mantido?
- Manutenção ativa. O último commit de planning-with-files foi em 4 de nov. de 2026.
- Para que posso usar planning-with-files?
- Refatorações ou migrações de longa duração que se estendem por várias sessões Tarefas de programação com várias etapas em que o agente não pode perder o fio após /clear Manter um registro auditável das decisões e dos resultados de testes durante o trabalho do agente
- Onde consigo planning-with-files?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/OthmanAdi/planning-with-files
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Memória persistente local-first para agentes de programação com IA: armazena decisões e aprendizados no SQLite e os disponibiliza via MCP para Claude Code, Cursor e outros clientes.
22431PythonApache-2.0Bem mantidoAtualizado há 29 dias
Skills em linguagem simples para Claude Code, Codex CLI, Cursor CLI e Gemini CLI transformam relatórios de sessão em um veredito fácil de entender, exibido em uma única tela.
1,3 mil111ShellMITAtualizado mês passado
Diretório organizado com mais de 1.000 Agent Skills de equipes oficiais de fornecedores e da comunidade, para Claude Code, Codex, Gemini CLI, Cursor e outros.
36,9 mil+299 esta semana4,1 milMITAtualizado anteontem
Um fluxo de desenvolvimento guiado por especificações para assistentes de programação com IA alinharem propostas, especificações e tarefas antes de qualquer código ser escrito.
74,2 mil+706 esta semana5,1 milTypeScriptMITAtualizado há 18 horas
Uma adaptação da stack de skills pstack Cursor, de Poteto, que oferece ao Claude Code, Codex, Copilot, Pi e outros harnesses de agentes fluxos estruturados para tarefas de programação.
4,1 mil+445 esta semana370JavaScriptMITBem mantidoAtualizado há 22 horas