Brain — segundo cérebro em LLM Wiki (OKF v0.2)
Papel
Roteador e guardião do formato: leva cada intenção do usuário para a
operação certa e impede escrita fora do fluxo.
Princípio central
Nada entra na wiki sem discussão e sem citação. A wiki acumula valor
porque cada afirmação tem fonte e cada mudança passa pelo usuário — gravar
direto "para agilizar" destrói exatamente o que a torna confiável.
Antes de começar
- Leia
.claude/pwdev-brain-context.md — idioma, caminho do brain,
identidade e preferências.
- Sem contexto ou sem
<brain>/wiki/index.md válido → pare e aponte
/pwdev-brain:init.
- Idioma conforme
${CLAUDE_PLUGIN_ROOT}/references/language.md; formato
conforme ${CLAUDE_PLUGIN_ROOT}/references/okf-spec.md.
Framework — intenção → operação
| Intenção do usuário |
Operação |
| "adiciona/salva/ingere isso" (arquivo, link, artigo, paper) |
/pwdev-brain:ingest <fonte> |
| "o que minha wiki/brain diz/sabe sobre X", perguntas sobre o acervo |
/pwdev-brain:query <pergunta> |
| "gera um relatório/comparativo a partir do meu brain" |
/pwdev-brain:query (artefato em wiki/output/) |
| "valida/limpa/organiza a wiki", "tem link quebrado?" |
/pwdev-brain:lint |
| "cria/configura meu segundo cérebro" |
/pwdev-brain:init |
| "como está meu brain?" |
/pwdev-brain:status |
Mapa de intenção → tool MCP (leitura rápida)
Path A — MCP brain conectado: para leituras pontuais em conversa
natural, use as tools direto — mais barato em contexto que abrir arquivos:
| Intenção |
Tool |
| Panorama/diagnóstico do brain |
brain_info (caminho, resolved_via, contagens) |
| Ponto de entrada da wiki |
brain_index |
Listar conceitos (filtro por type/status/tag) |
brain_list |
| Buscar por termo (ranqueado, com snippets) |
brain_search |
Ler conceito ou fonte (wiki/…, raw/…) |
brain_get |
| Histórico de mudanças |
brain_log |
Path B — MCP ausente ou falhando: não simule resultado de tool. Siga o
fluxo filesystem dos comandos (index → conceitos → Grep dirigido). Falha
com brain válido é quase sempre sessão iniciada antes do plugin/env var
ou node ausente — aponte /pwdev-brain:status e reinício de sessão.
O MCP é somente-leitura: nenhuma tool grava. Toda escrita passa pelos
comandos (ingest com discussão, incorporação aprovada no query, fix
aprovado no lint), sempre via filesystem.
Processo
- Identifique a intenção pela tabela e execute a operação correspondente —
os fluxos completos vivem nos comandos, não aqui.
- Pedido ambíguo entre ingerir e perguntar ("olha esse artigo") →
pergunte: guardar na wiki ou só discutir agora?
- Em qualquer resposta baseada na wiki, cite os conceitos consultados;
conhecimento do modelo é sinalizado como externo ao brain.
Formato de saída
O de cada comando (## Saída de cada um). Respostas de consulta terminam
com o rodapé Conceitos consultados / Incorporado / Artefato.
Anti-padrões
- Gravar conceito direto em
wiki/ sem passar pelo fluxo de ingest — pula a
discussão e quebra índice, log e citações.
- Editar ou apagar qualquer coisa em
raw/ — é a fonte de verdade imutável.
- Responder query sem citar, ou misturar conhecimento do modelo com
conteúdo da wiki sem sinalizar.
- Criar artefato solto em
wiki/ ou na raiz de wiki/output/ em vez da
pasta YYYY-MM-DD-<slug>/.
- Inventar metadados de frontmatter para "completar" uma página.
- Tentar gravar via MCP — o servidor
brain é somente-leitura por design;
ingestão continua no fluxo com discussão.
Limites
- Não gerencia notas do Obsidian — ver
pwdev-obsidian.
- Não planeja features nem escreve specs — ver
pwdev-feat / pwdev-code.
- Não cria PRDs — ver
pwdev-prd.
- Não executa
Attested Computation — o OKF descreve a computação, não a
roda.
- As operações vivem nos comandos; esta skill roteia e guarda o princípio.
Relacionadas
- Comandos:
/pwdev-brain:init · :status · :ingest · :query · :lint
- Referências:
references/okf-spec.md · references/lint-rules.md
1---2name: brain3description: >4 Segundo cérebro persistente em Markdown — LLM Wiki no padrão Karpathy5 mantida como bundle Open Knowledge Format v0.2, com fontes imutáveis em6 raw/ e conceitos citados em wiki/. Use quando o usuário disser "segundo7 cérebro", "second brain", "adiciona isso ao meu brain", "salva na minha8 wiki", "ingere esse artigo/PDF/link", "o que minha wiki diz sobre",9 "o que meu brain sabe sobre", "consulta meu conhecimento", "lint da10 wiki", ou pedir para acumular conhecimento de fontes de forma durável.11 NÃO use para notas do Obsidian (pwdev-obsidian), planejamento de12 features (pwdev-feat) nem PRDs (pwdev-prd).13metadata:14 source: https://skillmd.com/skills/pwdev-solucoes/brain15 version: 1.0.016---1718# Brain — segundo cérebro em LLM Wiki (OKF v0.2)1920## Papel21Roteador e guardião do formato: leva cada intenção do usuário para a22operação certa e impede escrita fora do fluxo.2324## Princípio central25**Nada entra na wiki sem discussão e sem citação.** A wiki acumula valor26porque cada afirmação tem fonte e cada mudança passa pelo usuário — gravar27direto "para agilizar" destrói exatamente o que a torna confiável.2829## Antes de começar301. Leia `.claude/pwdev-brain-context.md` — idioma, caminho do brain,31 identidade e preferências.322. Sem contexto ou sem `<brain>/wiki/index.md` válido → pare e aponte33 `/pwdev-brain:init`.343. Idioma conforme `${CLAUDE_PLUGIN_ROOT}/references/language.md`; formato35 conforme `${CLAUDE_PLUGIN_ROOT}/references/okf-spec.md`.3637## Framework — intenção → operação3839| Intenção do usuário | Operação |40|---|---|41| "adiciona/salva/ingere isso" (arquivo, link, artigo, paper) | `/pwdev-brain:ingest <fonte>` |42| "o que minha wiki/brain diz/sabe sobre X", perguntas sobre o acervo | `/pwdev-brain:query <pergunta>` |43| "gera um relatório/comparativo a partir do meu brain" | `/pwdev-brain:query` (artefato em `wiki/output/`) |44| "valida/limpa/organiza a wiki", "tem link quebrado?" | `/pwdev-brain:lint` |45| "cria/configura meu segundo cérebro" | `/pwdev-brain:init` |46| "como está meu brain?" | `/pwdev-brain:status` |4748## Mapa de intenção → tool MCP (leitura rápida)4950**Path A — MCP `brain` conectado**: para leituras pontuais em conversa51natural, use as tools direto — mais barato em contexto que abrir arquivos:5253| Intenção | Tool |54|---|---|55| Panorama/diagnóstico do brain | `brain_info` (caminho, `resolved_via`, contagens) |56| Ponto de entrada da wiki | `brain_index` |57| Listar conceitos (filtro por `type`/`status`/`tag`) | `brain_list` |58| Buscar por termo (ranqueado, com snippets) | `brain_search` |59| Ler conceito ou fonte (`wiki/…`, `raw/…`) | `brain_get` |60| Histórico de mudanças | `brain_log` |6162**Path B — MCP ausente ou falhando**: não simule resultado de tool. Siga o63fluxo filesystem dos comandos (index → conceitos → Grep dirigido). Falha64com brain válido é quase sempre **sessão iniciada antes do plugin/env var**65ou **node ausente** — aponte `/pwdev-brain:status` e reinício de sessão.6667O MCP é **somente-leitura**: nenhuma tool grava. Toda escrita passa pelos68comandos (ingest com discussão, incorporação aprovada no query, fix69aprovado no lint), sempre via filesystem.7071## Processo721. Identifique a intenção pela tabela e execute a operação correspondente —73 os fluxos completos vivem nos comandos, não aqui.742. Pedido ambíguo entre ingerir e perguntar ("olha esse artigo") →75 pergunte: guardar na wiki ou só discutir agora?763. Em qualquer resposta baseada na wiki, cite os conceitos consultados;77 conhecimento do modelo é sinalizado como externo ao brain.7879## Formato de saída80O de cada comando (`## Saída` de cada um). Respostas de consulta terminam81com o rodapé `Conceitos consultados / Incorporado / Artefato`.8283## Anti-padrões84- Gravar conceito direto em `wiki/` sem passar pelo fluxo de ingest — pula a85 discussão e quebra índice, log e citações.86- Editar ou apagar qualquer coisa em `raw/` — é a fonte de verdade imutável.87- Responder query sem citar, ou misturar conhecimento do modelo com88 conteúdo da wiki sem sinalizar.89- Criar artefato solto em `wiki/` ou na raiz de `wiki/output/` em vez da90 pasta `YYYY-MM-DD-<slug>/`.91- Inventar metadados de frontmatter para "completar" uma página.92- Tentar gravar via MCP — o servidor `brain` é somente-leitura por design;93 ingestão continua no fluxo com discussão.9495## Limites96- Não gerencia notas do Obsidian — ver `pwdev-obsidian`.97- Não planeja features nem escreve specs — ver `pwdev-feat` / `pwdev-code`.98- Não cria PRDs — ver `pwdev-prd`.99- Não executa `Attested Computation` — o OKF descreve a computação, não a100 roda.101- As operações vivem nos comandos; esta skill roteia e guarda o princípio.102103## Relacionadas104- Comandos: `/pwdev-brain:init` · `:status` · `:ingest` · `:query` · `:lint`105- Referências: `references/okf-spec.md` · `references/lint-rules.md`