estudo-negocios/.pi/skills/relatorio-negocio/SKILL.md
fsolla 98984f91a0 Cria regras de organização por projeto: <projeto>/relatorio.md + <projeto>/data/
- AGENTS.md: estrutura do repo, regras por projeto (pasta kebab-case,
  relatorio.md canônico, data/ para intermediários, fontes.md, status)
- templates/relatorio-projeto.md: template MÍNIMO extensível (nome, resumo,
  investimento inicial, retorno por janela, break-even, riscos, local,
  concorrência, fontes, decisão)
- templates/data-README.md: índice padrão da pasta data/
- ideias/README.md: convenção do funil de ideias
- Skills atualizadas para salvar análises intermediárias em data/ e
  relatório em <projeto>/relatorio.md
2026-08-21 13:08:27 -03:00

3.7 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 intermediárias em <projeto>/data/ (ver analise-mercado e pesquisa-competitiva; estrutura do projeto conforme AGENTS.md).
  • Ideia original em ideias/<slug>.md e notas em notas/.
  • Verificar que data/fontes.md existe e tem fonte + data de acesso para cada dado citado.

2. Estrutura do relatório

O relatorio.md do projeto deve conter pelo menos o template mínimo (templates/relatorio-projeto.md): nome, resumo executivo, oportunidade, oferta/modelo, local, investimento inicial, retorno por janela de tempo, break-even, riscos, concorrência, fontes, decisão. Seções podem ser estendidas (nunca removidas).

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

Preencher TODAS as seções obrigatórias do template
`templates/relatorio-projeto.md`. Extensões sugeridas quando relevantes:
- Mercado: TAM/SAM/SOM [vem da analise-mercado]
- Concorrência [vem da pesquisa-competitiva]
- DRE projetado 3 anos (xlsx em data/)
- Cenários pessimista/base/otimista

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 <projeto>/relatorio.md (padrão). Arquivos intermediários (planilhas de premissas, CSVs) em <projeto>/data/.
  • 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

  • <projeto>/relatorio.md (sempre) + docx/pdf/xlsx quando pedido.
  • Peças intermediárias em <projeto>/data/ com fontes.md e índice atualizados.
  • Atualizar o status da ideia em ideias/<slug>.md (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.