Organização por sub-projeto

Cada repo de empresa (oinc-filmes, 1bmg, etc.) é organizado por sub-projeto — uma pasta top-level por produto, serviço ou iniciativa.

Por que sub-projetos

• Paralelismo: duas pessoas podem trabalhar em sub-projetos diferentes sem pisar uma na outra
• Contexto isolado: Claude Code entende só o contexto daquele sub-projeto quando você abre ele
• Mobilidade: se um sub-projeto precisar virar repo independente, move a pasta
• Clareza: fica óbvio o que é cada parte do trabalho

Estrutura padrão

<empresa>/
├── README.md              ← mapa do repo (obrigatório)
├── CLAUDE.md              ← contexto pro Claude Code (obrigatório)
├── .gitignore
├── sub-projeto-1/
│   ├── README.md
│   ├── CLAUDE.md
│   ├── src/
│   └── ...
├── sub-projeto-2/
│   ├── README.md
│   ├── CLAUDE.md
│   └── ...
└── docs/                  ← docs cross-sub-projeto (opcional)

README.md da raiz

Template:

# <Empresa> — <descrição em 1 linha>

Repositório principal da <empresa>.

## Sub-projetos

| Pasta | O que é | Status |
|---|---|---|
| [`sub1/`](sub1/) | 1 linha descritiva | ✅ Operacional |
| [`sub2/`](sub2/) | 1 linha descritiva | ⏸️ Pausado |

## Stack comum
- Linguagem principal, frameworks padrão.

## Contato
- Dev: <quem>
- PM: <quem>

CLAUDE.md da raiz

Template:

# <Empresa>

## Contexto
<O que essa empresa faz, mercado, clientes-tipo.>

## Stack padrão
<Tecnologias que dominam os sub-projetos.>

## Convenções
- Commits em português, mensagem começa com verbo minúsculo
- PR aberto com template padrão
- Testes vão em `tests/` dentro de cada sub-projeto

## Referências externas
- Dashboard: <url>
- Jira: <url>
- Telegram do time: <link>

Sub-projeto autocontido

Cada pasta de sub-projeto é um mundo próprio:

sub-projeto-1/
├── README.md          # o que é, como rodar localmente
├── CLAUDE.md          # contexto específico pro Claude Code
├── src/               # código-fonte
├── tests/             # testes
├── scripts/           # scripts de build/deploy/seed
├── .env.example       # template de vars de ambiente (SEM valores reais)
└── package.json / pyproject.toml / etc

README.md do sub-projeto

# <Sub-projeto>

## O que é
<1-2 parágrafos>

## Como rodar localmente
```bash
cp .env.example .env   # preencha com valores do LastPass
npm install
npm run dev

Stack

<linguagem, framework, banco, etc.>

Deploy

<onde está deployado, como deployar>

Dependências externas

<APIs, serviços>

Owner atual

Status

✅ Operacional | ⏸️ Pausado | 🔴 Quebrado

### CLAUDE.md do sub-projeto

```markdown
# <Sub-projeto> — Contexto pro Claude Code

## Propósito
<por que existe>

## Arquitetura
<desenho mental rápido: quem chama quem>

## Pontos de atenção
- <edge case 1>
- <edge case 2>

## Integrações
- <serviço 1, o que usa>

## Testes
<como rodar, onde ficam>

Exemplos práticos

1bmg/ (Paulo)

1bmg/
├── outbound/           # SDR engine (Apollo + PipeDrive)
├── inbound/            # carousels Instagram
├── claimradar/         # YouTube claims scanner
├── form/               # formulário de captura
├── ig-publish/         # publisher Instagram
└── roster/             # gestão de roster

oinc-filmes/ (Silas)

oinc-filmes/
├── dashboard/          # dashboard BI YouTube (8 canais)
├── storyboard-studio/  # geração de storyboard com IA
├── templates/          # briefings, roteiros, CTAs
└── clientes/           # uma pasta por cliente ativo

creator-reply/ (João)

creator-reply/
├── docs/               # PITCH, CONTEXT, RESEARCH, MVP_ROADMAP, FINANCIAL_MODEL
├── dashboard/          # UI inicial
└── api/                # backend (quando começar)

Adicionando novo sub-projeto

1. Chama Fred no Gather/Telegram pra alinhar
2. Cria a pasta com README.md e CLAUDE.md preenchidos
3. Abre PR só com a estrutura (pastas vazias)
4. Fred aprova
5. Popula o sub-projeto em PRs subsequentes

Próximo

→ Repositórios — visão geral.