diff --git a/.pi/skills/analise-mercado/SKILL.md b/.pi/skills/analise-mercado/SKILL.md index cf6a1b3..f5d44b8 100644 --- a/.pi/skills/analise-mercado/SKILL.md +++ b/.pi/skills/analise-mercado/SKILL.md @@ -81,7 +81,10 @@ resultado em `analises/AAAA-MM-DD-.md` seguindo o template do item [7](#7- ## 7. Saída -Salvar em `analises/AAAA-MM-DD-.md` com: +Salvar como análise intermediária em `/data/AAAA-MM-DD-analise-mercado.md` +(estrutura do projeto conforme `AGENTS.md`; a pasta `/` é criada quando a +ideia sai do funil). A análise alimenta a seção 4 do relatório final +(`/relatorio.md`, ver template em `templates/relatorio-projeto.md`): ```markdown # Análise: @@ -101,6 +104,9 @@ Data: AAAA-MM-DD · Autor: agente+ - Nome da fonte | URL | Acessado em (data) — para cada dado usado ``` +Registrar cada fonte também em `/data/fontes.md` e cada arquivo +intermediário no índice `data/README.md`. + ## Regras 1. Todo número com fonte primária e data de acesso; sem "estimativa de diff --git a/.pi/skills/pesquisa-competitiva/SKILL.md b/.pi/skills/pesquisa-competitiva/SKILL.md index d9aa5f1..c56438d 100644 --- a/.pi/skills/pesquisa-competitiva/SKILL.md +++ b/.pi/skills/pesquisa-competitiva/SKILL.md @@ -53,7 +53,10 @@ Para cada player relevante (busca web + site): ## Saída -Salvar em `analises/competitivo-AAAA-MM-DD-.md`: +Salvar como análise intermediária em `/data/AAAA-MM-DD-pesquisa-competitiva.md` +(estrutura conforme `AGENTS.md`), registrar fontes em `/data/fontes.md` +e arquivos no índice `data/README.md`. O resumo vai para a seção 10 +(Concorrência) do `relatorio.md`. ```markdown # Pesquisa competitiva: () diff --git a/.pi/skills/relatorio-negocio/SKILL.md b/.pi/skills/relatorio-negocio/SKILL.md index e57c844..646f714 100644 --- a/.pi/skills/relatorio-negocio/SKILL.md +++ b/.pi/skills/relatorio-negocio/SKILL.md @@ -28,28 +28,30 @@ com opções de exportação. É a etapa de entrega do fluxo: ideia → ## 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. +- Análises intermediárias em `/data/` (ver `analise-mercado` e + `pesquisa-competitiva`; estrutura do projeto conforme `AGENTS.md`). +- Ideia original em `ideias/.md` e notas em `notas/`. +- 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 -# — Nota de negócio +# — Relatório 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) +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 @@ -62,13 +64,16 @@ Data: AAAA-MM-DD · Status: rascunho / revisão / final não obtidos como `[dado não obtido]`. ### 4. Exportação (sob demanda) -- Markdown: salvar em `analises/AAAA-MM-DD-tema.md` (padrão). +- Markdown: salvar em `/relatorio.md` (padrão). Arquivos + intermediários (planilhas de premissas, CSVs) em `/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 -- `analises/AAAA-MM-DD-.md` (sempre) + `docx/pdf/xlsx` quando pedido. -- Atualizar o estado da ideia em `ideias/` (status: em análise → validada / +- `/relatorio.md` (sempre) + `docx/pdf/xlsx` quando pedido. +- Peças intermediárias em `/data/` com `fontes.md` e índice + atualizados. +- Atualizar o status da ideia em `ideias/.md` (em análise → validada / descartada) e o README raiz se a estrutura mudar. ## Regras diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8fe1b46 --- /dev/null +++ b/AGENTS.md @@ -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) +├── / # 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. **`/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. **`/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--.ext` quando + houver data (ex.: `2026-08-21-pesquisa-competitiva-ba.md`, + `2026-08-21-ipca-12m.csv`); caso contrário `data/-.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/.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 `/` 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 `/data/`, nunca soltas na + raiz. + +## Língua + +- Documentos e notas em português do Brasil. Nomes de arquivo e pastas sem + acentos. \ No newline at end of file diff --git a/README.md b/README.md index e3068b4..4c41ec1 100644 --- a/README.md +++ b/README.md @@ -7,13 +7,24 @@ com notas sobre viabilidade, mercado e próximos passos. ## Estrutura -- `ideias/` – ideias e oportunidades em investigação -- `analises/` – análises de mercado e viabilidade -- `notas/` – notas de pesquisa e referências (ver `pesquisa-ferramentas-agentes.md`, mapeamento de MCPs e skills) +``` +estudo-negocios/ +├── 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 /data/ +├── / # 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 - -Em fase inicial – nenhuma ideia foi escolhida ainda. +Cada proposta de negócio vive na sua própria pasta `/` com +`relatorio.md` (documento canônico, mínimo definido em +`templates/relatorio-projeto.md` e sempre extensível) e `data/` com todos os +arquivos intermediários. Regras completas em `AGENTS.md`. ## Ferramentas dos agentes @@ -23,3 +34,7 @@ Em fase inicial – nenhuma ideia foi escolhida ainda. - **Skills do projeto** (`.pi/skills/`): `analise-mercado`, `pesquisa-competitiva`, `relatorio-negocio`, `clipping-tendencias`. - Detalhes e stack recomendada: `notas/pesquisa-ferramentas-agentes.md`. + +## Estado atual + +Em fase inicial – nenhuma ideia foi escolhida ainda. \ No newline at end of file diff --git a/ideias/README.md b/ideias/README.md new file mode 100644 index 0000000..d4888a0 --- /dev/null +++ b/ideias/README.md @@ -0,0 +1,25 @@ +# ideias/ — funil de ideias + +Uma nota por ideia, em kebab-case sem acentos: `ideias/.md`. + +Campos da nota: + +```markdown +# +- 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 `/` 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). \ No newline at end of file diff --git a/templates/data-README.md b/templates/data-README.md new file mode 100644 index 0000000..d9269f6 --- /dev/null +++ b/templates/data-README.md @@ -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--.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...) | | | \ No newline at end of file diff --git a/templates/relatorio-projeto.md b/templates/relatorio-projeto.md new file mode 100644 index 0000000..23a4ed9 --- /dev/null +++ b/templates/relatorio-projeto.md @@ -0,0 +1,109 @@ +# Relatório de Projeto de Negócio — template mínimo + +> **Uso:** copie este arquivo para `/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. \ No newline at end of file