Hans11609/planning-with-files

O que planning-with-files faz?

🗂️ Transforme seu fluxo de trabalho com arquivos markdown persistentes para planejamento, acompanhamento de progresso e armazenamento de conhecimento, inspirado no sucesso do Manus.

Visão Geral

Esta habilidade permite que agentes de IA utilizem arquivos markdown como um sistema de memória externa e gerenciamento de tarefas. Ao invés de confiar apenas na conversa, você pode manter um plano, registrar o progresso e armazenar conhecimento em arquivos que persistem entre sessões.

Como Funciona

1. Planejamento Inicial: O agente cria um arquivo plano.md com uma visão geral do projeto, metas e etapas.
2. Acompanhamento de Progresso: Conforme as tarefas são concluídas, o agente atualiza progresso.md com detalhes do que foi feito e o que ainda precisa ser feito.
3. Armazenamento de Conhecimento: Informações importantes, decisões e aprendizados são registrados em conhecimento.md.

Estrutura de Arquivos

projeto/
├── plano.md
├── progresso.md
└── conhecimento.md

plano.md

# Plano do Projeto

## Meta

- Descrição da meta principal

## Etapas

1. [ ] Etapa 1: Descrição
   - [ ] Subtarefa 1.1
   - [ ] Subtarefa 1.2
2. [ ] Etapa 2: Descrição
   - [ ] Subtarefa 2.1

progresso.md

# Progresso

## Sessão Atual

- [x] Tarefa concluída 1
- [ ] Tarefa pendente 2

## Notas

- Observações sobre o andamento

conhecimento.md

# Conhecimento Adquirido

## Decisões

- Decisão 1: Motivo

## Aprendizados

- Lição aprendida 1

Uso com Agentes de IA

• Claude Code: O agente pode ler e escrever nos arquivos usando comandos de terminal (cat, echo, nano).
• Cursor: Similar, com suporte a edição direta de arquivos.
• Codex: Pode ser instruído a manter os arquivos atualizados.

Benefícios

• Persistência: Informações não se perdem entre sessões.
• Transparência: Usuários podem visualizar e editar os arquivos manualmente.
• Organização: Estrutura clara para projetos complexos.

Configuração

1. Crie um diretório para o projeto.
2. Solicite ao agente que inicialize os arquivos markdown.
3. Comece a planejar e executar tarefas.

Exemplo de Comando

# Inicializar o plano
echo "# Plano do Projeto\n\n## Meta\n\n- Concluir o aplicativo web" > plano.md

Contribuição

Sinta-se à vontade para adaptar a estrutura conforme suas necessidades. Pull requests são bem-vindos!