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
This commit is contained in:
fsolla 2026-08-21 13:08:27 -03:00
parent be9069dec5
commit 98984f91a0
8 changed files with 284 additions and 28 deletions

View file

@ -81,7 +81,10 @@ resultado em `analises/AAAA-MM-DD-<tema>.md` seguindo o template do item [7](#7-
## 7. Saída ## 7. Saída
Salvar em `analises/AAAA-MM-DD-<tema>.md` com: Salvar como análise intermediária em `<projeto>/data/AAAA-MM-DD-analise-mercado.md`
(estrutura do projeto conforme `AGENTS.md`; a pasta `<projeto>/` é criada quando a
ideia sai do funil). A análise alimenta a seção 4 do relatório final
(`<projeto>/relatorio.md`, ver template em `templates/relatorio-projeto.md`):
```markdown ```markdown
# Análise: <tema> # Análise: <tema>
@ -101,6 +104,9 @@ Data: AAAA-MM-DD · Autor: agente+<usuário>
- Nome da fonte | URL | Acessado em (data) — para cada dado usado - Nome da fonte | URL | Acessado em (data) — para cada dado usado
``` ```
Registrar cada fonte também em `<projeto>/data/fontes.md` e cada arquivo
intermediário no índice `data/README.md`.
## Regras ## Regras
1. Todo número com fonte primária e data de acesso; sem "estimativa de 1. Todo número com fonte primária e data de acesso; sem "estimativa de

View file

@ -53,7 +53,10 @@ Para cada player relevante (busca web + site):
## Saída ## Saída
Salvar em `analises/competitivo-AAAA-MM-DD-<segmento>.md`: Salvar como análise intermediária em `<projeto>/data/AAAA-MM-DD-pesquisa-competitiva.md`
(estrutura conforme `AGENTS.md`), registrar fontes em `<projeto>/data/fontes.md`
e arquivos no índice `data/README.md`. O resumo vai para a seção 10
(Concorrência) do `relatorio.md`.
```markdown ```markdown
# Pesquisa competitiva: <segmento> (<UF/região>) # Pesquisa competitiva: <segmento> (<UF/região>)

View file

@ -28,28 +28,30 @@ com opções de exportação. É a etapa de entrega do fluxo: ideia →
## Fluxo ## Fluxo
### 1. Coletar insumos ### 1. Coletar insumos
- Análises concluídas em `analises/` (ver `analise-mercado` e - Análises intermediárias em `<projeto>/data/` (ver `analise-mercado` e
`pesquisa-competitiva`). `pesquisa-competitiva`; estrutura do projeto conforme `AGENTS.md`).
- Ideia original e notas em `ideias/`, `notas/`. - Ideia original em `ideias/<slug>.md` e notas em `notas/`.
- Verificar que toda análise tem seção de fontes com data de acesso. - Verificar que `data/fontes.md` existe e tem fonte + data de acesso para
cada dado citado.
### 2. Estrutura padrão do documento ### 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).
```markdown ```markdown
# <Título do estudo> — Nota de negócio # <Título do projeto> — Relatório de negócio
Data: AAAA-MM-DD · Status: rascunho / revisão / final Data: AAAA-MM-DD · Status: rascunho / revisão / final
## 1. Resumo executivo (máx. ½ página: oportunidade, tamanho, veredito) Preencher TODAS as seções obrigatórias do template
## 2. Contexto e problema (por que agora, por que aqui) `templates/relatorio-projeto.md`. Extensões sugeridas quando relevantes:
## 3. Solução/oferta (o que seria vendido, para quem) - Mercado: TAM/SAM/SOM [vem da analise-mercado]
## 4. Mercado (TAM/SAM/SOM + fontes) [vem da analise-mercado] - Concorrência [vem da pesquisa-competitiva]
## 5. Concorrência [vem da pesquisa-competitiva] - DRE projetado 3 anos (xlsx em data/)
## 6. Modelo de negócio e financeiro (unidades, preço, margem, ponto de - Cenários pessimista/base/otimista
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 ### 3. Regras de redação
@ -62,13 +64,16 @@ Data: AAAA-MM-DD · Status: rascunho / revisão / final
não obtidos como `[dado não obtido]`. não obtidos como `[dado não obtido]`.
### 4. Exportação (sob demanda) ### 4. Exportação (sob demanda)
- Markdown: salvar em `analises/AAAA-MM-DD-tema.md` (padrão). - 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 - docx/pdf/xlsx: usar as skills oficiais de documento; validar que o arquivo
abriu (se houver ferramenta de checagem) antes de declarar pronto. abriu (se houver ferramenta de checagem) antes de declarar pronto.
## Saída ## Saída
- `analises/AAAA-MM-DD-<tema>.md` (sempre) + `docx/pdf/xlsx` quando pedido. - `<projeto>/relatorio.md` (sempre) + `docx/pdf/xlsx` quando pedido.
- Atualizar o estado da ideia em `ideias/` (status: em análise → validada / - 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. descartada) e o README raiz se a estrutura mudar.
## Regras ## Regras

66
AGENTS.md Normal file
View file

@ -0,0 +1,66 @@
# AGENTS.md — estudo-negocios
Regras de organização do repositório. Todo agente (pi, Claude, outro) deve
seguir estas convenções ao criar ou editar arquivos aqui.
## Estrutura
```
estudo-negocios/
├── README.md # visão geral e estado
├── AGENTS.md # este arquivo (regras)
├── ideias/ # funil: uma nota por ideia (ver ideias/README.md)
├── notas/ # conhecimento transversal: pesquisas, referências,
│ # clippings, padrões de método
├── templates/
│ └── relatorio-projeto.md # template MÍNIMO de relatório (extensível)
├── <projeto>/ # UMA pasta por proposta de negócio (kebab-case)
│ ├── relatorio.md # documento canônico (obrigatório, segue template)
│ └── data/ # TODO arquivo intermediário usado no relatório
└── .pi/skills/ # skills dos agentes (padrão Agent Skills)
```
## Regras por projeto
1. **Uma pasta por proposta**, nome em kebab-case, sem acentos:
`energia-solar-rn`, `restaurante-regional-ba`, `ecommerce-artesanato`.
Criar apenas quando uma ideia sair do funil (`ideias/`) para análise.
2. **`<projeto>/relatorio.md`** é o documento canônico. Deve conter as seções
obrigatórias do template mínimo (`templates/relatorio-projeto.md`) e pode
ser estendido com seções adicionais, nunca removendo as obrigatórias.
3. **`<projeto>/data/`** guarda todo material intermediário usado para
construir o relatório: CSVs baixados, respostas de APIs, notas de
entrevista, análises parciais (mercado, concorrência), fontes citadas,
planilhas com premissas. Nenhum arquivo intermediário fora de `data/`.
4. **Convenção de nome em `data/`**: `YYYY-MM-DD-<tipo>-<detalhe>.ext` quando
houver data (ex.: `2026-08-21-pesquisa-competitiva-ba.md`,
`2026-08-21-ipca-12m.csv`); caso contrário `data/<tipo>-<detalhe>.ext`.
5. Manter em `data/README.md` (ou `data/00-INDICE.md`) uma linha por arquivo
explicando o que é e de onde veio.
6. **Números**: todo dado quantitativo no relatório deve ter origem registrada
em `data/fontes.md` (fonte | URL | data de acesso). Sem fonte e sem data,
não entra no relatório.
7. **Status do relatório** (frontmatter ou 1ª linha): `rascunho` /
`em análise` / `revisão` / `final` — atualizar conforme evolui.
## Funil de ideias (`ideias/`)
- Uma nota por ideia, `ideias/<slug>.md` (kebab-case), com campos: descrição,
setor/CNAE, região, por que pode funcionar, sinais favoráveis/desfavoráveis
(links), status (`no funil` / `em análise` / `validada` / `descartada`).
- Ao mover para análise: criar `<projeto>/` seguindo as regras acima e
atualizar o status da nota em `ideias/` para `em análise` com link para o
relatório.
## Skills
- Fluxo padrão para capricho nas análises: `analise-mercado` →
`pesquisa-competitiva` → `relatorio-negocio`, com `clipping-tendencias`
para monitoramento contínuo.
- Análises intermediárias são salvas em `<projeto>/data/`, nunca soltas na
raiz.
## Língua
- Documentos e notas em português do Brasil. Nomes de arquivo e pastas sem
acentos.

View file

@ -7,13 +7,24 @@ com notas sobre viabilidade, mercado e próximos passos.
## Estrutura ## Estrutura
- `ideias/` – ideias e oportunidades em investigação ```
- `analises/` – análises de mercado e viabilidade estudo-negocios/
- `notas/` – notas de pesquisa e referências (ver `pesquisa-ferramentas-agentes.md`, mapeamento de MCPs e skills) ├── AGENTS.md # regras de organização (obrigatórias p/ agentes)
├── ideias/ # funil: uma nota por ideia (ver ideias/README.md)
├── notas/ # pesquisa transversal e referências
├── templates/
│ ├── relatorio-projeto.md # template MÍNIMO do relatório (extensível)
│ └── data-README.md # índice padrão para <projeto>/data/
├── <projeto>/ # UMA pasta por proposta de negócio
│ ├── relatorio.md # documento canônico (segue o template)
│ └── data/ # arquivos intermediários (fontes, análises, CSVs)
└── .pi/skills/ # skills dos agentes
```
## Estado atual Cada proposta de negócio vive na sua própria pasta `<projeto>/` com
`relatorio.md` (documento canônico, mínimo definido em
Em fase inicial – nenhuma ideia foi escolhida ainda. `templates/relatorio-projeto.md` e sempre extensível) e `data/` com todos os
arquivos intermediários. Regras completas em `AGENTS.md`.
## Ferramentas dos agentes ## Ferramentas dos agentes
@ -23,3 +34,7 @@ Em fase inicial – nenhuma ideia foi escolhida ainda.
- **Skills do projeto** (`.pi/skills/`): `analise-mercado`, - **Skills do projeto** (`.pi/skills/`): `analise-mercado`,
`pesquisa-competitiva`, `relatorio-negocio`, `clipping-tendencias`. `pesquisa-competitiva`, `relatorio-negocio`, `clipping-tendencias`.
- Detalhes e stack recomendada: `notas/pesquisa-ferramentas-agentes.md`. - Detalhes e stack recomendada: `notas/pesquisa-ferramentas-agentes.md`.
## Estado atual
Em fase inicial – nenhuma ideia foi escolhida ainda.

25
ideias/README.md Normal file
View file

@ -0,0 +1,25 @@
# ideias/ — funil de ideias
Uma nota por ideia, em kebab-case sem acentos: `ideias/<slug>.md`.
Campos da nota:
```markdown
# <Nome da ideia>
- Setor / CNAE: ______
- Região: ______
- Fonte da ideia: ______ (link)
- Data: AAAA-MM-DD
- Status: no funil | em análise | validada | descartada
## Descrição (o que é, para quem, por quê)
## Sinais favoráveis (links + data)
## Sinais desfavoráveis (links + data)
## Ligação com relatório
```
Ao mover para análise: criar `<projeto>/` conforme `AGENTS.md` (relatorio.md +
data/) e atualizar status para `em análise` com link para o relatório.
Ao descartar: manter a nota com status `descartada` e motivos (evita
re-investigação).

27
templates/data-README.md Normal file
View file

@ -0,0 +1,27 @@
# data/ — arquivos intermediários do projeto
Este diretório guarda **todo** material usado para construir o
`../relatorio.md` deste projeto:
- CSVs/json baixados de APIs (BCB, IBGE, Receita, dados.gov, etc.)
- Notas de entrevistas/validação
- Análises intermediárias (mercado, concorrência, premissas)
- Planilhas de modelagem (DRE, premissas)
- Registro de fontes (`fontes.md`: fonte | URL | acessado em)
- Recortes de notícias e referências
## Regras
1. Nome: `AAAA-MM-DD-<tipo>-<detalhe>.ext` (ex. `2026-08-21-cnpj-ba.csv`).
2. Atualize este índice a cada arquivo adicionado:
- linha: `| arquivo | o que é | origem |` e, quando aplicável, nota de
privacidade/licença.
3. Nada aqui deve ser editado como se fosse documento final — o canônico é
`../relatorio.md`.
## Índice
| Arquivo | O que é | Origem |
|---|---|---|
| `fontes.md` | registro de fontes citadas no relatório | manter sempre atualizado |
| (adicionar...) | | |

View file

@ -0,0 +1,109 @@
# Relatório de Projeto de Negócio — template mínimo
> **Uso:** copie este arquivo para `<projeto>/relatorio.md` e preencha.
> As seções marcadas **[obrigatório]** não podem ser removidas — podem ser
> estendidas (adicionar linhas, tabelas, subseções). As seções marcadas
> **[opcional]** entram quando fizerem sentido para o projeto.
> Todo número com fonte registrada em `data/fontes.md`.
---
**Status:** `rascunho` | `em análise` | `revisão` | `final`
**Última atualização:** AAAA-MM-DD
**Autor:** [quem elaborou / prévia realizada em AAAA-MM-DD]
## 1. Nome do projeto **[obrigatório]**
[kebab-case, sem acentos — mesmo nome da pasta]
## 2. Resumo executivo **[obrigatório]**
Máx. ½ página: problema/oportunidade, oferta, público-alvo, principal
resultado esperado e recomendação em uma linha.
## 3. Oportunidade e contexto **[obrigatório]**
Por que agora e por que aqui. Sinais de demanda e tendências (com links).
Dados macro relevantes na data (inflação, juros, câmbio, renda da região).
## 4. Oferta e modelo **[obrigatório]**
O que será vendido, para quem, por quanto, por qual canal.
Tabela de preços/unidades (com fonte de benchmarking, se houver).
## 5. Local de operação **[obrigatório]**
- [ ] Cidade / UF / região: ______
- [ ] Por quê (mercado local, logística, incentivo, acesso a fornecedor): ___
## 6. Investimento inicial necessário **[obrigatório]**
| Item | Valor (R$) | Premissa / fonte |
|---|---|---|
| Equipamentos / obra / instalação | | |
| Estoque / matéria-prima inicial | | |
| Capital de giro (X meses) | | |
| Licenças, taxas, registro | | |
| Marketing e lançamento | | |
| Reserva de contingência | | |
| **TOTAL (investimento inicial)** | | |
## 7. Retorno esperado por janela de tempo **[obrigatório]**
Janela-alvo de retorno do investimento: **___ meses**.
| Janela | Receita (R$) | Custo variável | Custo fixo | Lucro do período | Lucro acumulado | ROI acumulado |
|---|---|---|---|---|---|---|
| 0–12 meses | | | | | | |
| 12–24 meses | | | | | | |
| 24–36 meses | | | | | | |
> Premissas que geraram a tabela (ticket, volume, margem, sazonalidade) em
> `data/premissas.md`. Estender com janelas adicionais e/ou linhas por
> semestre quando útil.
## 8. Break-even **[obrigatório]**
- Ponto de equilíbrio (cobre custos operacionais): mês ____, a partir de
receita mensal de R$ ____.
- Retorno do investimento (lucro acumulado ≥ investimento inicial): mês ____.
- Como calculado (DRE/resumo em `data/premissas.md` ou `data/dre-3-anos.xlsx`).
## 9. Riscos e mitigação **[obrigatório]**
| Risco | Probabilidade (A/M/B) | Impacto (A/M/B) | Mitigação |
|---|---|---|---|
| (ex.: regulatório, câmbio, dependência de fornecedor, demanda abaixo do previsto) | | | |
| | | | |
| | | | |
## 10. Concorrência **[obrigatório]**
Resumo do cenário competitivo; detalhe em `data/pesquisa-competitiva.md`.
Nº de players, principais concorrentes, faixas de preço, diferenciação
possível.
## 11. Fontes **[obrigatório]**
Ver `data/fontes.md` (fonte | URL | acessado em). Cada dado citado no texto
deve ser rastreável até este arquivo.
## 12. Decisão e próximos passos **[obrigatório]**
- Decisão: `avançar` / `investigar mais` / `descartar` (uma linha de
justificativa).
- Validação dos próximos 30/90 dias: o que testar, com quem, com qual dado.
---
## Seções opcionais (adicionar conforme o projeto)
- **TAM / SAM / SOM** — dimensionamento com premissas (ver skill
`analise-mercado`).
- **DRE projetado 3 anos** — tabela anual em `xlsx` na `data/`.
- **Cenários** — pessimista / base / otimista (tabela de variáveis-chave).
- **Regulatório e tributário** — enquadramento (MEI/Simples anexo), licenças.
- **Equipe e capital humano** — quadro, salários, recrutamento.
- **Canais e marketing** — plano de entrada e CAC estimado.
- **Sazonalidade** — curva de demanda ao longo do ano.
- **Anexos** — fotos, plantas, cotações, contratos-modelo, etc.