skill-analise-sistemas

Refinamento funcional de demandas para qualquer LLM/IA — ChatGPT, Gemini, Claude, Cursor, Copilot, Continue, Aider, ou seu próprio agente. Coleta titulo, tipo, modulo, camadas, classes, arquivos, regras de negocio e produz documento Markdown estruturado em pacotes de trabalho com branches, tarefas, DoD, riscos, rollback, scripts SQL e cenarios BDD.

Dois modos de uso:

1. CLI (refinar) — gera prompt .md para colar em qualquer IA.
2. Skill nativa (init) — instala no Claude Code; também funciona como prompt manual em ChatGPT/Gemini/Cursor/etc copiando skill/SKILL.md.

Instalacao

Requer Node >= 18. Sem dependencias.

npx skill-analise-sistemas --help

Modo 1 — CLI (qualquer IA)

Gera prompt local, voce cola em qualquer IA.

npx skill-analise-sistemas refinar

CLI faz perguntas no terminal, le arquivos que voce referenciar, salva refinamento-<timestamp>.md. Abra o arquivo, copie tudo, cole na IA escolhida.

npx skill-analise-sistemas refinar --out demanda-x.md

Perguntas do CLI

1. Titulo da demanda
2. Tipo (nova feature / alteracao / bug / refactor)
3. Modulo/contexto
4. Camadas impactadas (multi)
5. Necessidade de BDD
6. Versao alvo
7. Classes envolvidas
8. Arquivos (paths — conteudo lido e embutido no prompt)
9. Regras de negocio
10. Observacoes

Modo 2 — Skill nativa Claude Code

npx skill-analise-sistemas init

Copia para .claude/skills/analise-sistemas/. Dentro do Claude Code:

/analise-sistemas

Opcoes:

npx skill-analise-sistemas init --force          # sobrescreve
npx skill-analise-sistemas init --dir ./outro    # destino customizado

Modo 3 — Qualquer outro LLM (ChatGPT, Gemini, Cursor, etc.)

Skill foi escrita agnostica de ferramenta. Funciona em qualquer IA.

Passo a passo

1. Abra o arquivo skill/SKILL.md deste repo (ou cole o conteudo de https://...).
2. Cole o conteudo inteiro como system prompt ou primeira mensagem na sua IA.
3. Envie em seguida: iniciar refinamento.
4. Responda as perguntas que a IA fizer (Pergunta 0 ate 5).
5. Cole o conteudo extenso (classes/arquivos/codebase/regras) quando solicitado.
6. IA devolve o documento Markdown completo.
7. Salve em analises/analise-YYYY-MM-DD-<slug>.md no seu projeto.

Mapeamento por host

| Host | PERGUNTAR | LER arquivos | GRAVAR arquivo | |------|-----------|--------------|----------------| | Claude Code | AskUserQuestion | Read/Glob/Grep | Write | | ChatGPT (web) | conversacional | colagem manual | exibe inline, voce salva | | Gemini (web) | conversacional | colagem manual | exibe inline, voce salva | | Cursor / Continue | conversacional | editor nativo | editor nativo | | Copilot Chat | conversacional | editor nativo | editor nativo | | Aider / Cline | terminal | agente de arquivo | agente de arquivo | | Assistants API | function ask_user | function read_file | function write_file |

Se o host nao tem leitura/escrita, a skill cai automaticamente em fallback inline: pergunta tudo conversacional, devolve Markdown no chat com instrucao explicita de salvar.

O que o documento gerado contem

Cabecalho YAML: demanda, tipo, modulo, nome-feature, camadas, testes-bdd, modo-leitura, pacotes-total, modo-gravacao, data.

Corpo:

• Visao geral do dominio
• Pacotes de trabalho em ordem logica (persistencia > negocio > UI > testes > versionamento)

Cada pacote contem:

• Branches (feature/<NOME-FEATURE>/master + feature/<NOME-FEATURE>/pacoteN)
• Resumo de alteracoes
• Detalhamento tecnico por camada (tabela)
• Tarefas acionaveis
• Dependencias (pre-requisitos / bloqueia)
• Criterios de aceite (DoD checklist)
• Riscos e mitigacoes
• Esforco estimado (PP/P/M/G/GG)
• Commits sugeridos (Conventional Commits)
• Scripts SQL (com UP + DOWN em migracoes)
• Rollback / plano de reversao
• Cenarios BDD/Gherkin (quando aplicavel)

Modos de gravacao

A skill pergunta como salvar:

• Arquivo unico — analises/analise-YYYY-MM-DD-<slug>.md
• Arquivos separados por pacote — analises/<slug>/pacote-N-<titulo>.md + indice com links

Auto-sugere modo separado se >= 5 pacotes ou > 800 linhas.

Estrutura do repo

.
|- bin/cli.js          # CLI (refinar + init)
|- skill/SKILL.md      # Skill agnostica (use em qualquer IA)
|- package.json

Licenca

MIT