Planejamento com Arquivos

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

Importante: Onde os Arquivos Vão

Ao usar esta habilidade:

• Templates são armazenados no diretório da habilidade em ${CLAUDE_PLUGIN_ROOT}/templates/
• Seus arquivos de planejamento (task_plan.md, findings.md, progress.md) devem ser criados no seu diretório de projeto — a pasta onde você está trabalhando

Isso garante que seus arquivos de planejamento vivam ao lado do seu código, não enterrados na pasta de instalação da habilidade.

Início Rápido

Antes de QUALQUER tarefa complexa:

1. Crie task_plan.md no seu projeto — Use templates/task_plan.md como referência
2. Crie findings.md no seu projeto — Use templates/findings.md como referência
3. Crie progress.md no seu projeto — Use templates/progress.md como referência
4. Releia o plano antes das decisões — Atualiza os objetivos na janela de atenção
5. Atualize após cada fase — Marque como concluído, registre erros

Nota: Todos os três arquivos de planejamento devem ser criados no seu diretório de trabalho atual (a raiz do seu projeto), não na pasta de instalação da habilidade.

O Padrão Central

Context Window = RAM (volatile, limited)
Filesystem = Disk (persistent, unlimited)

→ Anything important gets written to disk.

Propósitos dos Arquivos

Regras Críticas

1. Crie o Plano Primeiro

Nunca comece uma tarefa complexa sem task_plan.md. Não negociável.

2. A Regra das 2 Ações

"Após cada 2 operações de visualização/navegação/pesquisa, SALVE IMEDIATAMENTE as descobertas importantes em arquivos de texto."

Isso evita que informações visuais/multimodais sejam perdidas.

3. Leia Antes de Decidir

Antes de decisões importantes, leia o arquivo de plano. Isso mantém os objetivos na sua janela de atenção.

4. Atualize Após Agir

Após completar qualquer fase:

• Marque o status da fase: in_progress → complete
• Registre quaisquer erros encontrados
• Anote arquivos criados/modificados

5. Registre TODOS os Erros

Todo erro vai para o arquivo de plano. Isso constrói conhecimento e evita repetição.

## Errors Encountered
| Error | Attempt | Resolution |
|-------|---------|------------|
| FileNotFoundError | 1 | Created default config |
| API timeout | 2 | Added retry logic |

6. Nunca Repita Falhas

if action_failed:
    next_action != same_action

Rastreie o que você tentou. Mude a abordagem.

O Protocolo de Erro de 3 Tentativas

ATTEMPT 1: Diagnose & Fix
  → Read error carefully
  → Identify root cause
  → Apply targeted fix

ATTEMPT 2: Alternative Approach
  → Same error? Try different method
  → Different tool? Different library?
  → NEVER repeat exact same failing action

ATTEMPT 3: Broader Rethink
  → Question assumptions
  → Search for solutions
  → Consider updating the plan

AFTER 3 FAILURES: Escalate to User
  → Explain what you tried
  → Share the specific error
  → Ask for guidance

Matriz de Decisão Ler vs Escrever

O Teste de Reinicialização de 5 Perguntas

Se você conseguir responder a estas, seu gerenciamento de contexto está sólido:

Quando Usar Este Padrão

Use para:

• Tarefas de múltiplos passos (3+ passos)
• Tarefas de pesquisa
• Construir/criar projetos
• Tarefas que abrangem muitas chamadas de ferramentas
• Qualquer coisa que exija organização

Pule para:

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

Templates

…