why-olivers

55 Regras do Cérebro OLV — como o repo funciona como um cérebro inteligente

Framework operacional canonizado. 11 domínios × 5 regras = 55. Toda decisão, issue, PR, comentário deve poder ser defendido por 1+ dessas regras.

Regras vivem em harmonia com 17 Leis do Trabalho em Equipe (Maxwell). Se conflitar: humano decide, ADR registra.

Formato de cada regra: número · nome · o que é · como aplica — 1 parágrafo caveman.


I. Governança do repositório (1-5)

1 · Repo é SoT. Nada existe fora dele. Se decisão importante está em WhatsApp, email ou reunião oral: não existe. Move pra issue/ADR em 24h ou perde-se.

2 · main sempre deployable. Nunca commit direto em main sem PR. Feature branch, PR, review, merge, delete branch. Regra vale mesmo pra founders.

3 · Conventional Commits obrigatório. <tipo>(<escopo>): <descrição em português>. Tipos: feat/fix/chore/docs/refactor/style/test/ci/perf. Nada de “update stuff” ou “wip fix”.

4 · CODEOWNERS obrigatório em todo repo novo. Default @dev-grupo-olv/founders. Refina por pasta quando Teams por cavalinho existirem.

5 · README + CLAUDE.md + .env.example em todo repo novo. README explica o que é (leigo-friendly). CLAUDE.md dá contexto pro AI agent. .env.example lista secrets sem valor.


II. PMO · Issues · Boards (6-10)

6 · 1 issue = 1 Big Project. 5-15 sub-tarefas em task list - [ ] dentro. Nunca 20 micros com body de 1 linha (feedback-pmo-issues-macro.md).

7 · “Done quando” observável em 1 linha. Sempre. Sem critério observável = issue não fecha nunca = ruído eterno.

8 · Labels canônicas obrigatórias. Toda issue tem: p0|p1|p2|p3 + epic:* + milestone:* + area:* (mínimo 4 labels).

9 · Todo item de escopo tem owner + prazo. Tarefa · owner · Nd. Sem owner = ninguém faz. Sem prazo = eterno WIP.

10 · “Fora do escopo” obrigatório. Toda Big Project declara o que NÃO faz. Evita scope creep, respeita boundary.


III. Linguagem · Comunicação (11-15)

11 · Caveman universal. Verbo primeiro, bullets, palavras curtas, zero jargão. Se leigo não entende, refazer (feedback-pmo-linguagem-caveman.md).

12 · Números > adjetivos. “3 dias” > “em breve”. “R$ 5k” > “orçamento moderado”. “80% dos clientes” > “muitos clientes”. Sempre.

13 · Assíncrono por default. Copy tem que se explicar sozinho sem ping. Contexto essencial no próprio texto. Se precisa reunião pra entender: refazer copy.

14 · Zero decoração. Sem emoji (salvo alerta P0 🛡️), sem headers vazios (“🚀 Próximos passos” sem conteúdo), sem separadores decorativos, sem “vale destacar”.

15 · 1 ideia por bloco. Se tem 2 ideias, 2 parágrafos ou 2 bullets separados. Bloco misturado = leitor perde.


IV. Coordenação · Trabalho em equipe (16-20)

16 · “Peguei” antes de editar. Antes de mudar body de issue: comentário “peguei” + label assigned-to:<seu-nome>. Ao terminar: comentário “libero” + assigned-to:free.

17 · Nunca fecha issue de outro sem OK. Comenta perguntando primeiro. Fechar sem alinhar destrói confiança (Lei #9 Maxwell).

18 · Divisão por EPIC. A · Ecossistema = Claude/Matheus lead. B · Redesign = Thiago lead. C · Summit = ambos. Big Project novo entra no EPIC certo.

19 · Conflito vira ADR. Divergência entre 2 pessoas ou 2 agentes nunca se resolve silêncio. ADR em brain/decisions/, 2 assinaturas, decisão registrada.

20 · Retro quinzenal encerra com kill list. Toda retro pergunta: “o que a gente PARA de fazer semana que vem?” Sem kill = feature factory (ANTI-NOISE #7).


V. Estratégia · Bússola (21-25)

21 · Toda decisão T0 ancorada em 1+ das 17 Leis. Ou nas 55 regras. Sem ancoragem = decisão de impulso. Registra qual regra ancora.

22 · Golden Circle publicado por cavalinho. Why/How/What claros e visíveis. Não sabemos por que existimos? Não vamos escalar.

23 · BMC atualizado a cada QBR. 9 blocos Osterwalder. Se BMC de hoje = BMC de 3 meses atrás e nada mudou: ou não estamos aprendendo ou não estamos operando.

24 · 3 cenários + kill-switch em toda tese Dumbledore. Otimista/realista/pessimista com gatilhos observáveis. Decisão sem cenário é aposta cega.

25 · Pre-mortem Munger obrigatório em T0. Imagina projeto morreu em 12 meses — lista 5 modos de morte (produto/mercado/execução/capital/concorrência). Corrige antes de começar.


VI. Operação · Execução (26-30)

26 · Todo cavalinho tem 3-5 KPIs no placar. Máximo 5. Se tem 12, ninguém age. Escolhe os 5 que definem o cavalinho vencer/perder (Lei #11 Maxwell).

27 · Todo KPI tem kill-switch. “Se X < Y por Z semanas → ação W”. Sem kill-switch é decoração (ANTI-NOISE #9).

28 · SLA declarado > SLA implícito. Todo serviço tem SLA por escrito (P0 <1h · P1 <24h · P2 <72h · P3 <14d). Sem SLA = expectativa mágica.

29 · Runbook incidente P0 obrigatório antes de subir prod. RTO/RPO declarado. Sem runbook: veto Osnyak. Prod cai domingo 3h da manhã: quem faz o quê?

30 · Playbook gerente atualizado a cada mudança de processo. Processo mudou e não tá no playbook: gerente não sabe, não aplica, não cobra. Playbook morto = processo morto.


VII. Cérebro · Persistência de contexto (31-35)

31 · Brain wiki-like padrão Karpathy. Pergunta boa vira página, não resposta efêmera. Reutilizar > repetir. Health-check periódico (contradições, orphans, cross-refs).

32 · Brain separado por tipo. sessions/ (logs cronológicos) · decisions/ (ADRs) · projects/ (state por projeto) · memory/ (feedback + rules) · workflows/ (processos). Nunca mistura.

33 · ADR pra toda decisão arquitetural. Se decisão é irreversível ou custa >8h reverter: ADR. Formato: Contexto · Decisão · Consequências · Kill-switch · Referências.

34 · Session log obrigatório fim de sessão. 3-5 linhas: o que foi feito + pendências + próximos passos. Sem log = próxima sessão começa do zero.

35 · Memory freshness check trimestral. Memory >90d sem update = flag stale. Ou revisa ou deleta. Contexto rançoso é pior que ausência.


VIII. Agentes IA · AI Squad (36-40)

36 · Toda pergunta → skill matcher primeiro (ROUTER-OLV). Antes de responder qualquer coisa: escanear skills, escolher a mais próxima, ativar. Sem skill match = usa base + registra oportunidade de nova skill.

37 · Agente propõe, humano decide. Autoridade final SEMPRE humana. Agente pode ter authority pra ação reversível autonomamente (WARN, refactor, comment) mas não pra irreversível (kill projeto, demissão, gasto >R$10k).

38 · Cross-cerebral peer review trimestral (OLV ↔ GL7). Agentes OLV se comparam com equivalentes GL7 (Thiago). Detecta drift, absorve boas práticas, valida DNA.

39 · Skill nova passa por skill-gate antes de instalar. Naming, estrutura, frontmatter, termos proibidos, eval obrigatória, proveniência. Skill que não passa: não entra no brain.

40 · Zero secret hardcoded. Sempre op read "op://vault/item/credential" ou env var. Nem em .env commitado, nem em skill, nem em código. 1Password Service Account é canônico.


IX. Segurança · LGPD · Compliance (41-45)

41 · Zero-trust default. STRIDE (Spoofing/Tampering/Repudiation/Info-disclosure/DoS/Elevation) em toda mudança T0. Assume-breach mindset (Osnyak).

42 · Twice-validated pra “é seguro”. 2 métodos independentes (static + dynamic OR manual + automated). “É seguro” sem evidência timestamped: veto.

43 · Secret rotation trimestral obrigatório. Todo API key, PAT, service account: rotaciona a cada 90d. Sem rotação = comprometido silêncio.

44 · LGPD DPIA por vertical anual. Cada vertical (Food/Tech/Media/RE) tem Data Protection Impact Assessment revisado 1x/ano. High-risk = trimestral. DSR ≤15d (art. 19). Breach ≤72h (art. 48).

45 · Backup 3-2-1-1-0. 3 cópias · 2 mídias diferentes · 1 offsite · 1 imutável · 0 erro na restore test mensal. Backup que nunca testou restore não é backup.


X. Cadência · Rituais (46-50)

46 · Weekly heads quinta 15h BRT · 30 min · pauta obrigatória. Sem pauta = sem meeting (Bezos). Sync não vira relatório — é pra destravar, não listar (CADENCIA.md).

47 · MoM primeira segunda do mês · 1h. Cada head reporta OKR do setor (3 min). Matheus contexto macro. Cross-setor blockers. Compromissos do mês seguinte.

48 · QBR primeira semana do trimestre · 2h presencial. OKR anterior revisado · Dumbledore macro · Morgan capital · OKR próximo · Kill list obrigatória (20-30%) · compromissos individuais.

49 · Ninguém trabalha após 19h BRT. P0 é exceção. Trabalho crônico pós-19h = falha de planejamento OU excesso de escopo. Laya monitora.

50 · Sexta tarde protegida. Nada novo após 15h BRT sexta. Encerra semana, prepara descanso. Regra Laya sagrada.


XI. Meta-regras (51-55)

51 · Toda regra tem “quando NÃO aplicar”. Rigidez mata operação. Ex: “Regra 2 · main deployable” NÃO se aplica em repo experimental _sandbox/. Documenta exceção.

52 · Regra viola realidade? Revisa. Com evidência (dado, incidente, feedback), não sensação. Ou reforça (adiciona guardrail) ou flexibiliza (adiciona exceção).

53 · Nova regra vira ADR + entra neste doc + memory. Regra criada sem ADR: não existe. Sem entrar aqui: some. Sem memory: agente futuro não sabe.

54 · Kill regra que virou teatro. QBR trimestral pergunta: “esta regra tá sendo aplicada? tá gerando valor? OU virou ritual vazio?” Se teatro: mata.

55 · Este doc é vivo. Merge PRs, não crie duplicatas. Se você quer adicionar regra: PR pra editar este doc, não novo doc. Se você discorda de regra: ADR + PR proposta.


Uso diário

Como referenciar

Regra #6 (1 issue = 1 Big Project) violada — 5 micros nessa PR.
Ancoro em Regra #21 + Lei #7 (Bússola).
Kill-switch conforme Regra #27.

Índice rápido

# Regra Domínio
1-5 Governança do repo I
6-10 PMO · Issues · Boards II
11-15 Linguagem · Comunicação III
16-20 Coordenação equipe IV
21-25 Estratégia · Bússola V
26-30 Operação · Execução VI
31-35 Cérebro · Persistência VII
36-40 Agentes IA VIII
41-45 Segurança · LGPD IX
46-50 Cadência · Rituais X
51-55 Meta-regras XI

Referências

Criado 2026-07-15 · Matheus Busson + Claude · versão 1.0