Skip to content

About

Skill que converte Linear, Jira, Notion, ClickUp e Drive em um second brain para LLM (wiki em Markdown no GitHub), baseada no LLM Wiki de Karpathy

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

second-brain

Skill para o Claude Code (e agentes compatíveis) que converte arquivos de Linear, Jira, Notion, ClickUp, Google Drive e outras fontes em um second brain para LLM: uma wiki em Markdown, organizada e versionada no GitHub.

A ideia original

Andrej Karpathy descreve o padrão no gist LLM Wiki. Em vez de o LLM recuperar trechos de documentos a cada pergunta (RAG), ele constrói e mantém uma wiki persistente entre você e as fontes. O conhecimento é compilado uma vez e mantido atualizado.

Três camadas, como no gist:

Camada Pasta Regra
Fontes brutas raw/ Imutáveis. O agente lê, nunca edita
Wiki wiki/ O agente escreve e mantém, você revisa
Schema AGENTS.md Diz ao agente como ler, escrever e manter

Três operações: ingest (fonte nova atualiza 5 a 15 páginas), query (pergunta com citação; boa resposta vira página) e lint (contradições, órfãs, lacunas). Dois arquivos de navegação: index.md (catálogo) e log.md (cronologia).

Esta skill é uma implementação do padrão, com decisões que o gist deixa em aberto: estrutura de pastas, frontmatter tipado, wikilinks por slug, MEMORY.md para conflitos e pendências, decisões append-only e lint automático.

O que a skill faz

  1. Pergunta o essencial: fontes, quem usa, destino no GitHub, regras de escrita.
  2. Mostra a estrutura de diretório proposta e a função de cada pasta.
  3. Cria o scaffold (scripts/scaffold.py).
  4. Ingere as fontes em raw/, com um guia por ferramenta.
  5. Compila a wiki/: projetos, playbooks, conceitos, decisões, pessoas. Não cria uma página por ticket.
  6. Gera index.md, log.md e MEMORY.md.
  7. Valida com tools/lint_brain.py.
  8. Versiona no GitHub, privado por padrão, e só publica com confirmação.

Estrutura gerada

brain/
├── README.md  AGENTS.md  index.md  MEMORY.md  log.md
├── wiki/
│   ├── concepts/  rules/  playbooks/  projects/
│   ├── decisions/  people/  sources/
├── raw/
│   └── linear/ jira/ notion/ clickup/ drive/ artigos/ transcricoes/ pdfs/ assets/
├── .agent/retrieval-config.yaml
├── tools/lint_brain.py
└── .github/workflows/lint.yml

A função de cada pasta está em references/estrutura-diretorio.md.

Instalação

Clone dentro da pasta de skills do projeto (ou de ~/.claude/skills/ para uso global):

git clone https://github.com/punkmetrics/second-brain-skill .claude/skills/second-brain

Depois peça ao Claude, por exemplo: "converta meus exports do Jira e do Notion em um second brain no GitHub".

Conteúdo do repositório

Caminho Para quê
SKILL.md Fluxo completo da skill
references/estrutura-diretorio.md Árvore proposta e a ideia de cada pasta
references/formato-de-pagina.md Frontmatter, tipos, nomenclatura, wikilinks
references/fontes/ Guia por fonte: Linear, Jira, Notion, ClickUp, Drive, genérico
references/github.md Repositório, commits, revisão, CI, privacidade
assets/templates/ Arquivos-base do scaffold
assets/page-templates/ Um modelo por tipo de página
scripts/scaffold.py Cria a estrutura (só biblioteca padrão do Python 3)
scripts/lint_brain.py Valida frontmatter, links, órfãs, segredos e imutabilidade de raw/

Privacidade

O brain concentra conhecimento interno. Mantenha o repositório do seu brain privado, faça a triagem de dados sensíveis antes de ingerir e nunca commite segredos. O lint varre padrões comuns de token e chave, mas não substitui a revisão humana.

Licença

MIT. Veja LICENSE.

Mantido pela PunkMetrics.

About

Skill que converte Linear, Jira, Notion, ClickUp e Drive em um second brain para LLM (wiki em Markdown no GitHub), baseada no LLM Wiki de Karpathy

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages