98984f91a0
- 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
66 lines
No EOL
3.2 KiB
Markdown
66 lines
No EOL
3.2 KiB
Markdown
# 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. |