O Guia Completo dos pequenos arquivos Markdown que ensinam à IA suas regras, estilo, fluxo de trabalho e configuração.
Abra um espaço de trabalho de IA sério em 2026 e você notará algo estranho.
O arquivo mais importante não é o código do app.
Não é o prompt.
Geralmente é um arquivo Markdown simples, silenciosamente localizado no projeto.
AGENTS.md.CLAUDE.md.SKILL.md.DESIGN.md.instructions.md.prompt.md.memory.md.
Esses arquivos parecem pequenos. Às vezes, eles têm apenas 30 linhas.
Mas eles decidem como o agente pensa antes de escrever código, editar um documento, projetar uma página, redigir um artigo, executar um fluxo de trabalho ou tocar em seus arquivos.
Esta é a parte que muitas pessoas ainda perdem.
O próximo salto no trabalho com IA não virá da digitação de prompts mais longos. Ele virá de dar à IA um ambiente de trabalho melhor.
Um prompt é uma solicitação.
Um arquivo de instrução é um sistema de trabalho.
Sua IA precisa de uma mesa antes de precisar de uma tarefa
Pense em como você treina um assistente real.
Você não explica a empresa inteira todas as manhãs.
Você lhes dá as regras uma vez.
Como escrevemos.
Como nomeamos arquivos.
Quais ferramentas usamos.
O que nunca deve ser tocado.
O que significa “feito”.
Onde os exemplos ficam.
Como verificar o trabalho antes de enviá-lo de volta.
É exatamente isso que esses arquivos Markdown fazem para agentes de IA.
Eles transformam explicações repetidas em contexto reutilizável.
Em vez de dizer “use pnpm, siga esta estrutura de pastas, evite escrita por IA, use nosso estilo de design, execute testes antes de finalizar” em todo chat, você escreve essas regras uma vez e as mantém onde o agente possa lê-las.
É por isso que o Markdown está se tornando a camada de controle silenciosa para agentes.
Não porque o Markdown seja sofisticado.
Porque ele é simples, legível, controlado por versão e portátil.
Você pode abri-lo.
Sua equipe pode editá-lo.
O agente pode lê-lo.
O Git pode rastreá-lo.
Essa é toda a mágica.
A pilha de instruções
Você não precisa de um arquivo mestre gigante.
Esse é o erro.
Você precisa de camadas.
Cada arquivo deve ter uma função.
Uma configuração ruim coloca tudo isso em um arquivo longo.
Uma boa configuração separa o trabalho.
As regras do projeto ficam em AGENTS.md.
Instruções específicas para o Claude ficam em CLAUDE.md.
Habilidades repetíveis tornam-se SKILL.md.
As regras de design se mudam para DESIGN.md.
A voz de escrita ganha seu próprio arquivo.
É assim que você mantém o agente afiado.
Dentro do guia completo, mostrarei a configuração exata de instruções de IA: AGENTS.md, CLAUDE.md, prompts, o arquivo anti-escrita-IA, etapas do Claude Code, configuração do ChatGPT e como transformar um arquivo Markdown em um sistema de escrita reutilizável, em vez de repetir o mesmo prompt todas as vezes.
Comece com a configuração útil mais simples
Não crie um sistema de instruções completo no primeiro dia.
Comece com isto:
my-project/
├── AGENTS.md
├── CLAUDE.md
├── anti_ai_writing_instructions.md
└── prompts/
└── write-article.prompt.md
Isso é o suficiente para a maioria das pessoas.
O seu AGENTS.md diz ao agente o que é este projeto.
# AGENTS.md
This project is an AI newsletter workflow for writing practical guides, notes, and tutorials.
## Working rules
- Keep writing simple and direct.
- Use short paragraphs.
- Do not use corporate or academic language.
- Ask before changing the main structure.
- Check the final draft against anti_ai_writing_instructions.md.
## Files to read
- For writing voice, read anti_ai_writing_instructions.md.
- For article prompts, check prompts/.
O seu CLAUDE.md diz ao Claude o que deve lembrar-se ao trabalhar dentro desta pasta.
# CLAUDE.md
## Main instruction
Before writing any article, read AGENTS.md and anti_ai_writing_instructions.md.
## Writing style
Use the Opinion AI voice:
simple, practical, human, direct, and useful.
Avoid:
- AI-style openings
- robotic transitions
- fake importance
- generic summaries
- over-polished paragraphs
## Before final answer
Audit the draft once.
Rewrite any sentence that sounds like default AI writing.
Esta configuração é simples, mas já altera o trabalho.
O modelo não está mais adivinhando seu estilo a partir de um prompt.
Ele está lendo suas regras primeiro.
Como usar esses arquivos no Claude Code
Aqui está o processo limpo de A a Z.
- Crie uma pasta para o seu projeto.
mkdir opinion-ai-writing-system
cd opinion-ai-writing-system
- Adicione seus arquivos de instrução.
touch AGENTS.md
touch CLAUDE.md
touch anti_ai_writing_instructions.md
mkdir prompts
touch prompts/write-article.prompt.md
- Abra a pasta no seu editor.
- Cole as regras do seu projeto em
AGENTS.md. - Cole as suas regras específicas do Claude em
CLAUDE.md. - Coloque as regras anti-escrita-por-IA dentro de
anti_ai_writing_instructions.md. - Abra o Claude Code nessa pasta.
claude- Peça ao Claude para confirmar os arquivos.
Read AGENTS.md, CLAUDE.md, and anti_ai_writing_instructions.md.
Tell me what writing rules you will follow in this project.
Do not write the article yet.
- Se o Claude esquecer algo, corrija o arquivo, não apenas o chat.
Esse é o ponto.
O Chat é temporário.
O arquivo é reutilizável.
Baixe o arquivo de instrução prática
Adicionei o arquivo completo anti_ai_writing_instructions.md arquivo abaixo como PDF.
Anti Ai Writing Instructions
314KB ∙ PDF file
O Substack não torna .md o compartilhamento de arquivos muito fácil, então estou fornecendo no formato mais simples aqui.
Use-o de duas maneiras:
Primeiro, você pode carregar o PDF diretamente no Claude ou ChatGPT e pedir ao modelo para segui-lo.
Segundo, se você quiser a versão real em Markdown, copie o texto do PDF, cole-o em um editor de texto simples e salve-o com este nome exato:
anti_ai_writing_instructions.md
Em seguida, coloque-o dentro da sua pasta de projeto ao lado de AGENTS.md ou CLAUDE.md.
O arquivo não é apenas um recurso de leitura. Ele foi feito para ser usado como uma camada de instrução.
Após fazer o download, siga os passos abaixo.
Como usar o arquivo anti-AI-writing no Claude
Para um chat normal do Claude, use o método simples.
- Abra o Claude.
- Inicie um novo chat.
- Faça o upload de
anti_ai_writing_instructions.md. - Cole este prompt:
Read the attached anti_ai_writing_instructions.md file first.
Use it as a strict writing rule for this chat.
Do not write in the default AI voice. Avoid grand openings, fake importance, robotic transitions, generic conclusions, over-polished rhythm, and empty phrases.
Before writing, ask me for the topic, audience, goal, sources, and my angle.
Before giving the final draft, audit your own writing against the file and rewrite anything that sounds AI-generated.
Para Claude Projects ou Claude Skills, torne-o mais permanente.
Se você usa Projetos, faça o upload do arquivo para o conhecimento do projeto e adicione isto às instruções do projeto:
For every writing task, read anti_ai_writing_instructions.md before drafting.
Apply it as a style guardrail.
Se você usa Habilidades, transforme-o em uma pequena habilidade.
anti-ai-writing/
└── SKILL.md
Dentro de SKILL.md:
---
name: anti-ai-writing
description: Detect and rewrite AI-sounding writing. Use when drafting, editing, humanizing, or auditing articles, emails, social posts, notes, and newsletters.
---
# Anti AI Writing
Read anti_ai_writing_instructions.md if available.
Remove:
- generic AI openings
- robotic transitions
- fake importance
- corporate wording
- overused AI phrases
- perfect but lifeless paragraph rhythm
Rewrite with:
- simple language
- short paragraphs
- specific examples
- natural human flow
- clear opinion
A descrição importa muito.
Essa é a linha que o agente lê primeiro ao decidir se deve usar a habilidade.
Se a descrição for fraca, a habilidade pode permanecer inativa.
Como usar no ChatGPT
Use de uma das três maneiras.
A maneira mais rápida:
- Inicie um novo chat.
- Faça upload de
anti_ai_writing_instructions.md. - Cole isto:
Read the uploaded file first.
Apply it as a writing rule for this chat.
When writing for me, avoid AI writing voice and follow the file strictly.
Before final answer, audit and rewrite the draft once.
A melhor maneira:
- Crie um Projeto no ChatGPT.
- Faça o upload de
anti_ai_writing_instructions.mdnos arquivos do projeto. - Adicione isto nas instruções do projeto:
Use anti_ai_writing_instructions.md for every writing task.
My writing style is simple, practical, human, direct, and useful.
Never write in a corporate, academic, or default AI tone.
A forma mais forte:
Crie um GPT ou Skill personalizado para seu fluxo de trabalho de escrita.
Adicione o arquivo como conhecimento.
Em seguida, adicione esta instrução:
Before drafting, check the anti-AI-writing file.
After drafting, run a second pass.
Return only the improved version unless I ask for the audit.
Agora o arquivo não está apenas anexado.
Ele se torna parte do seu sistema de escrita.
A regra para cada arquivo de instrução
Aqui está a regra que sigo agora:
Se a instrução se aplica a todas as tarefas, coloque-a no AGENTS.md ou CLAUDE.md.
Se ele se aplica a uma tarefa repetida, transforme-o em um SKILL.md.
Se ele inicia um fluxo de trabalho comum, transforme-o em um prompt.md.
Se ele controla a aparência da saída, crie um DESIGN.md.
Se ele controla o tom de voz da escrita, mantenha-o separado e anexe-o sempre.
Não faça o agente carregar tudo o tempo todo.
Dê a ele o que ele precisa, quando ele precisar.
Esse é o verdadeiro poder das camadas de instrução.
O pequeno arquivo que muda todo o fluxo de trabalho
É por isso que estou anexando anti_ai_writing_instructions.md com este artigo.
Você pode usá-lo hoje.
Envie para o Claude.
Envie para o ChatGPT.
Coloque-o na sua pasta de projeto.
Transforme isso em uma habilidade.
Mantenha-o ao lado do seu AGENTS.md.
O ponto é simples.
O resultado da sua IA é tão bom quanto o sistema de trabalho ao redor dele.
Prompts melhores ajudam em uma resposta.
Arquivos de instrução melhores ajudam em todas as respostas depois disso.
