🧠 brain-skills

Skills de wiki para projetos com IA — compatíveis com Claude Code, Cursor e Antigravity.

Instala 4 skills que transformam qualquer projeto em um sistema de conhecimento vivo: documentação profunda, cross-referenciada, mantida automaticamente pela IA a cada sessão.

Instalação

No terminal, dentro da pasta do seu projeto:

npx brain-skills

O instalador detecta automaticamente quais ambientes existem no projeto e pergunta onde instalar:

🧠 brain-skills installer

  Ambientes encontrados neste projeto:

  [1] Claude Code     .claude/skills/      ✓ detectado
  [2] Cursor          .cursor/skills/      ✓ detectado
  [3] Antigravity     skills/              - não encontrado

  Quais instalar? [números separados por vírgula, ENTER = 1,2]

As 5 skills

/brain-init — Projeto novo

Cria a estrutura completa do Brain wiki do zero.

Você descreve o projeto (nome, stack, entidades, decisões já tomadas) e a skill monta:

• Estrutura de pastas Brain/
• Brain/CLAUDE.md — manual operacional adaptado ao projeto
• Páginas seed para cada entidade e decisão informada
• Índices de navegação por pasta

Quando usar: projeto que ainda não tem nenhuma documentação.

/brain-onboard — Projeto existente

Varre o projeto, extrai conhecimento e constrói o Brain progressivamente.

• Lê package.json, README, docs existentes, estrutura de pastas
• Consulta o banco de dados (se MCP configurado)
• Pergunta o que não consegue inferir: regras de negócio, semântica das entidades, fonte da verdade, termos banidos/preferidos
• Cria páginas profundas com cross-links inline (estilo Wikipedia)

Quando usar: projeto já rolando que não tem Brain ainda.

/brain-update — Após desenvolver algo

Documenta features, decisões e mudanças no Brain wiki.

Você descreve o que acabou de acontecer. A skill:

• Identifica o que criar vs atualizar
• Cria ADRs para decisões tomadas
• Valida schema do banco via MCP antes de documentar
• Adiciona cross-links inline em todas as páginas afetadas
• Atualiza índices e log

Quando usar: sempre que terminar uma feature, tomar uma decisão técnica ou mudar algo relevante.

/brain-audit — Varredura autônoma

Roda sozinho e entrega um relatório de saúde do wiki.

Verifica:

• Schema drift — colunas do banco vs o que está documentado (via MCP)
• Links quebrados — cross-links que apontam para arquivos inexistentes
• Paths de código desatualizados — arquivos mencionados no wiki que não existem mais
• Staleness — páginas críticas sem atualização há 30+ dias
• Páginas órfãs — sem nenhum inbound link
• Índices desincronizados — _index.md desatualizado vs arquivos reais

Corrige automaticamente o que é seguro (contagens, índices). Reporta o resto para decisão humana.

Quando usar: periodicamente, ou antes de uma sessão importante.

/brain-fix — Correção de erro no wiki

Localiza e corrige erros semânticos, terminológicos ou conceituais propagados pelo wiki — com segurança.

Você escolhe o tipo de erro (terminologia, definição de entidade, conceito, dado factual, relação entre entidades), descreve o que está errado e o correto, e a skill:

• Greppa todas as ocorrências no wiki com variações (singular, plural, maiúsculas)
• Classifica cada uma: ❌ corrigir / ✅ manter (uso legítimo) / ⚠️ revisar
• Mostra o plano antes de executar qualquer mudança
• Corrige, atualiza memória Claude e registra no log

Quando usar: descobriu que uma definição, termo ou dado está errado em múltiplos lugares.

O que é o Brain wiki?

Uma estrutura de conhecimento vivo dentro do projeto, mantida pela IA:

Brain/
├── CLAUDE.md          ← manual operacional (carregado em toda sessão)
├── raw/               ← fontes imutáveis (docs, specs, exports)
└── wiki/
    ├── index.md       ← mapa navegável
    ├── log.md         ← histórico de operações
    ├── overview.md    ← síntese executiva
    ├── apps/          ← sistemas e aplicações
    ├── entities/      ← entidades de domínio
    ├── concepts/      ← padrões e mecanismos
    ├── decisions/     ← ADRs (decisões arquiteturais)
    └── strategy/      ← métricas, posicionamento, roadmap

Cada subpasta tem um _index.md de navegação. A IA carrega só o que precisa — em vez de ler tudo, navega pelo índice e pula direto para a página certa.

Fluxo recomendado

Projeto novo         →  /brain-init
Projeto existente    →  /brain-onboard
Após cada feature    →  /brain-update
Semanalmente         →  /brain-audit
Erro descoberto      →  /brain-fix

Requisitos

• Node.js 16+
• Um dos ambientes: Claude Code, Cursor, ou Antigravity

Publicado por

Rene Samajauskas — @renesamajauskas