Uma ferramenta de CLI interativa para gerar relatórios de post-mortem de projetos.
npm install postmortem-cliUma ferramenta de CLI interativa para gerar relatórios de post-mortem de projetos.
Esta ferramenta ajuda desenvolvedores e equipes a refletir sobre projetos concluídos, pausados ou abandonados. Ao responder a uma série de perguntas guiadas, você pode gerar um arquivo Markdown estruturado que documenta os objetivos, resultados, barreiras e lições aprendidas.
O objetivo é transformar cada projeto, mesmo os que "falharam", em uma valiosa oportunidade de aprendizado.
Para usar esta ferramenta, você precisa ter o Node.js instalado. Em seguida, você pode instalá-la globalmente via npm:
``bash`
npm install -g postmortem-cli
Ou você pode clonar este repositório e executar localmente:
`bash`
git clone https://github.com/seu-usuario/postmortem-cli.git
cd postmortem-cli
npm install
node index.js
Após a instalação, basta executar o seguinte comando no seu terminal:
`bash`
postmortem
A ferramenta iniciará um prompt interativo e fará uma série de perguntas sobre o seu projeto.
1. Nome do Projeto: O nome do projeto que você está documentando.
2. Status Atual: O estado atual do projeto (ex: Concluído, Abandonado, etc.).
3. Data de Atualização: A data em que o post-mortem está sendo preenchido.
4. Período de Atividade: O período em que o projeto esteve em desenvolvimento.
5. Tecnologias Principais: As principais tecnologias usadas.
6. Objetivo do Produto: O que o projeto se propunha a resolver.
7. Objetivo de Aprendizado (PDI): O que você pessoalmente queria aprender com o projeto.
8. Status de Conclusão: Onde o desenvolvimento do projeto parou.
9. Barreiras: Perguntas sobre barreiras técnicas, pessoais e externas que o projeto enfrentou.
10. Lições Aprendidas: Hard skills e soft skills que você adquiriu.
11. Próximos Passos: Reflexões sobre o que você faria de diferente e se a ideia ainda é válida.
Após responder a todas as perguntas, a ferramenta gerará um arquivo Markdown com um nome como POSTMORTEM_NOME-DO-PROJETO.md.
Aqui está um exemplo de como o arquivo gerado se parece:
`markdownPost-Mortem do Projeto: Meu Projeto Incrível
Status: Abandonado
Data de atualização: 13/11/2025
Período de Atividade: Jan/2025 - Mar/2025
Tecnologias Principais: Node.js, React, MongoDB
---
_Nesta seção, descreva o que você se propôs a fazer. Seja claro sobre o produto que você queria construir e o objetivo de aprendizado que você tinha._
- Objetivo do Produto: Criar uma plataforma para conectar músicos locais.
- Objetivo de Aprendizado (PDI): Aprender a usar o MongoDB com Mongoose.
_Seja honesto e fatual sobre o que foi realmente concluído e qual foi o resultado._
- Status de Conclusão: Back-end 50% completo, front-end não iniciado.
- Resultado: O projeto foi abandonado.
_Esta é a seção mais importante. Faça uma reflexão honesta sobre por que o projeto foi abandonado. Tente separar as causas em categorias._
- A documentação da biblioteca de mapas era confusa.
- Síndrome do Impostor.
- Perfeccionismo.
- Falta de tempo devido a outras responsabilidades.
_Transforme o fracasso em aprendizado. Liste os ganhos tangíveis e intangíveis que você obteve durante o processo._
- Conceitos básicos de modelagem de dados no MongoDB.
- Melhor gerenciamento de escopo (aprendi a não tentar fazer tudo de uma vez).
_Com base em tudo acima, o que você fará a seguir?_
- O que eu faria diferente? Começaria com um MVP muito menor.
- A ideia vale a pena? Sim, mas talvez com uma abordagem diferente.
``
Sinta-se à vontade para abrir issues e pull requests para melhorar esta ferramenta.