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 orientar o agente a separar esses assuntos em artigos Markdown, ele pode 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

O Markdown funciona bem no meu fluxo porque o Codex e o Claude conseguem ler o conteúdo junto da implementação do site. Para trabalhar a partir de uma transcrição, preserve a fonte recebida e prepare uma base para os artigos. Antes de publicar, compare a redação com a fonte e leia o conjunto para encontrar repetições.

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 você compara o resultado final com o valor registrado nela.

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

Uma fala acompanha o tempo da apresentação, enquanto o artigo precisa seguir a pergunta do leitor. Se a gravação percorre a migração do WordPress, o Markdown e o PageSpeed, repetir essa ordem em três posts recria a mesma história sem respeitar o foco de cada texto.

Numa série sobre a migração de um site, a comparação entre plataformas pode acompanhar a rotina de edição. Outro artigo pode examinar os arquivos usados pelo agente, enquanto a análise de desempenho parte de uma medição no navegador. Ao preparar os artigos, vincule cada fato à pergunta da peça para não repetir o mesmo argumento sob outro título.

Mantenha a transcrição original intacta e corrija a grafia numa cópia separada. Ao encontrar uma opinião em primeira pessoa, volte ao trecho de origem. Se a experiência apareceu apenas no rascunho do agente, retire 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 apenas quando 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. Você pode recusar aquela frase e conservar as alterações corretas no restante do arquivo.

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.

Compare também o arquivo com a página renderizada. Ali você encontra 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, o WordPress permanece válido.

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

No frontmatter, o artigo registra os metadados usados pelo site para construir páginas e relacionar os conteúdos. Você recebe o resultado sem precisar conhecer o processo interno de catalogação.

Antes de editar, o agente precisa conhecer o schema para não retirar o post da coleção com uma data incompatível, quebrar a navegação com uma tag fora da taxonomia ou deixar a página sem capa ao referenciar uma imagem inexistente.

Depois da alteração, valide o arquivo e consulte a página gerada. Compare o corpo sincronizado com o mestre editorial para impedir que duas versões do mesmo artigo evoluam separadamente. No deploy, confira também se o endereço público serve a versão recém-compilada.

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. Na infraestrutura para Vibe Coding, frontend, banco e armazenamento têm funções próprias. Um JSON compilado com o site não registra um novo cadastro enviado pelo visitante.

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

Imagine um preço exibido na página de um plano e no artigo que o apresenta. Altere o valor na fonte usada pelas duas páginas, gere o site local e abra cada endereço. Se o preço foi copiado para dentro do artigo, será preciso atualizar essa passagem também: um arquivo JSON não corrige prosa que deixou de consultá-lo.

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, consulte o commit correspondente e confira a fonte atual antes de reaplicá-la. O ambiente escolhido para hospedar o primeiro projeto precisa permitir gerar e publicar essa correção.

O agente precisa receber limites editoriais

Um comando curto como “escreva três artigos” deixa escolhas demais implícitas. Forneça 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, indique também quais arquivos podem ser alterados e quais fontes devem permanecer intactas.

Depois, leia os artigos lado a lado. Procure aberturas equivalentes, headings com a mesma construção e fechamentos que apenas trocam o nome da oferta. Essa comparação de conjunto permite encontrar repetições que a leitura isolada deixa passar.

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.