Este guia ensina a montar do zero um conjunto de arquivos que dão ao Claude Code um "cérebro" sobre você (ou sobre um projeto) e a conectar o Playwright para que o Claude possa navegar num navegador real. É a mesma estrutura usada na pasta WhoAmI/ deste repositório.

Parte 1 — Arquivos .md de contexto (a "fonte da verdade")

O que é

Um arquivo .md de contexto é um documento em texto puro que guarda fatos estáveis sobre um assunto: quem você é, seu histórico profissional, as regras de um projeto, decisões de arquitetura, etc. Ele não contém instruções de comportamento — é só informação de referência que o Claude vai ler e reutilizar sem precisar "inventar" ou lembrar de memória.

Exemplos deste repositório:

Como criar o seu

1. Crie uma pasta para agrupar o contexto de um tema. Ex.: WhoAmI/, Projeto-X/, Cliente-Y/.
2. Um arquivo por tipo de fato. Não misture "quem eu sou" com "meu histórico". Separe por responsabilidade, do mesmo jeito que se separa código.
3. Escreva em tópicos e tabelas, não em parágrafos longos. O Claude extrai melhor de listas.
4. Preserve números. "reduzi o tempo de deploy em 90%", "3x mais throughput", "cobertura de 50% → 80%". Métricas são o sinal mais forte.
5. Feche com um rodapé dizendo qual é o papel do arquivo e com quem ele se relaciona. Use [[NomeDoArquivo]] para linkar contextos irmãos.

Esqueleto mínimo

### <Título do tema> — <seu nome / projeto>

**<Subtítulo com o resumo de uma linha>**

#### Resumo
<2 a 4 frases com o essencial>

#### <Seção de fatos: Experiência / Requisitos / Decisões>
- <fato objetivo 1 — com data absoluta, ex.: "Jan 2025 – Jul 2026">
- <fato objetivo 2 — com número sempre que possível>

#### <Outra seção: Habilidades / Stack / Restrições>
- <lista curta>

---
*Fonte da verdade para <para que serve>. Ver [[OutroArquivo]] para <o que ele cobre>.*

Regras de ouro

• Datas absolutas, nunca "mês passado" ou "ano que vem".
• Nada de duplicar o que o repositório já registra (estrutura de código, histórico do git). Contexto .md é para o que não dá para derivar do código.
• Um fato, um lugar. Se mudou de cargo, atualize o .md fonte primeiro e só depois os lugares que consomem ele (currículo, LinkedIn, etc.).