Criei uma skill para manter um arquivo atualizado com o panorama do projeto
Geralmente eu pergunto para a IA como está o status do projeto ou peço para atualizar alguns arquivos (especificacao.md, plano-implementacao.md e etc) com o status atual do projeto. Pensando nisto eu criei uma skill para atualizar automaticamente o status/panorama do projeto.
Com isto eu tenho uma nova documentação e em poucos segundos consigo ter uma boa visão do projeto, o que foi feito, o que falta e etc.
Convido vocês a conhecer e testar.
Mais abaixo falo um pouco mais sobre o assunto:
O problema
- Os agentes começam cada sessão sem memória do contexto do projeto, não sabem qual o status atual, então tem de ler vários arquivos para entender a situação real ou até mesmo ficam perdidos e fazem algo errado (esta é a pior parte, quando erram feio e não tem como voltar atrás).
- O status real (o que está implementado, o que falta, quais decisões valem) nem sempre está documentado para você quando vai voltar a mexer com o projeto após alguma pausa e isto é importante quando algum projeto demora dias.
- Os arquivos de roadmap ficam desatualizados porque geralmente a gente esquece de atualizar.
A solução: um único arquivo
Esta skill gera e mantém um arquivo só — o panorama-atual.md (você pode trocar o lugar onde vai salvar, assim como o nome, só definir no agents.md) — que responde em segundos:
- Como está o projeto (fase atual + resumo)
- O que já foi feito (módulos, testes com contagem real, CI)
- O que falta fazer (roadmap com status por fase: não iniciada, parcial, concluída)
O que a skill faz
- Cria do zero: explora o código (módulos e responsabilidades), lê os documentos de plano/roadmap e cruza as fases com base no código real, não no que o plano prometia (na grande maioria das vezes o plano de implementação está informando que foi feito algo e não foi feito).
- Atualiza no mesmo commit: toda implementação, correção ou decisão relevante atualiza o arquivo junto com a mudança, ainda mais se usa uma skill ou workflow que faz isto automatico. Você adiciona uma regra no
AGENTS.mddo projeto e a disciplina fica automática — qualquer agente que trabalhar no projeto mantém o panorama em dia. - Só fatos verificados: sem números inventados. A contagem de testes vem de rodar o runner; o status das fases vem de ler o código.
Exemplo de panorama-atual.md gerado pela skill:
# Panorama Atual — App de Pedidos
**Última atualização:** 10/08/2026
## Decisões vigentes
- Backend em Node.js/Express; sem ORM por enquanto.
## Fase atual
**Fase 2 — Checkout** — carrinho, cálculo de frete e integração com gateway de pagamento.
Próxima fase: **Fase 3 — Rastreamento** (status do pedido e notificações).
## Implementado
| Módulo | Responsabilidade |
|---|---|
| `server.js` | Bootstrap do Express e rotas |
| `pedidoService.js` | Regras de negócio de pedidos |
**42 testes verdes** em 3 arquivos.
## Pendente (roadmap)
| Fase | Status | Observação |
|---|---|---|
| **Fase 1 — Catálogo** | Concluída | — |
| **Fase 2 — Checkout** | Parcial | Falta integração com gateway |
| **Fase 3 — Rastreamento** | Não iniciada | — |
Como usar
A skill é compatível com qualquer agente que aceite skills ou arquivos de instrução: Claude Code, OpenCode, Cursor, Codex CLI e outros.
- Claude Code: copie a pasta para
~/.claude/skills/e peça "gere o panorama do projeto". - OpenCode: copie para
~/.agents/skills/(ou~/.config/opencode/skills/) e reinicie. - Cursor: transforme o
SKILL.mdem uma regra (.cursor/rules/panorama.mdc) e use@panorama. - Codex CLI: adicione a regra no
AGENTS.mddo projeto e peça "atualize o panorama usando a skill panorama".
Depois de instalada, a skill é acionada automaticamente quando o prompt combina — "status do projeto", "o que falta", "gere o panorama".
Por que funciona
- O estado consolidado vive no repositório — versionado, auditável, à prova de "eu esqueci onde paramos".
- Padronização entre projetos — todos os seus repositórios usam o mesmo formato de status.
- Disciplina de manutenção embutida — a regra no
AGENTS.mdgarante que a atualização acontece no mesmo commit, sem depender de boa vontade.