pwdev-solucoes 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.mdvá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 dewiki/output/em vez da pastaYYYY-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