Trabalhando com as ferramentas DOCX: criar, limpar e comparar documentos Word no Rakenne

A maioria dos entregáveis para clientes ainda sai do seu sistema como documentos Word — contratos, relatórios ISO, pacotes de SoA, relatórios de auditoria, PRDs. A skill DOCX tools do Rakenne permite que você e o agente trabalhem diretamente com esses arquivos: redigir novos .docx, limpar alterações controladas, corrigir problemas estruturais, converter formatos e gerar redlines para revisão jurídica.

Este tutorial mostra como:

• Configurar um projeto para fluxos em Word
• Redigir novos .docx prontos para o cliente
• Limpar alterações controladas e comentários
• Validar e reparar documentos problemáticos
• Converter entre DOCX, PDF, HTML e ODT
• Comparar versões e gerar arquivos Word redlined
• Gerar imagens de páginas a partir de PDFs para QA visual

Você não precisa saber como o DOCX funciona por dentro. Basta descrever o resultado desejado; o agente usa as ferramentas certas nos bastidores.

Quando usar as ferramentas DOCX (e quando não usar)

Use a skill DOCX tools quando:

• O entregável final precisa ser enviado como .docx ou como PDF gerado a partir de .docx
• Você recebe arquivos Word muito editados de clientes e precisa de versões finais limpas
• O Word começa a reclamar que um documento está corrompido ou abre em modo de reparo
• Jurídico ou compliance precisa de uma comparação redline entre duas versões de Word
• Você quer imagens página a página de um PDF para checagem visual ou para slides

Prefira skills em Markdown quando:

• Você ainda está desenhando o workflow ou a estrutura do documento
• O entregável é um artefato interno que nunca sai do Rakenne
• Você não se importa com formatação em Word — apenas com o conteúdo de texto

Na prática, o padrão mais comum é:

Preparando o projeto para trabalhar com DOCX

Antes de pedir para o agente tocar arquivos Word, deixe o projeto preparado.

1. Crie ou escolha o projeto certo

Crie um projeto que reflita o engajamento ou o entregável, por exemplo:

• Cliente X — ISO 27001 SoA
• Acme — MSA e DPA
• Board — Q4 Security Report

Isso mantém os arquivos Word relacionados junto com suas fontes em Markdown e anotações.

2. Faça upload dos arquivos DOCX e PDF

Adicione quaisquer arquivos existentes com que você queira trabalhar:

• Contratos de origem: contracts/msa-original.docx
• Edições do cliente: contracts/msa-client-edits.docx
• Políticas em Word: policies/info-sec-policy.docx
• PDFs para imagens de páginas: reports/soc2-report.pdf

Dê nomes claros aos arquivos. Sufixos como _original, _client-edits, _final e _redline tornam a conversa com o agente muito mais fácil.

3. Habilite a skill DOCX tools

Na biblioteca de skills, adicione a skill DOCX tools ao projeto. Depois de habilitada, o agente passa a:

• Saber que ferramentas específicas para DOCX estão disponíveis
• Propor fluxos DOCX quando detectar arquivos .docx ou .doc
• Salvar documentos novos ou transformados no workspace para download

Agora você está pronto para conduzir fluxos de Word por meio de prompts em linguagem natural.

Workflow 1 — Redigir um documento Word polido do zero

Use este fluxo quando quiser que o agente crie um novo .docx que você vai abrir no Word, editar e enviar a clientes.

Objetivo

Produzir um relatório ou contrato em Word, pronto para o cliente, a partir de um briefing de alto nível.

Como executar

1. Forneça ao agente um briefing claro:
   • Quem é o público (board, auditores, jurídico do cliente, reguladores)
   • Qual é o resultado esperado (SoA, relatório de auditoria interna, MSA, PRD etc.)
   • Quais são as restrições (tamanho, nível de formalidade, jurisdição, idioma)
2. Descreva a estrutura desejada:
   • “Resumo executivo, contexto, metodologia, achados, recomendações”
   • “Seções numeradas, anexos para evidências e uma página de assinatura”
3. Peça explicitamente um arquivo Word e caminho:
   • “Gere um .docx e salve como output/iso27001-internal-audit-report.docx.”
4. Deixe o agente redigir, peça ajustes se necessário e confirme quando o .docx estiver pronto para download.

Prompts de exemplo

• “Precisamos de um relatório de auditoria interna ISO 27001 pronto para o cliente para a CloudSync, 10–15 páginas, voltado para auditores. Use seções para escopo, metodologia, achados e recomendações e salve o resultado em output/iso27001-internal-audit-report.docx.”
• “Redija um MSA profissional para um contrato SaaS B2B com a Acme, sob lei brasileira, em inglês. Inclua seções para escopo, níveis de serviço, proteção de dados, limitação de responsabilidade e rescisão. Salve o arquivo Word como contracts/msa-acme-draft.docx.”

Workflow 2 — Limpar alterações controladas e comentários

Contratos e políticas do mundo real muitas vezes circulam entre times com o controle de alterações ativado. As ferramentas DOCX ajudam a ir de um arquivo barulhento a uma versão final limpa, sem perder contexto.

Objetivo

Transformar um arquivo Word cheio de alterações em:

• Uma visão de texto legível para você revisar no Rakenne
• Uma versão final limpa com todas as alterações aceitas
• Uma versão comentada opcional com suas notas de revisão

Como executar

1. Comece pelo arquivo editado:
   • “Trabalhe com contracts/msa-client-edits.docx.”
2. Peça um resumo amigável para revisão:
   • “Extraia o texto como se todas as alterações tivessem sido aceitas e mostre em Markdown.”
3. Quando estiver confortável com o texto, peça uma versão Word final:
   • “Agora crie um novo .docx com todas as alterações aceitas e salve como contracts/msa-client-final.docx.”
4. Opcionalmente, peça ao agente para adicionar comentários:
   • “Crie uma cópia separada com comentários sempre que o cliente mudar cláusulas de limitação de responsabilidade ou indenização e salve como contracts/msa-client-review-comments.docx.”

Prompts de exemplo

• “O arquivo contracts/nda-client-edits.docx está cheio de redlines. Primeiro, mostre uma visão em Markdown do texto final como se todas as alterações tivessem sido aceitas. Depois gere um Word limpo com todas as alterações aceitas salvo como contracts/nda-client-final.docx.”
• “Revise contracts/msa-client-edits.docx do nosso ponto de vista. Adicione comentários no Word ao lado de qualquer cláusula que enfraqueça nossos direitos de PI ou aumente nossa responsabilidade e salve a versão comentada como contracts/msa-client-risk-review.docx.”

Workflow 3 — Validar e reparar arquivos DOCX problemáticos

Às vezes o Word abre um arquivo em modo de reparo, mostra avisos de conteúdo inválido ou se comporta de forma instável. As ferramentas DOCX ajudam a diagnosticar e corrigir muitos desses problemas antes de enviar documentos a clientes ou reguladores.

Objetivo

Verificar se um .docx é estruturalmente saudável, corrigir problemas comuns e preservar um original seguro.

Como executar

1. Diga qual arquivo está com problema:
   • “reports/sox-report-2025.docx abre em modo de reparo e às vezes trava o Word.”
2. Peça uma verificação estrutural:
   • “Valide a estrutura deste DOCX, corrija o que for seguro e salve uma cópia limpa como reports/sox-report-2025-clean.docx.”
3. Solicite um resumo em linguagem simples:
   • “Explique o que estava errado e o que você corrigiu, em termos que um auditor não técnico entenderia.”

Prompts de exemplo

• “O Word aponta conteúdo inválido ao abrir output/annual-report-2025.docx. Valide e repare o arquivo se possível, depois salve uma versão corrigida como output/annual-report-2025-clean.docx e resuma as mudanças.”
• “Antes de enviarmos policies/info-sec-policy.docx ao cliente, rode uma validação estrutural e corrija problemas comuns. Salve a versão validada como policies/info-sec-policy-validated.docx e confirme que ela deve abrir sem erros no Word.”

Workflow 4 — Converter entre DOCX, PDF, HTML e ODT

Muitos trabalhos terminam com “Pode mandar em PDF?” ou “Precisamos disso em .docx, não .doc.” As ferramentas DOCX encapsulam essas conversões em fluxos repetíveis.

Objetivo

Mover documentos entre formatos preservando ao máximo a estrutura e a formatação.

Conversões comuns

• .doc → .docx para contratos legados
• .docx → pdf para aprovação e assinatura
• .docx → html para intranet ou sites de documentação
• .odt ↔ .docx para clientes que usam LibreOffice

Como executar

1. Aponte para o arquivo de entrada:
   • “Use contracts/master-agreement.doc como entrada.”
2. Especifique formato e caminho de saída:
   • “Converta para um documento Word moderno e salve em contracts/master-agreement.docx.”
3. Para PDF ou HTML, peça checagens adicionais:
   • “Gere uma versão PDF como contracts/master-agreement.pdf e confira rapidamente se títulos e tabelas estão corretos nas primeiras páginas.”

Prompts de exemplo

• “Converta output/iso27001-soa.docx em PDF salvo como output/iso27001-soa.pdf para enviarmos aos auditores.”
• “Pegue output/board-pack-q4.docx e converta para HTML para nossa wiki interna, salvo como output/board-pack-q4.html. Preserve ao máximo cabeçalhos e estrutura de tabelas.”

Workflow 5 — Comparar versões e gerar um DOCX redlined

Times jurídico e de compliance muitas vezes querem ver exatamente o que mudou entre duas versões de um documento. As ferramentas DOCX podem gerar um terceiro arquivo com alterações controladas, pronto para revisão no Word.

Objetivo

Produzir um .docx redlined que compare uma versão “original” e uma “modificada”.

Como executar

1. Identifique as duas versões:
   • “contracts/msa-v2-internal.docx é nossa base; contracts/msa-v3-client.docx inclui as edições do cliente.”
2. Peça um redline:
   • “Gere um Word redlined mostrando todas as diferenças entre esses dois arquivos e salve como contracts/msa-v2-vs-v3-redline.docx.”
3. Abra o resultado no Word para revisar inserções, exclusões e movimentações marcadas.

Prompts de exemplo

• “Compare policies/privacy-policy-v1.docx com policies/privacy-policy-v2-client.docx e produza um documento Word redlined salvo como policies/privacy-policy-redline-client.docx.”
• “Crie um redline entre contracts/sow-internal.docx e contracts/sow-client-edits.docx, adequado para revisão do nosso time jurídico, salvo como contracts/sow-redline-client-edits.docx.”

Workflow 6 — Transformar páginas de PDF em imagens

Às vezes você precisa de imagens de cada página em vez de um PDF único: para slides, QA visual ou para embutir miniaturas em outro documento.

Objetivo

Converter um PDF em uma imagem por página, na resolução desejada.

Como executar

1. Aponte para o PDF de origem:
   • “Trabalhe com reports/security-architecture.pdf.”
2. Especifique pasta de saída e resolução:
   • “Gere uma imagem PNG por página em cerca de 200 DPI na pasta reports/security-architecture-images/.”
3. O agente vai:
   • Criar a pasta se necessário
   • Salvar arquivos como page-001.png, page-002.png e assim por diante

Prompts de exemplo

• “De slides/isms-overview.pdf, gere imagens PNG para cada página a 200 DPI em slides/isms-overview-images/.”
• “Transforme output/soc2-report.pdf em imagens JPEG nomeadas soc2-report-page-001.jpg etc., para que eu possa revisar rapidamente cada página em forma de galeria.”

Modelos de prompt de exemplo

Você pode copiar, colar e adaptar estes modelos:

Novo relatório em Word

“Precisamos de um relatório pronto para o cliente sobre [tema] para [cliente], com cerca de [tamanho] páginas, voltado para [público]. Use as seções [lista de seções] e salve o resultado como output/\[slug].docx. Mantenha o tom [tom].”

Finalizar um contrato redlined

“O arquivo contracts/\[nome]-client-edits.docx contém alterações controladas. Mostre o texto final como se todas as alterações tivessem sido aceitas em Markdown e depois gere um .docx limpo com todas as alterações aceitas salvo como contracts/\[nome]-final.docx.”

Redline entre duas versões

“Crie um documento Word redlined comparando \[caminho-original].docx e \[caminho-modificado].docx e salve como \[caminho-redline].docx para o time jurídico revisar as diferenças.”

Health check antes de enviar

“Antes de enviarmos output/\[entregavel].docx ao cliente, valide a estrutura, corrija problemas comuns e salve uma cópia validada como output/\[entregavel]-validated.docx. Avise se ainda restar algo arriscado do ponto de vista de integridade do documento.”

Limitações e boas práticas

Algumas observações práticas para deixar os fluxos com DOCX mais suaves:

• Arquivos precisam viver no workspace do projeto
  Se o agente disser que não encontrou um caminho, confira se você subiu o arquivo e se o nome da pasta está correto.

• Evite sobrescrever originais
  Por padrão, o agente grava novos arquivos (normalmente com sufixos -clean, -final ou -redline), mas ainda é uma boa prática reforçar: “Não sobrescreva o original; salve em um novo caminho.”

• Espere pequenas variações de formatação em conversões
  Ao converter entre formatos, a estrutura principal deve ser preservada, mas espaçamento e layout podem mudar. Planeje uma revisão visual rápida para documentos que vão para o cliente.

• Use nomes de arquivos significativos
  Codifique versão e papel no nome: -original, -client-edits, -our-edits, -final, -redline. Isso reduz atrito com o agente e com o time.

• Combine workflows em Markdown com DOCX
  Em engajamentos longos, um bom padrão é: desenhar e validar a estrutura em skills Markdown, depois usar as ferramentas DOCX para a última milha de formatação, comparação e entrega.

Com esses padrões, as ferramentas DOCX se tornam o “motor de última milha” que transforma seus workflows estruturados no Rakenne em documentos Word que clientes, auditores e conselhos de administração realmente leem.