estudo-negocios/.pi/skills/relatorio-negocio/SKILL.md
fsolla be9069dec5 Configura MCPs de dados BR (mcp-brasil, bcb-br, ibge-br) e skills de pesquisa de negócio
- Registra mcp-brasil (venv local), bcb-br e ibge-br em ~/.config/mcp/mcp.json
  (arquivo global compartilhado; não commitable, fora do repo)
- Skills do projeto em .pi/skills/: analise-mercado, pesquisa-competitiva,
  relatorio-negocio, clipping-tendencias
- README e notas/pesquisa-ferramentas-agentes.md atualizados com status
2026-08-21 12:58:05 -03:00

3.5 KiB
Raw Blame History

name description
relatorio-negocio Gera a nota/documento final de um estudo de negócio no Brasil em markdown estruturado, com sumário executivo, análise, cenários e anexos; converte para docx/xlsx/pdf quando solicitado. Use ao fechar uma análise (analise-mercado/pesquisa-competitiva) e entregar o resultado.

Relatório de Negócio

Converte análises concluídas em documento final legível (markdown por padrão), com opções de exportação. É a etapa de entrega do fluxo: ideia → analise-mercado → pesquisa-competitiva → este skill.

Ferramentas

  • Já no pi: escrita de markdown via tool write no repo (analises/, ideias/, notas/). Conversão condicional:
    • docx / pdf: skill oficial docx da Anthropic (ver ~/Code/estudo-negocios/.pi/skills/ ou ~/.pi/agent/git/.../anthropics-skills); PDF via o browser-tools ou LibreOffice headless se disponível, senão entregar markdown.
    • xlsx: skill oficial xlsx quando houver tabelas de modelagem financeira (DRE 3 anos, premissas, TAM/SAM/SOM numérico).
  • jina (jina_read_url) apenas para citar fielmente fontes externas.

Se a skill de conversão não estiver disponível no ambiente, entregue markdown e avise que a conversão fica pendente. Nunca improvise formato binário manualmente.

Fluxo

1. Coletar insumos

  • Análises concluídas em analises/ (ver analise-mercado e pesquisa-competitiva).
  • Ideia original e notas em ideias/, notas/.
  • Verificar que toda análise tem seção de fontes com data de acesso.

2. Estrutura padrão do documento

# <Título do estudo> — Nota de negócio
Data: AAAA-MM-DD · Status: rascunho / revisão / final

## 1. Resumo executivo (máx. ½ página: oportunidade, tamanho, veredito)
## 2. Contexto e problema (por que agora, por que aqui)
## 3. Solução/oferta (o que seria vendido, para quem)
## 4. Mercado (TAM/SAM/SOM + fontes) [vem da analise-mercado]
## 5. Concorrência [vem da pesquisa-competitiva]
## 6. Modelo de negócio e financeiro (unidades, preço, margem, ponto de
   equilíbrio; premissas explícitas)
## 7. Riscos e mitigação (tabela: risco | probabilidade | impacto | mitigação)
## 8. Plano de validação (próximos 30/90 dias: quem validar, com que dado)
## 9. Decisão recomendada
## 10. Fontes (nome | URL | acessado em)

3. Regras de redação

  • Conciso: 3–8 páginas equivalentes; resumo executivo antes do resto.
  • Todo número com fonte; premissas financeiras numa tabela única no topo do item 6 (colunas: premissa | valor | fonte | data).
  • PT-BR, sem "AI-slop": frases diretas, verbo no indicativo, zero adjetivos de marketing. Usar – (en dash) quando houver intervalos.
  • Hipóteses marcadas como [hipótese], fatos como [fato], dados não obtidos como [dado não obtido].

4. Exportação (sob demanda)

  • Markdown: salvar em analises/AAAA-MM-DD-tema.md (padrão).
  • docx/pdf/xlsx: usar as skills oficiais de documento; validar que o arquivo abriu (se houver ferramenta de checagem) antes de declarar pronto.

Saída

  • analises/AAAA-MM-DD-<tema>.md (sempre) + docx/pdf/xlsx quando pedido.
  • Atualizar o estado da ideia em ideias/ (status: em análise → validada / descartada) e o README raiz se a estrutura mudar.

Regras

  1. Nunca inventar fonte; se citar URL, conferir via jina_read_url que ela existe e diz o que afirmamos.
  2. Financeiro sem premissas explícitas não é entregável (voltar ao passo 6).
  3. Se conversão falhar, entregar markdown e sinalizar em vez de forçar.