🤖 Agente de Backlog Dev — Gerador de JSON & Cronograma Excel

Script Python que lê documentos de requisitos (.docx, .pdf, .txt), extrai automaticamente as atividades técnicas do desenvolvedor com testes básicos de validação, e gera uma planilha Excel de acompanhamento (.xlsx) completa com 5 abas e cronograma calculado sem fins de semana nem feriados.

---

O que o sistema faz

1. agente_us.py:

   • Lê documentos de requisitos.
   • Extrai as atividades de desenvolvimento (Backend, Frontend, Banco de Dados, Integração).
   • Sugere pontuação Fibonacci e define casos de teste básicos para o desenvolvedor.
   • Salva em ./backlog_json/<nome_projeto>_backlog.json.

2. gerar_planilha.py:

   • Lê o JSON gerado e abre um questionário no terminal.
   • Pergunta data de início, data alvo, horas/dia de dedicação, pausa de homologação (ex: 2 dias úteis) e validação dos pontos Fibonacci pelo Dev.
   • Calcula o cronograma saltando finais de semana e feriados nacionais.
   • Gera a planilha Excel em ./planilhas/<nome_projeto>_acompanhamento.xlsx com 5 abas:
     • Resumo: Indicadores gerais, datas e parâmetros do projeto.
     • Backlog: Atividades técnicas, Fibonacci, horas e alocação por Sprint.
     • Testes Básicos: Checklist de testes dev com coluna de status.
     • Cronograma: Datas por Sprint (Início Dev, Fim Dev, Apresentação Cliente, Homologação e Deploy Produção).
     • Justificativas e Impedimentos: Tabela de registro de gargalos e justificativas.

---

Como usar

Passo 1: Extrair o backlog em JSON

python agente_us.py

Passo 2: Responder ao questionário e gerar a planilha Excel

python gerar_planilha.py

---

Dependências Python

anthropic      — API Anthropic (Claude)
pymupdf        — leitura de .pdf
python-dotenv  — carregamento do .env
openpyxl       — geração de planilhas Excel (.xlsx)
holidays       — cálculo de feriados nacionais