Memória do Claude com Obsidian (a smart-memory do meu time)
Monte a memória do seu projeto com /team-os, abra no Obsidian e veja o grafo. Passo a passo, avisos e o pacote de 95 agentes do repositório.
O que é
Memória do Claude com Obsidian (a smart-memory do meu time)
Neste tutorial você coloca a skill /team-os no seu projeto, deixa o Claude Code ler o código e montar a smart-memory, e abre essa pasta como cofre no Obsidian para navegar pelo grafo de notas.
É o jeito como o time do João trabalha: toda sessão começa lendo a mesma memória, e o Claude anota nela o que decide. O princípio é ler pouco e certo, não guardar tudo.
O repositório team-os, público e com licença MIT, também traz um pacote de 95 agentes e 108 skills. A página mostra a memória e aponta para o tutorial de instalar o time. Ela avisa o que a skill muda no projeto e o que ainda não foi verificado.
Cofre no Obsidian
Abra docs/smart-memory como cofre e navegue pelo grafo de notas.
Memória que o Claude monta
O /team-os lê o projeto e gera INDEX, visão geral, stack e convenções.
Pacote de 95 agentes
O mesmo repositório traz os agentes e skills do time, com licença MIT.
Avisos do que muda
Flag experimental, cache e hooks que a skill grava no projeto.
Nível: intermediário · Tempo estimado: ~20 min na primeira vez (inclui reabrir o Claude Code uma vez)
O que ainda não foi verificado de ponta a ponta: o fluxo completo dentro de uma sessão real do Claude Code, o tempo total (o vídeo diz 30 segundos; só o script de leitura do projeto foi cronometrado, em menos de 1 segundo) e se o Claude lê a memória sozinho em toda sessão nova. Também não prometemos que ele nunca mais esquece: a memória ajuda quando o Claude segue o protocolo. O comando de instalação do passo 1 é o nosso caminho sugerido; o README do repositório não traz uma instalação só da memória.
Pré-requisitos
- Claude Code instalado, com assinatura Claude ou conta Console. Instalação oficial no macOS, Linux ou WSL: curl -fsSL https://claude.ai/install.sh | bash (ou brew install --cask claude-code).
- Git e um terminal. Windows: use WSL ou veja as opções na documentação oficial.
- Obsidian instalado (grátis, obsidian.md/download).
- Um projeto com código: a skill lê o que existe. Em projeto vazio, a memória sai quase toda em branco.
Conceitos-chave
- 01
Smart-memory
Uma pasta, docs/smart-memory, com arquivos de texto no formato Obsidian (metadados no topo e links entre notas com colchetes duplos, como [[project/overview]]). Fica versionada junto com o projeto.
- 02
Ler pouco e certo
Memória que guarda tudo vira gaveta. O protocolo manda ler o INDEX.md, depois o resumo da área e, no máximo, 3 notas por tarefa. Fato novo substitui o antigo, em vez de acumular versões.
- 03
/team-os e o pacote de agentes
O repositório team-os (público, licença MIT) traz a skill /team-os e um pacote de 95 agentes e 108 skills em 10 squads, segundo o README. Nesta página usamos a skill de memória; os agentes ficam para o tutorial de instalar um time.
- 04
Memória automática do Claude Code é outra coisa
O Claude Code também salva notas sozinho, mas em uma pasta na sua máquina (~/.claude/projects), que não vai para o Git. A smart-memory fica dentro do projeto e viaja com ele.
Passo a passo
- 01
Coloque a skill e os hooks no seu projeto
Clone o repositório e copie a skill team-os e a pasta de hooks para dentro do seu projeto. Copie os hooks também: a skill grava no .claude/settings.json hooks que apontam para esses arquivos.
git clone --depth 1 https://github.com/joaoguirunas/team-os.git /tmp/team-os cd /caminho/do/seu-projeto mkdir -p .claude/skills .claude/hooks cp -R /tmp/team-os/.claude/skills/team-os .claude/skills/ cp -R /tmp/team-os/.claude/hooks/. .claude/hooks/ - 02
Abra o Claude Code na pasta do projeto
Precisa ser a raiz do projeto, a mesma onde está a pasta .claude.
cd /caminho/do/seu-projeto claude - 03
Rode /team-os pela primeira vez
Na primeira execução ele liga o recurso experimental Agent Teams no seu ~/.claude/settings.json e para, pedindo uma sessão nova. É o comportamento esperado.
/team-os - 04
Feche, reabra e rode de novo
Saia do Claude Code, abra de novo na mesma pasta e repita o comando. Agora ele lê o projeto, monta o resumo e pede para você confirmar ou corrigir. Confirme com atenção: é o que vira a memória.
claude /team-os - 05
Confira a pasta criada
Esperado: INDEX.md, e as pastas project, stories, agents, decisions, _inbox e _archive. Campos que o código não revela ficam marcados como TODO.
ls docs/smart-memory - 06
Abra a pasta como cofre no Obsidian
No Obsidian, escolha Open folder as vault (em português: Abrir pasta como um cofre), selecione docs/smart-memory dentro do seu projeto e confirme.
Obsidian -> Open folder as vault -> docs/smart-memory -> Open - 07
Veja o grafo
Abra a visualização de grafo (Open graph view, na barra lateral) para ver as notas e os links entre elas. Em projeto pequeno o grafo começa com poucos nós e cresce com o uso.
- 08
Prove que uma sessão nova usa a memória
Abra uma sessão nova do Claude Code e rode o prompt de prova abaixo. Se ele resumir o projeto a partir do INDEX.md, a memória está sendo lida.
O que a skill muda no seu projeto, antes de aceitar: grava no .claude/settings.json a flag CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1, um cache de subagentes de 1 hora (a documentação diz que cache de 1 hora tem custo maior) e hooks que bloqueiam criar git worktree, ler a pasta _archive e abrir pastas inteiras da memória. Agent Teams é experimental e usa bem mais tokens que uma sessão comum. Se não quiser os bloqueios, remova os hooks do settings.json do projeto.
O Obsidian cria uma pasta .obsidian dentro de docs/smart-memory. Se o projeto usa Git, adicione docs/smart-memory/.obsidian/ ao .gitignore. O Obsidian é só o visualizador: a memória funciona sem ele.
Prompts prontos
Prompt: Montar a memória do projeto (comando da skill)
/team-os
Prompt: Provar que a memória é lida numa sessão nova
Antes de qualquer coisa, leia docs/smart-memory/INDEX.md e me diga em 5 linhas o que você entendeu do projeto, quais áreas existem e quais stories estão ativas. Não abra nenhuma outra nota.
Prompt: Preencher os campos TODO da memória
Leia docs/smart-memory/project/overview.md e me faça as perguntas que faltam para eu preencher os campos TODO de propósito de negócio e responsabilidade de cada módulo. Uma pergunta de cada vez.
Prompt: Registrar uma decisão na memória
Acabamos de decidir: [descreva a decisão em uma ou duas frases]. Atualize a smart-memory no arquivo certo, resuma a decisão e o motivo, e me mostre o que mudou antes de salvar.
Prompt: Buscar na memória sem abrir nota por nota
bash "$CLAUDE_PROJECT_DIR/.claude/skills/team-os/scripts/sm-find.sh" "autenticação"
Prompt: Compactar a memória de tempos em tempos
/team-os *compact
No prompt de decisão, troque o trecho entre colchetes pela decisão real. No de busca, troque autenticação pelo termo que você procura.
Erros comuns
- /team-os parou e pediu sessão nova: é o primeiro uso, esperado. Feche o Claude Code, abra de novo e rode /team-os outra vez.
- /team-os não aparece: a skill precisa estar em .claude/skills/team-os/SKILL.md na raiz do projeto onde você abriu o claude. Confira com ls .claude/skills.
- Mensagens de hook falhando por arquivo inexistente: faltou copiar a pasta .claude/hooks (passo 1).
- Não consigo criar worktree ou branch nova depois: o hook block-worktree bloqueia de propósito. Remova o hook do settings.json se não quiser.
- A memória está cheia de TODO: é normal na primeira rodada. Use o prompt de preencher os TODO.
- O grafo mostra poucos nós: o projeto é pequeno ou tem poucas notas. Ele cresce com o uso.
- O Obsidian perguntou se confia no autor do cofre: a smart-memory não traz plugins, pode ficar no modo restrito.
Checklist final
- A skill team-os e a pasta de hooks estão copiadas no meu projeto
- Rodei /team-os duas vezes, com a sessão reaberta entre elas
- docs/smart-memory/INDEX.md existe e eu confirmei o resumo que o Claude mostrou
- Abri docs/smart-memory como cofre no Obsidian e vejo o grafo
- Numa sessão nova, o prompt de prova resumiu o projeto a partir do INDEX.md
- Li o aviso do que a skill muda no settings.json
Próximos passos
- Aprofunde a smart-memory, o Discovery e a manutenção dos TODO: /open-source/skills/skills-obsidian
- Instale um time de agentes completo a partir do repositório (o pacote de 95 agentes): /open-source/skills/team-os-creator
- Monte o seu primeiro time de agentes: /open-source/skills/primeiro-time-agentes
- Dê regras permanentes ao Claude no CLAUDE.md: /open-source/skills/regras-do-que-o-claude-nao-pode-fazer
Comece agora
Pronto para colocar Memória do Claude com Obsidian (a smart-memory do meu time) para rodar?
Ver o repositório team-os no GitHubPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo