# 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.