O que project-butler faz?
Sistema de memória de projeto para assistentes de codificação IA (Claude Code, Cursor, Codex): registros de sessão, wiki do projeto, regras, TODOs e transferência.
Visão Geral
O project-butler mantém um contexto persistente do seu projeto entre sessões de trabalho com assistentes de codificação IA. Ele organiza informações essenciais como:
- Registros de Sessão: Logs detalhados de cada sessão de codificação, incluindo decisões e mudanças.
- Wiki do Projeto: Documentação viva que cresce com o projeto.
- Regras: Diretrizes e convenções específicas do projeto para o agente.
- TODOs: Lista de tarefas pendentes e próximos passos.
- Transferência: Instruções claras para retomar o trabalho ou passar para outro desenvolvedor/agente.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
Como Funciona
- Inicialização: O skill é instalado no repositório do projeto.
- Uso: Durante uma sessão, o assistente IA consulta e atualiza automaticamente os arquivos de memória.
- Persistência: As informações permanecem no repositório, disponíveis para futuras sessões.
Exemplo de Estrutura de Arquivos
.project-butler/
├── session-logs/
│ └── 2024-01-01-session.md
├── wiki/
│ ├── architecture.md
│ └── setup.md
├── rules.md
├── todos.md
└── handoff.md
Benefícios
- Elimina a necessidade de reexplicar o contexto do projeto.
- Mantém consistência nas decisões e implementações.
- Facilita a colaboração entre múltiplos agentes ou desenvolvedores.
- Fornece um histórico auditável do desenvolvimento.