Editores markdown foram feitos para notas, não para agentes

12 de Setembro de 2026 · ThreadGrab

Existe uma categoria de arquivo que não existia cinco anos atrás e que hoje fica no centro de como o software é escrito. Não é código-fonte. É a pilha de markdown que diz a um coding agent o que fazer: CLAUDE.md, AGENTS.md, regras, skills, sub-agentes, comandos. Em 2 de setembro de 2026, Kunihiro Ishiguro publicou um post chamado "Markdown Editors Weren't Built for Coding Agents, So I Made One" e lançou o editor que ele queria: o Marginal.

O post abre com um problema que eu reconheço por uma direção completamente diferente. O autor conta que, depois de usar coding agents intensamente, principalmente o Claude Code, acabou com "uma quantidade esmagadora de documentos markdown, às vezes mais de 100, espalhados por subdiretórios diferentes", e tinha "perdido completamente a noção de quais skills estão disponíveis, quais sub-agentes estão instalados e quais regras estão em vigor".

Eu escrevo sobre arquivar conteúdo social, então meu interesse aqui não é o editor. É a classe de arquivo. Esses arquivos de instrução são um registro do que foi dito a uma IA, e quase ninguém guarda cópias datadas deles.

O que o Marginal realmente faz diferente

A maioria dos editores markdown trata um arquivo como arquivo. Você entrega uma pasta e ele mostra o que há lá dentro. O Marginal inverte isso: você diz qual coding agent usa, e ele encontra os arquivos que aquele agente realmente lê, onde quer que estejam.

Essa distinção é o produto inteiro. A reclamação do autor é precisa - alguns arquivos de instrução são locais do projeto, outros são compartilhados por uma conta em uma máquina específica, e cada agente procura em caminhos diferentes. Uma visão genérica de pasta não responde "quais regras estão em vigor agora", porque a resposta está espalhada por pelo menos três locais e depende de qual agente está rodando.

Os agentes suportados e os arquivos que cada um lê

Segundo o manual do Marginal, o agente é escolhido em Configurações, dentro de IA, com o Claude Code como padrão. O manual lista todas as pastas que cada agente lê:

Leia essa tabela duas vezes e algo óbvio aparece. Quatro dos seis agentes leem um arquivo chamado AGENTS.md, e todos leem de lugares diferentes. O mesmo nome de arquivo significa coisas diferentes dependendo de quem olha. Se você mantém instruções para mais de um agente, está mantendo documentos sobrepostos sem nenhum índice comum - exatamente o estado que o autor descreve.

Os outros recursos, resumidamente

• Listagem de arquivos em subdiretórios - opcional, para quando seu markdown está espalhado por pastas aninhadas. Filtre por trecho do caminho, incluindo / para casar com um diretório.
• Duas interfaces de IA - selecione o texto e pressione ⌘K para uma reescrita em linha que aparece como um diff que você aceita ou rejeita como um único passo de desfazer; ou pressione ⌘J para um painel de terminal e rode claude ou codex ali mesmo.
• Recarga ao vivo quando o agente escreve - quando o agente escreve em um arquivo que você tem aberto, o Marginal percebe e oferece recarregar, e uma skill recém-salva aparece na barra lateral sem reabrir a pasta.
• Leitura e exportação - clique duas vezes em um arquivo no Finder para abri-lo em modo de leitura, e exporte como PDF ou HTML.
• Modos de edição Emacs e Vim com mapeamento de teclas personalizado, e dez temas embutidos em cinco pares claro/escuro (Marginal, GitHub, Solarized, Zenburn, Dracula), mais temas em JSON do usuário carregados sem reiniciar.

Um detalhe de implementação vale ser citado, porque explica a qualidade da exportação: um único motor markdown em Rust alimenta o editor, a pré-visualização, a exportação em PDF e o contexto entregue à IA. Um analisador, quatro consumidores.

O modelo de preço é mais amigável que o da maioria

O Marginal tem um plano, duas formas de pagar: US$ 10 por mês, ou US$ 96 por ano, o que dá US$ 8 por mês, com um teste de 14 dias que não pede cartão. Mas a divisão entre gratuito e pago é a parte interessante, porque ela é traçada na escrita, não na leitura:

A consequência declarada de uma assinatura vencida é somente leitura, e não bloqueio: "Seus arquivos são markdown puro no seu disco, e nunca ficam reféns." A IA roda com sua própria chave da Anthropic, OpenAI, Google, xAI ou Alibaba Cloud, guardada no chaveiro do sistema e não nos servidores do fornecedor, e o site afirma claramente que a assinatura nunca bloqueia a IA.

Por que arquivos de instrução de agente merecem cópias datadas

Aqui está a parte que se conecta ao que eu realmente faço. O Marginal responde "o que está em vigor agora". Ele não responde "o que estava em vigor quando isso aconteceu", e essas são perguntas diferentes.

Considere o que um CLAUDE.md ou um AGENTS.md contém depois de alguns meses de uso real. Ele acumula regras que o agente deve seguir, convenções de projeto, padrões proibidos, deploys que você não pode tocar. É editado constantemente, muitas vezes pelo próprio agente. Daqui a seis meses, quando você estiver lendo um commit, um arquivo de plano ou uma auditoria de segurança que o agente produziu, o arquivo de instrução como ele estava naquele momento é a metade que falta do registro. A versão que você tem hoje é um documento diferente que por acaso compartilha um nome de arquivo.

Este é o mesmo modo de falha de arquivar uma thread pelo seu handle. Os dois são casos em que a coisa que você salvou ainda resolve, mas resolve para outra coisa. O Notula cobre a direção da leitura - garantir que seu markdown esteja limpo o suficiente para um agente usar. O Marginal cobre a direção da edição. Nenhum dos dois cobre a direção histórica, que não é produto de ninguém e é problema de todos.

Capturar o estado do agente junto com o conteúdo que ele produziu

Você não precisa de uma ferramenta especial para isso, o que é a boa notícia. Os arquivos de instrução são markdown puro no seu disco, então uma cópia datada é uma cópia. O trabalho é decidir o que fotografar e onde colocar.

Um script mínimo de snapshot - coloque-o ao lado do projeto e rode sempre que o agente fizer algo que você talvez precise explicar depois:

#!/usr/bin/env bash
# Snapshot the coding-agent instruction files for a project.
set -euo pipefail

PROJECT_DIR="${1:-.}"
STAMP="$(date -u +%Y-%m-%dT%H-%M-%SZ)"
OUT="agent-state/${STAMP}"

mkdir -p "$OUT"

# Instruction files this project may use, across the agents Marginal lists.
for f in CLAUDE.md AGENTS.md QWEN.md GEMINI.md; do
  if [ -f "$PROJECT_DIR/$f" ]; then
    cp "$PROJECT_DIR/$f" "$OUT/$f"
  fi
done

# Cursor rules, if present.
if [ -d "$PROJECT_DIR/.cursor/rules" ]; then
  cp -R "$PROJECT_DIR/.cursor/rules" "$OUT/cursor-rules"
fi

# Skills and commands, if present.
for d in .claude/skills .claude/commands .codex/prompts; do
  if [ -d "$PROJECT_DIR/$d" ]; then
    mkdir -p "$OUT/$(dirname "$d")"
    cp -R "$PROJECT_DIR/$d" "$OUT/$d"
  fi
done

echo "Snapshot written to $OUT"

Rode com o diretório do projeto como argumento e você obtém uma pasta com data e hora contendo exatamente as instruções em vigor naquele momento. Faça commit dos snapshots, ou mantenha-os fora do git se as regras contiverem algo sensível - de qualquer forma, eles existem como arquivos, e não como a lembrança de que você pretendia verificar.

Nomes de arquivo são a parte fácil. A outra metade de um arquivo é saber o que o conteúdo capturado realmente dizia, e para isso o padrão de proveniência importa:

# Record the instruction version alongside what the agent produced.
# Keep this in the same directory as the artifact it explains.
cat > artifact.provenance.txt <<EOF
agent: claude-code
instruction_files: CLAUDE.md AGENTS.md
captured_at: $(date -u +%Y-%m-%dT%H:%M:%SZ)
source_url: https://github.com/org/repo/commit/abc1234
snapshot_dir: agent-state/$(date -u +%Y-%m-%dT%H-%M-%SZ)
note: rules in effect at generation time, not today's rules
EOF

O objetivo do segundo arquivo é a última linha. Qualquer arquivo que guarde um artefato sem as regras que o moldaram será mal interpretado depois - não porque alguém foi descuidado, mas porque as regras mudaram silenciosamente e nada registrou a mudança.

A pilha, de ponta a ponta

Coloque as peças em ordem e aparece um padrão muito mais antigo do que os coding agents:

1. Descoberta - encontre os arquivos que realmente estão em vigor. O Marginal, no editor.
2. Snapshot - copie-os, com data, para que a versão sobreviva à próxima edição.
3. Captura - guarde o artefato que o agente produziu junto das regras que o produziram.
4. Re-verificação - antes de citar algo de meses atrás, consulte o snapshot, não o arquivo atual.

O passo 1 agora é um produto que alguém vende por US$ 10 por mês, o que mostra que o problema é real e comum. Os passos 2 a 4 continuam manuais, e são eles que decidem se o seu arquivo será utilizável daqui a um ano.

Onde o ThreadGrab entra

O ThreadGrab captura conteúdo público do X, Bluesky e LinkedIn em Markdown, com data e hora e a URL de origem, para que o que você salvou mantenha a identidade que tinha quando você salvou. É um arquivador de conteúdo social, não uma ferramenta de desenvolvimento, e não lê o seu repositório. O que ele compartilha com o problema do Marginal é o princípio: a cópia que você controla, marcada com quando você a fez, é a única versão que ainda significa o que significava.

Se você mantém instruções de agente, a pergunta não é se você vai precisar da versão antiga. É se você vai tê-la.

Perguntas frequentes

Última verificação: 12 de Setembro de 2026. Fontes primárias: Marginal, "Markdown Editors Weren't Built for Coding Agents, So I Made One", de Kunihiro Ishiguro (2 de setembro de 2026), em marginal.md/blog.html; o manual do Marginal em marginal.md/docs, incluindo a página de coding agents e a tabela de arquivos de instrução por agente; e a página de preços em marginal.md/pricing.html, para o plano de US$ 10 mensais / US$ 96 anuais, os termos do teste de 14 dias, a divisão entre recursos gratuitos e pagos e os provedores de chave de API suportados. O envio do post no Hacker News (3 de setembro de 2026) é citado pelo baixo volume de discussão. Preço e lista de agentes suportados são os detalhes com maior chance de mudar; confirme-os nas páginas do fornecedor antes de comprar.