fsolla/estudo-negocios
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
estudo-negocios/AGENTS.md
fsolla 98984f91a0 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
2026-08-21 13:08:27 -03:00

3.2 KiB
Raw Permalink Blame History

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.