Post-Mortem CLI

Uma ferramenta de CLI interativa para gerar relatórios de post-mortem de projetos.

Visão Geral

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.

Instalação

Para usar esta ferramenta, você precisa ter o Node.js instalado. Em seguida, você pode instalá-la globalmente via npm:

npm install -g postmortem-cli

Ou você pode clonar este repositório e executar localmente:

git clone https://github.com/seu-usuario/postmortem-cli.git
cd postmortem-cli
npm install
node index.js

Como Usar

Após a instalação, basta executar o seguinte comando no seu terminal:

postmortem

A ferramenta iniciará um prompt interativo e fará uma série de perguntas sobre o seu projeto.

Perguntas

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.

Exemplo de Saída

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:

# Post-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

---

## 1. Objetivo inicial

_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.

## 2. Resultado

_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.

## 3. Análise da Falha

_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._

### Barreiras Técnicas

- A documentação da biblioteca de mapas era confusa.

### Barreiras pessoais

- Síndrome do Impostor.
- Perfeccionismo.

### Barreiras externas

- Falta de tempo devido a outras responsabilidades.

## 4. Lições Aprendidas (O "Produto Real")

_Transforme o fracasso em aprendizado. Liste os ganhos tangíveis e intangíveis que você obteve durante o processo._

### Hard Skills Adquiridas

- Conceitos básicos de modelagem de dados no MongoDB.

### Soft Skills Desenvolvidas

- Melhor gerenciamento de escopo (aprendi a não tentar fazer tudo de uma vez).

## 5. Próximos Passos (Refinamento)

_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.

Contribuição

Sinta-se à vontade para abrir issues e pull requests para melhorar esta ferramenta.