Uma transcrição pode trazer a migração do site, a produção do blog e uma falha de desempenho na mesma gravação. Se eu solicitar “transforme isso em artigos”, o agente consegue produzir três textos parecidos, repetir a abertura e distribuir o mesmo argumento entre títulos diferentes.

No blog da Promovaweb, eu uso Markdown para manter cada artigo como um arquivo revisável. O formato facilita a comparação das alterações, mas não escolhe o assunto nem garante uma voz humana. O trabalho editorial começa ao separar a pergunta de cada peça.

Direto ao ponto

Markdown funciona bem no meu fluxo porque Codex e Claude conseguem ler o conteúdo junto da implementação do site. Eu preservo a transcrição como fonte, crio uma base editorial e mantenho cada post num arquivo próprio. Antes de publicar, comparo a redação com a fonte e leio o conjunto para encontrar repetições entre artigos.

Os metadados ligam o texto à data, à imagem, ao assunto e a outros conteúdos. Informações compartilhadas podem ficar em arquivos estruturados. Uma fonte canônica reduz versões divergentes quando o editor compara o resultado final com o valor registrado nela.

A gravação não define a arquitetura do artigo

Uma fala segue o tempo da apresentação. O artigo precisa seguir a pergunta do leitor. Se a gravação começa pela migração do WordPress, passa pelo Markdown e termina no PageSpeed, reproduzir essa ordem em três posts gera recontos da mesma história.

Eu separo os assuntos antes da redação. A rotina de edição orienta a comparação entre Astro e WordPress, enquanto fontes e arquivos conduzem o texto sobre Markdown. A nota mobile de 40 abre a análise de desempenho. Cada peça usa somente os fatos necessários à própria tese.

Eu mantenho a transcrição original intacta e corrijo a grafia numa etapa separada. Ao encontrar uma opinião em primeira pessoa, volto ao trecho de origem. Se a experiência apareceu apenas no rascunho do agente, retiro a atribuição antes de continuar o artigo.

Esse cuidado também evita três introduções com “eu fiz, depois aconteceu”. A primeira pessoa entra onde existe uso ou preferência confirmada. O restante fala diretamente com você e explica o mecanismo que pode ser conferido.

O Markdown expõe o que mudou

Um artigo em Markdown combina prosa, headings, links e metadados. Quando o agente altera um parágrafo, a comparação dos arquivos mostra exatamente quais palavras saíram e quais entraram. Eu consigo recusar uma frase sem procurar a mudança num editor visual inteiro.

Essa transparência não resolve uma redação fraca. Um arquivo pode passar no Markdownlint e continuar cheio de frases simétricas, enumerações e conclusões genéricas. O lint encontra problemas de marcação. A leitura editorial encontra ritmo mecânico, tese repetida e voz distante.

Na terceira leitura do arquivo, eu sigo para a página renderizada. Ali, encontro link para rota ausente, heading grande no celular ou capa incompatível com o assunto. A publicação exige a conferência do Markdown e do resultado visual.

O artigo da Promovaweb sobre Astro e WordPress após a migração mostra como essa edição por arquivos alterou meu trabalho. A escolha continua pessoal: se o painel visual atende melhor redatores e editores, WordPress permanece válido.

Metadados não devem aparecer como parágrafo público

No frontmatter, o artigo registra título, descrição, data, imagem, tag e relações. O site usa esses campos para construir páginas, listagens e associações. Você recebe o resultado sem precisar conhecer o processo interno de catalogação.

O agente precisa conhecer o schema antes de editar. Uma data no formato errado pode retirar o post da coleção. Uma tag fora da taxonomia pode quebrar a navegação. Uma imagem inexistente pode deixar o compartilhamento sem capa.

Depois da alteração, valide o arquivo e consulte a página gerada. Eu também comparo o corpo sincronizado com o mestre editorial para impedir que duas versões do mesmo artigo evoluam separadamente.

Arquivos JSON entram quando várias páginas consultam a mesma informação estruturada. Um preço, um destino ou uma lista de ferramentas não deve ser atualizado manualmente em cinco lugares se o site já possui uma origem própria para esse conteúdo.

Uma correção mostra se a fonte é realmente única

Escolha uma informação compartilhada e altere-a no lugar canônico. Execute a geração local e abra as páginas consumidoras. Todas devem apresentar o novo valor, sem que o texto público revele nomes de arquivos ou instruções internas.

Se uma página continua com o valor antigo, descubra se ela possui conteúdo duplicado ou se o processo deixou de ler a fonte. Corrigir somente a página mascara a divergência e prepara outra inconsistência na atualização seguinte.

O Git preserva o histórico dessa mudança. A mensagem registra o motivo, e a comparação dos arquivos mostra o valor anterior e o novo. Para recuperar uma alteração, volte ao commit correspondente e confira a fonte atual antes de reaplicá-la.

O agente precisa receber limites editoriais

Um comando curto como “escreva três artigos” deixa escolhas demais implícitas. Eu forneço a base correspondente, as diretrizes do canal, a pergunta principal e os links permitidos. No Vibe Coding, especificação, revisão e teste continuam sob sua responsabilidade. Para uma revisão, também informo quais arquivos podem ser alterados e quais fontes devem permanecer intactas.

Depois, leio os artigos lado a lado. Procuro aberturas equivalentes, headings com a mesma construção e fechamentos que apenas trocam o nome da oferta. Essa comparação de conjunto encontra slop que a leitura isolada aceita com facilidade.

O artigo sobre a nota mobile no site Astro mostra outro papel do agente: trabalhar a partir de um relatório técnico e devolver uma alteração que ainda precisa ser testada. Em ambos os casos, o arquivo aproxima fonte, mudança e conferência.

No Plano IA Makers, você aprende a especificar e revisar sistemas construídos com agentes. Se o seu site já mistura publicação, automações e componentes difíceis de localizar, o Diagnóstico de Produto e Arquitetura da Dev Side Studio documenta a jornada atual antes de ampliar a implementação.

Meu blog em Markdown funciona porque o arquivo participa de um processo maior: fonte preservada, assunto delimitado, comparação das alterações e página conferida. Sem essas etapas, o formato apenas torna o texto mecânico mais fácil de versionar.