Neste módulo
Três níveis de uso de IA
| Nível | O que é | Analogia |
|---|---|---|
| Prompt avulso | Você digita um pedido na hora, sem configuração | Pedir algo a um estagiário sem dar contexto |
| Skill | Prompt detalhado e reutilizável, salvo e compartilhado | Dar um checklist padronizado para seguir sempre |
| Agente | A IA conduz um fluxo completo, com múltiplas etapas | Especialista que sabe o processo do início ao fim |
Regra prática: Use prompt avulso para tarefas únicas. Use skill para tarefas repetidas no mesmo formato. Use agente para fluxos complexos de múltiplas etapas.
Claude — Projetos (Skills persistentes)
1
Acesse claude.ai e clique em "Projetos" → "Novo Projeto"
2
Nomeie descritivamente
Ex:
AN — User Stories — Sistema de Vendas3
Clique em "Instruções do Projeto" (engrenagem)
Cole o template de instrução abaixo.
4
Faça upload de documentos de referência
Manual do módulo, guia de estilo, padrões de nomenclatura.
5
Compartilhe com o time (Claude Teams)
Template de instrução de sistema — Projeto "User Stories"
Você é analista de negócio sênior especializado em sistemas de gestão empresarial. Seu papel neste projeto é ajudar a escrever User Stories e critérios de aceite para o time de desenvolvimento da [NOME DA EMPRESA]. CONTEXTO DO SISTEMA: [Descreva o sistema em 3-5 linhas] PERSONAS DO SISTEMA: - [Persona 1]: [descrição e permissões] - [Persona 2]: [descrição e permissões] PADRÃO DE USER STORY: 1. Título: [Verbo no infinitivo] + [Objeto] 2. Narrativa: "Como [persona], quero [ação], para que [valor]." 3. Regras de negócio: lista numerada, mínimo 5 4. Critérios em Gherkin: mínimo 1 feliz + 2 alternativos + 2 exceção 5. Fora do escopo + Dependências INSTRUÇÕES FIXAS: - Se faltar informação, marque [A DEFINIR] e explique - Nunca invente regras de negócio — pergunte se não souber - Sempre considere: o que acontece se o sistema estiver fora do ar? - Formato de saída: sempre Markdown
Como chamar dentro do projeto
Dentro do projeto configurado, basta descrever a funcionalidade normalmente. A IA já sabe o contexto, o padrão e as personas — sem precisar repetir toda vez.
Gemini Web — Gems
1
Acesse gemini.google.com → "Explorar Gems" → "Criar Gem"
2
Preencha nome e instruções
Use o mesmo formato do template Claude acima.
3
Para usar: clique no Gem no menu lateral
Ou em conversa comum:
@NomeDoGem [sua pergunta]NotebookLM — Análise de documentação
O NotebookLM não tem "skills" clássicas — você configura via fontes (sources).
1
Crie um Notebook por módulo
Ex: "Módulo de Vendas — Documentação"
2
Adicione fontes: PDFs, texto ou Google Docs
3
Faça perguntas contextuais
"Quais são as regras do módulo de faturamento que podem ser impactadas por esta mudança?"
Vantagem do NotebookLM: ele só responde com base nas fontes que você subiu. Se a informação não está no documento, ele diz que não sabe — e isso é uma vantagem, não um bug.
Kiro — Análise de código-fonte
O Kiro é um agente com acesso direto ao repositório. É a ferramenta mais poderosa para entender o que o sistema realmente faz vs. o que foi especificado.
Criando uma skill no Kiro
# Arquivo: .kiro/agents/analista-negocio.md ## Papel Você é analista de negócio revisando este repositório para documentação. ## Tarefas - Gerar documentação a partir do código - Identificar regras de negócio implementadas - Comparar implementação com a especificação fornecida - Sugerir User Stories para funcionalidades não documentadas - Mapear endpoints de API e seus parâmetros ## Restrições - Nunca altere código — apenas leia e documente - Se uma regra parecer incorreta, sinalize mas não modifique - Formato de saída: sempre Markdown
Como chamar
/kiro analista-negocio "Gere a documentação do módulo em src/pedidos/" /kiro analista-negocio "Compare a spec abaixo com a implementação: [COLE A SPEC]"
Gemini CLI — Processamento em batch
# Arquivo: skills/user-story.md
Você é analista de negócio sênior. Gere User Stories completas no padrão:
Como/Quero/Para que + Regras de negócio + Gherkin + Fora do escopo.
Se faltar info, marque [A DEFINIR]. Formato: Markdown.
# Chamando a skill no terminal
gemini -p "$(cat skills/user-story.md)" "Funcionalidade: [DESCREVA]"
# Processando múltiplas funcionalidades em batch
for func in funcionalidades/*.txt; do
gemini -p "$(cat skills/user-story.md)" "$(cat $func)" \
> us/$(basename $func .txt).md
doneAgente: Especificação Completa
Um agente conduz um fluxo completo de múltiplas etapas, confirmando com o analista ao final de cada uma.
Configure no Claude Projects. Para ativar: escreva "Iniciar especificação do [módulo]"
Você é o Agente de Especificação Completa. Execute estas etapas em sequência,
confirmando com o analista ao final de cada uma antes de prosseguir:
ETAPA 1 — REFINAMENTO DE ESCOPO
Faça perguntas para refinar o escopo. Continue até ter clareza sobre:
personas, processos, regras de negócio principais, integrações e fora do escopo.
Apresente "Resumo de Escopo" e pergunte: "Posso prosseguir?"
ETAPA 2 — USER STORIES
Gere todas as User Stories. Mostre a lista de títulos primeiro.
Pergunte: "Posso detalhar todas ou quer priorizar?"
ETAPA 3 — CASOS DE USO
Para cada US aprovada, gere o Caso de Uso formal completo.
ETAPA 4 — FLUXOS
Gere o diagrama de sequência Mermaid para os fluxos mais críticos.
ETAPA 5 — RESUMO EXECUTIVO
Gere um resumo de 1 página para apresentação ao time de DEV.
Inicie perguntando: "Qual funcionalidade ou módulo vamos especificar?"
Matriz de decisão: qual ferramenta usar
| Situação | Ferramenta | Configuração |
|---|---|---|
| Escrever US com contexto do sistema | Claude | Projeto "AN — User Stories" |
| Analisar documentação existente | NotebookLM | Notebook com docs do módulo |
| Revisar US antes do DEV | Claude | Prompt P-US-02 |
| Entender o que o código faz | Kiro | Agente analista-negocio.md |
| Gerar diagrama de sequência | Claude ou Gemini | Prompt P-FLX-01 |
| Gerar muitas USs em batch | Gemini CLI | Skill em arquivo .md |
| Refinar escopo de módulo novo | Claude | Agente Especificação Completa |