Conceitos pro time

Claude Code tem alguns conceitos que, se você entender, usa 10x melhor. Essa página cobre os 4 principais.

1. CLAUDE.md — contexto por repo

Arquivo CLAUDE.md no root de um repositório é lido automaticamente pelo Claude Code toda vez que você abre o repo.

Serve pra dizer pro Claude: “quando estiver trabalhando aqui, lembra disso”.

Cada repo da holding já tem um CLAUDE.md criado, com:

• Descrição do repo
• Time envolvido
• Sub-projetos esperados
• Stack técnica
• Contexto do grupo (regras, recursos)

Como usar: não precisa lembrar dele. Claude Code lê automaticamente. Você só precisa respeitar — se o CLAUDE.md diz “nunca commit credencial”, Claude Code vai te lembrar se você tentar.

Sub-projetos também têm CLAUDE.md: dentro de 1bmg/outbound/, por exemplo, pode haver um CLAUDE.md específico daquele sub-projeto. Claude Code lê tanto o global quanto o específico.

2. Memory — contexto entre sessões

Claude Code lembra coisas entre conversas através de arquivos de memória.

Como funciona:

• Memórias ficam em ~/.claude/projects/<path-do-projeto>/memory/*.md
• Cada arquivo é um “fato permanente” sobre você, o projeto, ou como trabalhar
• MEMORY.md no root da pasta de memory é o índice (links pros outros arquivos)

O que Claude salva sozinho:

• Preferências suas (“gosta de respostas curtas”)
• Decisões importantes do projeto
• Feedback (“da próxima vez evita X”)
• Convenções do time

O que você pode fazer:

• Ler: cat ~/.claude/projects/<projeto>/memory/MEMORY.md vê o que Claude sabe
• Editar: abre no VS Code, muda manualmente se algo tá errado
• Pedir pra salvar: “Claude, salva na memória que a gente sempre usa Python 3.12 pra scripts”
• Pedir pra esquecer: “Claude, remove a entrada X da memória”

Pro time eMotion: a memory já tem o contexto do grupo (via holding_ai_ops_context.md) em todos os projetos relevantes. Quando você abrir Claude Code em qualquer empresa, ele já sabe do time.

3. Skills — mini-ferramentas que você invoca

Skills são módulos que dão habilidades específicas pro Claude Code. Cada skill é chamada com /<nome-da-skill>.

Exemplos de skills úteis:

Skill	Pra que	Exemplo
/commit	Commita com mensagem bem escrita	Depois de editar arquivos, digita /commit
/commit-push-pr	Commita + push + abre PR (fluxo completo)	Ideal pra fechar tarefa
/review	Revisa um PR	/review 1 revisa PR #1
/security-review	Análise de segurança	Antes de mergear código sensível
/fewer-permission-prompts	Configura permissões do Claude	Evita perguntas repetitivas

Pra ver todas as skills disponíveis: digita / no prompt do Claude Code e ele lista.

Pra propor nova skill pra holding: abre Issue no repo operations com proposta.

4. Plugins — funcionalidades expandidas

Plugins são extensões que adicionam skills + comandos + agentes. Já vem instalados alguns úteis:

• commit-commands — skills de git (commit, push, PR)
• pr-review-toolkit — ferramentas pra revisar PR
• feature-dev — fluxo guiado pra desenvolver feature
• skill-creator — criar nova skill (se você quiser contribuir)

Pra ver plugins: /plugins no prompt.

Como tudo se encaixa

Cenário real — Silas trabalhando em Oinc:

1. Silas abre VS Code na pasta oinc-filmes/
2. Roda claude
3. Claude lê CLAUDE.md do repo (contexto da Oinc) + memory (contexto do grupo)
4. Silas pede: “Cria um template de briefing pra cliente Y, seguindo o padrão da Oinc”
5. Claude usa contexto + escreve template em templates/briefing-<cliente-Y>.md
6. Silas revisa, pede ajuste, Claude ajusta
7. Silas digita /commit-push-pr
8. Claude cria branch, commita com mensagem descritiva, push, abre PR
9. Fred recebe notificação, revisa, aprova, merge

Durante tudo isso, Silas nunca teve que explicar quem é ele, o que é Oinc, como funciona o fluxo de PR. Isso tudo já tá no CLAUDE.md + memory.

Dica de ouro

Se Claude Code não sabe algo sobre o projeto, é sinal de que falta contexto no CLAUDE.md ou memory. Adiciona e ele aprende pra sempre.

Próximos

→ Workflow com Git — “Claude, commita isso”