Se há um único hábito que muda a relação com a IA, é este: escrever um documento de contexto — muitas vezes chamado claude.md — onde dizes, de uma vez por todas, quem és e como trabalhas.

A partir daí, em vez de explicares tudo em cada conversa, dás-lhe este documento (ou pões-no num Projeto) e a IA já sabe. Simples, e transformador.

O que é, afinal, um claude.md

É só um ficheiro de texto (em Markdown, daí o .md) com as instruções que queres que a IA siga sempre. O nome vem do Claude, mas a ideia serve qualquer assistente: é o teu "manual de quem sou e como trabalho".

Pensa nele como o briefing que darias a um colaborador no primeiro dia — mas que escreves uma vez e reutilizas sempre.

O que pôr lá dentro

Mantém-no curto e útil. As secções que valem a pena:

  • Quem sou — o teu papel, zona, público.
  • Tom e idioma — PT-PT, registo, o que evitar (ex.: nunca "você", nada de clichés).
  • Como trabalho — o teu método, os passos que segues.
  • Regras / limites — o que a IA nunca deve fazer (prometer preços, inventar dados).
  • Formatos — como costumas pedir as coisas (extensão, estrutura).
  • Exemplos — 1-2 textos teus de que gostas, para ela copiar o estilo.

Não precisa de ser perfeito à primeira. Começa simples e melhora à medida que notas o que falta.

Como começar o teu (em 15 minutos)

  1. Abre um documento.
  2. Responde, por escrito, às secções acima — como falarias com um colega novo.
  3. Cola 1-2 exemplos do teu melhor trabalho.
  4. Dá-o à IA no início de uma conversa (ou põe-no num Projeto) e testa.
  5. Ajusta o que faltou.

Pronto — tens contexto persistente, sem código.

Porque é que isto funciona tão bem

Metade da qualidade de uma resposta vem do contexto. Sem ele, a IA adivinha; com o claude.md, ela acerta. É a base sobre a qual assentam as skills e os agentes — todos partem de a IA saber quem és.

Perguntas frequentes (FAQ)

O que é um ficheiro claude.md?

É um documento simples onde escreves, uma vez, quem és, como trabalhas, as tuas regras e formatos. Dás esse contexto à IA e ela segue-o sempre, sem teres de repetir. Escreve-se em linguagem corrente.

Preciso de saber programar para criar um?

Não. É um documento de texto normal. A única "técnica" é ser claro e específico — como num briefing a um colaborador novo.

Onde uso o claude.md?

Podes colá-lo no início de uma conversa ou, melhor, pô-lo nas instruções de um Projeto/espaço para que tudo o que fizeres lá já o herde automaticamente.

O que não devo pôr lá?

Dados pessoais de clientes. O ficheiro descreve como trabalhas, não guarda informação sensível. Mantém-no sobre método e voz, não sobre pessoas.

Com que frequência o devo actualizar?

Sempre que notares que a IA repete um erro ou que falta uma regra. É um documento vivo — melhora-o aos poucos, à medida que aprendes o que funciona.