jlholm/noodle

Cérebro

Memória persistente entre sessões. Vault Obsidian em brain/.

O cérebro é a base de todo o fluxo de trabalho — todo agente, skill e sessão o lê. Conteúdo de baixa qualidade ou especulativo degrada tudo a jusante. Antes de adicionar algo, pergunte: "Isso realmente melhora a forma como o sistema opera?" Se a resposta não for um claro 'sim', não escreva.

Antes de Escrever

Leia brain/index.md primeiro. Em seguida, leia o ponto de entrada relevante para seu tópico:

• brain/principles.md para atualizações de princípios
• brain/plans/index.md para anotações relacionadas a planos

Para diretórios sem um arquivo de índice dedicado ainda (brain/codebase/, brain/audits/), leia os arquivos próximos diretamente e edite uma anotação existente quando possível.

Estrutura

brain/
├── index.md              ← ponto de entrada raiz, links para tudo
├── principles.md         ← índice para principles/
├── todos.md              ← backlog do produto
├── vision.md             ← elevator pitch + link para arquitetura
├── architecture.md       ← referência técnica completa
├── principles/           ← princípios de engenharia e design
├── codebase/             ← conhecimento e pegadinhas específicos do projeto
├── plans/                ← planos de funcionalidades numerados (02-arrow-bindings/, etc.)
└── audits/               ← auditorias de design e qualidade (nomes de arquivo prefixados com data, ex. 2026-02-20-quality-audit.md)

Regras:

• Um tópico por arquivo. brain/codebase/noodle-spawn-gotchas.md, não um mega-arquivo.
• Mantenha pontos de entrada de índice existentes: brain/index.md, brain/principles.md, brain/plans/index.md.
• Se você introduzir uma nova categoria de nível superior, adicione um ponto de entrada do tipo índice para ela (apenas links, sem conteúdo embutido).
• brain/index.md é a raiz. Cada arquivo cerebral deve ser acessível a partir dele.
• Nomes de arquivo: minúsculos, com hífens. worktree-gotchas.md.
• Diretórios de planos: prefixados com o ID da tarefa de brain/todos.md. 02-arrow-bindings/ com overview.md e phase-N-*.md dentro.

Wikilinks

Formato: [[seção/nome-do-arquivo]]. Ordem de resolução: mesmo diretório, depois caminho relativo, depois raiz do vault. Âncoras de cabeçalho ([[arquivo#cabeçalho]]) são removidas durante a resolução.

Estilo de Escrita

• Marcadores em vez de prosa. Sem preâmbulo.
• Markdown simples com # Título. Sem frontmatter do Obsidian.
• Mantenha anotações com menos de ~50 linhas. Divida se mais longo.

Após Escrever

Atualize brain/index.md para quaisquer arquivos adicionados ou removidos. Também atualize o ponto de entrada relevante (brain/principles.md, brain/delegation.md ou brain/plans/index.md) quando aplicável. Mantenha índices apenas com links e escaneáveis.

Teste de Durabilidade

Pergunte: "Eu incluiria isso em um prompt para uma tarefa diferente?"

• Sim → escreva em brain/. É conhecimento durável.
• Não, é específico do plano → atualize o documento de fase do plano.
• Não, é um problema da skill → atualize o arquivo da skill diretamente.
• Não, precisa de trabalho de acompanhamento → registre uma tarefa com a skill todo.

Manutenção

• Exclua anotações desatualizadas ou substituídas.
• Exclua arquivos com nomes aleatórios em brain/plans/ — artefatos de modo de plano obsoletos.
• Mescle anotações sobrepostas antes de adicionar novas.