Planning with Files: resolvendo o problema de contexto de agentes de IA no estilo Manus

• Levantamento do problema

  • Devido à limitação da janela de contexto de agentes de IA (Claude Code, Cursor etc.), eles perdem o objetivo em trabalhos de longa duração
  • Esquecem as instruções iniciais + repetem os mesmos erros (contexto = RAM volátil)
  • É possível resolver isso usando o sistema de arquivos como memória permanente (disco)

• O segredo do sucesso da Manus (engenharia reversa)

  • Em 8 meses, receita de 100 milhões de dólares → aquisição pela Meta por 2 bilhões de dólares
  • Núcleo: usar arquivos Markdown como o cérebro externo da IA
  • Manipulação de atenção + manutenção do registro de erros → evita repetir falhas
  • A capacidade de recuperar-se de erros é o principal indicador de desempenho de um agente

• Padrão de 3 arquivos (o núcleo de Planning with Files)

  • task_plan.md
    → plano passo a passo + gerenciamento do andamento com checkboxes
    → o arquivo mais importante para lembrar constantemente o objetivo
  • findings.md
    → armazena resultados de pesquisa, informações descobertas e conteúdo de análise
  • progress.md
    → registra o que foi realmente tentado + resultados + todos os erros

• 4 regras principais de uso

  • Comece sempre escrevendo o plano em task_plan.md
  • Se consultar o mesmo tema 2 vezes ou mais → organize e salve em findings.md
  • Todos os erros ocorridos devem ser registrados em progress.md
  • Não repetir a mesma falha da mesma forma → mudar a abordagem e tentar novamente

• Como aplicar na prática

  • Instalar o plugin no Claude Code: /plugin marketplace add OthmanAdi/planning-with-files
  • Executar automática ou manualmente em tarefas complexas (mais de 3 etapas, quando exigirem pesquisa ou refatoração) (/planning-with-files)
  • Efeito: a IA não esquece o objetivo e a repetição de erros diminui de forma significativa

• Insight central & conclusão

  • Melhorar o desempenho de agentes de IA → uma gestão de memória eficaz é muito mais importante do que um modelo maior
  • Mesmo com apenas 3 arquivos Markdown, o nível de engenharia de contexto sobe bastante
  • O plugin Planning with Files → implementação open source do método Manus → qualquer pessoa pode usar imediatamente

[zero0000]

task_plan.md é igual ao método que eu estava usando atualmente. Seria muito conveniente se isso fosse feito automaticamente.