Planning With Files

Planejamento com Arquivos

Trabalhe como Manus: Use arquivos markdown persistentes como sua "memória de trabalho no disco".

Início Rápido

Antes de QUALQUER tarefa complexa:

1. Crie task_plan.md no diretório de trabalho
2. Defina fases com checkboxes
3. Atualize após cada fase - marque [x] e mude o status
4. Leia antes de decidir - refresque os objetivos na janela de atenção

O Padrão de 3 Arquivos

Para toda tarefa não trivial, crie TRÊS arquivos:

Workflow Principal

Loop 1: Criar task_plan.md com objetivo e fases
Loop 2: Pesquisar → salvar em notes.md → atualizar task_plan.md
Loop 3: Ler notes.md → criar deliverable → atualizar task_plan.md
Loop 4: Entregar saída final

O Loop em Detalhes

Antes de cada ação principal:

Read task_plan.md  # Refresque os objetivos na janela de atenção

Após cada fase:

Edit task_plan.md  # Marque [x], atualize o status

Ao armazenar informações:

Write notes.md     # Não abarrote contexto, armazene em arquivo

Modelo task_plan.md

Crie este arquivo PRIMEIRO para qualquer tarefa complexa:

# Plano de Tarefa: [Descrição Breve]

## Objetivo
[Uma frase descrevendo o estado final]

## Fases
- [ ] Fase 1: Planejamento e configuração
- [ ] Fase 2: Pesquisa/coleta de informações
- [ ] Fase 3: Execução/construção
- [ ] Fase 4: Revisão e entrega

## Perguntas-Chave
1. [Pergunta a responder]
2. [Pergunta a responder]

## Decisões Tomadas
- [Decisão]: [Fundamentação]

## Erros Encontrados
- [Erro]: [Resolução]

## Status
**Atualmente na Fase X** - [O que estou fazendo agora]

Modelo notes.md

Para pesquisa e descobertas:

# Notas: [Tópico]

## Fontes

### Fonte 1: [Nome]
- URL: [link]
- Pontos-chave:
  - [Descoberta]
  - [Descoberta]

## Descobertas Sintetizadas

### [Categoria]
- [Descoberta]
- [Descoberta]

Regras Críticas

1. SEMPRE Crie o Plano Primeiro

Nunca inicie uma tarefa complexa sem task_plan.md. Isto é inegociável.

2. Leia Antes de Decidir

Antes de qualquer decisão importante, leia o arquivo de plano. Isto mantém os objetivos em sua janela de atenção.

3. Atualize Após Agir

Após completar qualquer fase, atualize imediatamente o arquivo de plano:

• Marque fases concluídas com [x]
• Atualize a seção Status
• Registre todos os erros encontrados

4. Armazene, Não Abarrote

Saídas grandes vão para arquivos, não contexto. Mantenha apenas paths na memória de trabalho.

5. Registre Todos os Erros

Todo erro vai na seção "Erros Encontrados". Isto constrói conhecimento para tarefas futuras.

Quando Usar Este Padrão

Use o padrão de 3 arquivos para:

• Tarefas com múltiplas etapas (3+ etapas)
• Tarefas de pesquisa
• Construir/criar algo
• Tarefas que abrangem múltiplas chamadas de ferramenta
• Qualquer coisa que exija organização

Pule para:

• Perguntas simples
• Edições de arquivo único
• Buscas rápidas

Anti-Padrões a Evitar

Padrões Avançados

Veja reference.md para:

• Técnicas de manipulação de atenção
• Padrões de recuperação de erro
• Otimização de contexto do Manus

Veja examples.md para:

• Exemplos de tarefas reais
• Padrões de workflow complexo