michael-eng-ai

Brains — Documentation skill for Claude Code

Documentation community

Segundo cerebro por projeto para qualquer IA: Markdown em grafo, lido por Claude Code, Codex, Cursor; sync por Git; macOS, Linux e Windows sem admin.

How to install Brains

This entry records only its repository, not the path inside it, so there is no exact command to give. Open michael-eng-ai/brains and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Brains does

Segundo cerebro por projeto para qualquer IA: Markdown em grafo, lido por Claude Code, Codex, Cursor; sync por Git; macOS, Linux e Windows sem admin.

Alternatives in Documentation

会话管理（Session Manager）需求文档（PRD / Markdown） — 目标：对 Codex / Claude Code 的本地会话记录进行可视化管理，并提供“一键复制 / 一键终端恢复”能力 31.7k ★
Qmd Skill — A Codex/Clawd skill definition for qmd (Quick Markdown Search) 673 ★
Wiki Sync — Sync Claude Code (and Codex CLI) session transcripts into the llmwiki, then ingest the new ones into wiki/ 375 ★

README

brains: segundo cerebro por projeto para qualquer IA

**English summary.** `brains` is a portable, file-based "second brain" per project: plain Markdown organized as a graph (wikilinks, atomic notes, a map of content), read by Claude Code, Codex, Cursor, Copilot, Gemini or any AI that can open files, and carried between machines with Git. No server, no database, no symlinks, no admin rights. Works on macOS, Linux and Windows. Documentation is in Brazilian Portuguese; scripts and the skill are in English.

Conhecimento persistente de cada projeto, em Markdown, organizado como um grafo, lido por qualquer IA e levado entre maquinas por Git. Sem servidor, sem banco, sem symlink, sem direitos de administrador. Funciona em macOS, Linux e Windows.

Por que existe

Toda IA de codigo comeca a sessao do zero. O que ela aprendeu sobre o seu projeto (decisoes, comandos que funcionam, erros que se repetem, quem decide o que) fica preso na ferramenta e na maquina onde aconteceu. Este kit tira esse conhecimento de dentro das ferramentas e coloca em arquivos que qualquer IA le, em qualquer computador, e que voce mesmo consegue abrir e editar.

Como funciona

~/brains/                      <- este repositorio
  _template/                   <- estrutura copiada para cada projeto novo
  _skills/brain/SKILL.md       <- skill instalada em ~/.claude/skills e ~/.codex/skills
  _global/*.block.md           <- bloco adicionado em ~/.claude/CLAUDE.md e ~/.codex/AGENTS.md
  _stubs/                      <- arquivos locais escritos dentro de cada projeto
  install.sh | install.ps1     <- instala a integracao na maquina (uma vez por maquina)
  link.sh    | link.ps1        <- liga um repositorio ao seu cerebro (uma vez por projeto por maquina)
  unlink.sh  | unlink.ps1      <- desfaz o link (remove so os arquivos locais do projeto)
  graph.sh   | graph.ps1       <- lint do grafo (links quebrados, orfaos) e gera catalog.md
  sync.sh    | sync.ps1        <- commit + pull -