- 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
3.7 KiB
3.7 KiB
| 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
writeno 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).
- docx / pdf: skill oficial docx da Anthropic (ver
- 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/(veranalise-mercadoepesquisa-competitiva; estrutura do projeto conformeAGENTS.md). - Ideia original em
ideias/<slug>.mde notas emnotas/. - Verificar que
data/fontes.mdexiste 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/xlsxquando pedido.- Peças intermediárias em
<projeto>/data/comfontes.mde í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
- Nunca inventar fonte; se citar URL, conferir via
jina_read_urlque ela existe e diz o que afirmamos. - Financeiro sem premissas explícitas não é entregável (voltar ao passo 6).
- Se conversão falhar, entregar markdown e sinalizar em vez de forçar.