CLAUDE.md e AGENTS.mdlidos, editados e revistos no seu Mac.

Estes ficheiros dizem ao Claude Code e ao Codex como trabalhar no seu projeto. O DotMD mostra-os como páginas, guarda todas as versões e pode juntar as linhas que fazem o seu agente enviar-lhe as especificações para revisão.

macOS 14 ou posterior. Ler é grátis; editar e rever são um pagamento único.

Resposta rápida

CLAUDE.md e AGENTS.md são ficheiros Markdown simples, por isso o DotMD abre-os como qualquer .md: formatados, com um índice e todas as versões guardadas. Em Settings → MCP → Agent rules, Add to Claude Code ou Add to Codex coloca as regras de revisão do DotMD em ~/.claude/CLAUDE.md ou ~/.codex/AGENTS.md, para o agente lhe enviar cada especificação e esperar pelos seus comentários.

Abrir e editar CLAUDE.md e AGENTS.md

Prima ⌘O e escolha a pasta do projeto: o CLAUDE.md e o AGENTS.md aparecem na barra lateral com o resto do Markdown e abrem-se como páginas com um índice. A barra lateral ignora as pastas ocultas, por isso, para ~/.claude/CLAUDE.md, prima ⌘O, depois ⇧⌘G no painel e escreva o caminho.

Para alterar um ficheiro, prima ⌘E. A página passa a texto que é formatado enquanto escreve, e cada alteração fica logo guardada no ficheiro. Editar faz parte do DotMD Editor.

Quando o agente edita o ficheiro

Quando o Claude Code, o Codex ou o git alteram um ficheiro do seu espaço de trabalho, a página aberta recarrega sozinha e um aviso mostra Changed on disk com as linhas acrescentadas e removidas. Show Changes abre o histórico de versões; com o DotMD Reviewer, o texto antigo surge a vermelho e o novo a verde.

Se o ficheiro mudar enquanto escreve nele, o DotMD pergunta Load from Disk ou Keep My Version e guarda o seu texto no histórico de qualquer das formas.

Para verificar as correções de um agente uma a uma, veja rever as alterações de um agente.

Junte as regras de revisão do DotMD com um clique

Os modelos dão mais peso aos seus próprios CLAUDE.md e AGENTS.md do que ao que uma ferramenta diz de si mesma, por isso o DotMD pode pôr neles as linhas que fazem um agente usar a revisão. Abra Settings → MCP, expanda Agent rules e prima Add to Claude Code ou Add to Codex. As regras vão para ~/.claude/CLAUDE.md ou ~/.codex/AGENTS.md:

<!-- dotmd:begin (added by DotMD; DotMD can update or remove this block) -->
## DotMD
- When you create or substantially change a spec, plan, design doc or any Markdown document for the user, your LAST step is to call the DotMD MCP tool `request_review` with the file's path and wait for the answer. While it says the user is still reviewing, call it again. Never end your turn by just saying the file is ready.
- Fix each review comment, call `resolve_review_comments`, then `request_review` again until the user approves.
- When you review a file for the user, leave your remarks with `add_review_comments` and finish with `complete_review`.
<!-- dotmd:end -->

O DotMD altera apenas a parte entre as suas duas linhas de marca e guarda uma cópia do ficheiro anterior à primeira alteração, terminada em .dotmd-backup. Update substitui o bloco quando um DotMD mais recente tem melhores regras, e Remove retira-o.

Para o ficheiro próprio de um projeto, ou para o Cursor e outros agentes, prima Copy no mesmo sítio e cole as linhas onde o agente lê as suas regras. Os guias do Claude Code e do Codex mostram um conjunto mais curto que também pode usar.

O que o agente faz com elas

Com as regras no lugar, o agente envia-lhe cada especificação, plano ou documento de conceção que escreve (request_review), espera enquanto comenta, corrige cada comentário e envia de novo até aprovar. As revisões com agentes por MCP fazem parte do DotMD Reviewer.

Perguntas sobre CLAUDE.md e AGENTS.md

O que são CLAUDE.md e AGENTS.md?

Ficheiros Markdown com instruções para um agente de programação. O Claude Code lê o CLAUDE.md e o Codex lê o AGENTS.md, no seu projeto ou, para todos os projetos, em ~/.claude e ~/.codex.

O DotMD altera o meu CLAUDE.md por si só?

Não. O DotMD só escreve no ficheiro quando prime Add ou Update em Settings → MCP → Agent rules, e apenas entre as suas duas linhas de marca. Antes, guarda uma cópia do ficheiro como .dotmd-backup.

Posso editar o CLAUDE.md no DotMD enquanto o agente trabalha?

Sim. Quando um agente altera o ficheiro, a página recarrega. Se estava a escrever, o DotMD pergunta se deve carregar o ficheiro do disco ou manter a sua versão.

Preciso do DotMD Reviewer para editar estes ficheiros?

Não. Abri-los é grátis e editar faz parte do DotMD Editor ($14.99 uma vez). As revisões com agentes por MCP, que as regras pedem ao agente que use, fazem parte do DotMD Reviewer ($39.99 uma vez).

Mais perguntas