# PADRÕES — como se escreve neste cérebro > Referência de formato. O `CLAUDE.md` diz **o que fazer**; este arquivo diz **como o arquivo > fica escrito**. Os dois agentes ({{AGENTE}} na VPS, Guardião na workstation) seguem isto. --- ## 1. Nome de arquivo | Tipo | Padrão | Exemplo | |---|---|---| | Nota de evento (algo que aconteceu) | `AAAA-MM-DD-.md` | `2026-08-07-reuniao-fornecedor-atacadao.md` | | Pessoa | `-.md` | `luana-cristina.md` | | Negócio / loja / operação | `.md` | `via-bahia.md` | | Projeto | `.md` | `industria-alimentos-via-bahia.md` | | Decisões do mês | `AAAA-MM.md` | `2026-08.md` | | Item na caixa de entrada | `AAAA-MM-DD-HHMM-.md` | `2026-08-07-1432-conversa-anderson.md` | Slug é minúsculo, sem acento, palavras separadas por hífen. Sem espaço no nome de arquivo novo. --- ## 2. Frontmatter Todo arquivo do acervo abre com o bloco YAML entre `---`. Campos: ### Obrigatórios ```yaml tipo: evento # evento | conhecimento | pessoa | negocio | projeto | decisao | pendencia | triagem area: via-bahia # via-bahia | fazenda | pessoal | familia status: ativo # ativo | arquivado | rascunho data: 2026-08-07 # a data do fato, não a de digitação ``` ### De relação (a parte que faz o cérebro virar rede) ```yaml relacionado: # esta nota CITA a outra — ou a ligação saiu da curadoria - "memory/context/people/anderson.md" relacionado_contexto: # ligação real entre notas que NÃO se citam, confirmada por {{DONO}} - alvo: "memory/projects/industria-alimentos-via-bahia.md" elo: "Tratam do mesmo fornecedor de embalagem — a negociação daqui define o custo de lá." por: {{SLUG_DONO}} em: 2026-08-07 relacionado_sugerido: # palpite ainda não revisado; some quando confirmado - "memory/context/business/fazenda.md" ``` Os três campos se separam pela **procedência**, não pelo tipo de ligação: | Campo | Como nasceu | Confiança | |---|---|---| | `relacionado` | a nota cita a outra, ou você confirmou na curadoria | fato | | `relacionado_contexto` | descoberta por tema e **confirmada por {{DONO}}** | conexão curada | | `relacionado_sugerido` | palpite do agente, ainda não revisado | **não use como verdade** | **Só `relacionado_contexto` leva `elo:`.** O elo é uma frase que diz *por que* o alvo importa para esta nota. Serve para decidir se vale abrir o alvo sem precisar abrir. Sem elo, a aresta é inútil. **A régua do `relacionado_contexto`** — vale quando as duas notas tratam do **mesmo objeto concreto**: mesmo fornecedor, mesma loja, mesma decisão em aberto, mesma pessoa no centro. **Não vale** quando o vínculo é só "o que aprendi ali serve aqui" — isso liga tudo com tudo e o mapa perde valor. ### De procedência ```yaml origem: {{AGENTE_SLUG}} # quem capturou: {{AGENTE_SLUG}} (VPS) | {{SLUG_DONO}} | guardiao canal: telegram # telegram | whatsapp | claude-code | reuniao | email captado_em: 2026-08-07 inserido_em: 2026-08-07 # quando virou acervo (só o Guardião preenche) fonte_bruta: "archive/inbox/2026-08/2026-08-07-1432-conversa-anderson.md" ``` --- ## 3. Links dentro do texto Duas camadas, sempre as duas: 1. **No corpo** — markdown relativo **ao arquivo onde você está escrevendo**, para humano e agente navegarem: `[Anderson](../context/people/anderson.md)`. 2. **No frontmatter** — caminho relativo **à raiz do cérebro**, para busca e indexação: `relacionado: ["memory/context/people/anderson.md"]`. **Link é navegação; frontmatter é indexação.** Quem só põe link no texto tem um cérebro que só funciona lendo; quem só põe no frontmatter tem um cérebro que ninguém navega. Nada de `[[wikilink]]` — este cérebro usa markdown padrão, que funciona em qualquer editor e no próprio GitHub. **Nota que fala de duas entidades** mora em **uma** pasta (a principal) e lista as duas em `relacionado:`. --- ## 4. Corpo da nota ```markdown # Título que diz o que aconteceu, não o assunto **BLUF:** duas ou três linhas com a conclusão. Quem ler só isto entende o essencial. - 💰 **Dinheiro:** o que tem de receita, custo ou caixa em jogo. Quanto, em que prazo. - ➡️ **Próximo passo:** a UMA ação que destrava. - ⚠️ **Risco:** o que pode dar errado ou o que está sendo ignorado. - 🔗 **Conecta:** [a que projeto/pessoa/negócio isto se liga](caminho.md) ## O que aconteceu Prosa curta. Fatos, sem enfeite. ## Fonte (literal) > Os trechos originais que sustentam números, valores, prazos e decisões — nas palavras de > quem falou. É a âncora contra a memória inventada. ## Pontos levantados (não combinados) O que apareceu na conversa mas ninguém assumiu. **Nunca vire `- [ ]` aqui.** ``` Título é frase, não etiqueta: *"Atacadão subiu o prazo de entrega para 10 dias"*, não *"Fornecedores"*. --- ## 5. Pendência Pendência é **obrigação de {{DONO}}**, com um próximo passo escrito. Vai em `memory/context/pendencias.md`, em append: ```markdown ### 2026-08-07 — Renegociar prazo com o Atacadão - **Próximo passo:** ligar para o Anderson e pedir a tabela de agosto - **Prazo:** 2026-08-12 - **Fonte:** memory/context/business/via-bahia.md - **Status:** aberta ``` Concluída ou cancelada → escreva o resultado na mesma linha, marque a data e **mova o bloco** para `archive/pendencias/AAAA-MM.md`. Lista de pendência que só cresce ninguém lê. --- ## 6. Limites que cortam sem avisar | Arquivo | Limite | O que acontece se passar | |---|---|---| | `MEMORY.md` | 2200 caracteres | O Hermes corta no boot, **em silêncio**. O agente perde memória. | | `USER.md` | 1375 caracteres | Idem. | Antes de salvar qualquer um dos dois: `wc -c MEMORY.md`. Se estourou, o excedente **desce para a gaveta** (`memory/context/…`) e fica só o ponteiro. --- ## 7. O que nunca entra - Senha, token, chave de API, dado de cartão — **em nenhuma hipótese**, nem no `inbox/`. - Arquivo que não seja `.md` ou `.html`: o `.gitignore` é fail-closed e ele **não sobe**. Se for importante, converta para texto ou registre onde o original está guardado. - Fofoca, avaliação pessoal sobre alguém, assunto de saúde de terceiro. Cérebro de negócio não é prontuário nem dossiê.