Crie documentos profissionais em conformidade com normas. Carregue o arquivo de referência correspondente antes de redigir.
Quando usar esta habilidade
Ative para: POPs, especificações técnicas, relatórios, propostas/respostas a RFPs, contratos/políticas, manuais de usuário, whitepapers e qualquer documento que precise ser lido como autoritário para um público internacional ou regulamentado.
Princípios fundamentais
- Padrões sobre gosto. Siga o padrão correto para o tipo de documento e jurisdição (tabela abaixo). Não invente formatação.
- Estrutura antes do texto. Defina seções, numeração e cabeçalhos antes de escrever frases.
- Fonte única da verdade. Glossário único, lista única de siglas, bloco único de versão/proprietário/data.
- Acessibilidade e localidade. Respeite a localidade (LTR/RTL, formatos de data/número, tamanho de papel, unidades de medida) desde o início.
- Sem surpresas. Previsível, escaneável, consistente — não "criativo".
Seleção de padrão
| Tipo de documento | Padrão principal | Referência |
|---|---|---|
| POP / processo | ISO 9001:2015 (cláusula 7.5) | document-types.md |
| Especificação técnica | ISO/IEC/IEEE 29148:2018 | document-types.md |
| Requisitos de software | IEEE 830 / ISO/IEC 25030 | document-types.md |
| Relatório formal | ISO 21500 / ISO 7144 | document-types.md |
| Contrato / política | Jurisdição local + ISO 32000 (PDF/A) | document-types.md |
| Acadêmico / citações | APA 7 / Chicago / ISO 690 | document-types.md |
| Localização | ISO 17100, W3C i18n | internationalization.md |
Fluxo de trabalho
- Classifique o tipo de documento e o público (interno/externo, jurisdição, idioma, RTL/LTR).
- Carregue o(s) arquivo(s) de referência relevante(s) através da tabela acima.
- Construa o esqueleto: bloco de título, versão/proprietário/data, sumário, seções com hierarquia numerada, glossário, referências/apêndices.
- Aplique tipografia e layout conforme typography-layout.md (escala tipográfica, espaçamento, níveis de cabeçalho, tabelas, figuras, legendas).
- Redija seção por seção. Mantenha frases diretas, voz ativa, sem enchimento.
- Revise usando a lista de verificação (abaixo) e o padrão carregado.
Lista de verificação de revisão
- Padrão correto identificado e aplicado
- Bloco de título: título, ID do documento, versão, status, proprietário, data, classificação
- Hierarquia de seções numerada é consistente e sem reinícios
- Termos definidos uma vez no glossário; siglas expandidas no primeiro uso
- Figuras/tabelas numeradas e legendadas; referências cruzadas resolvidas
- Localidade correta (data, número, unidades, tamanho de papel, espelhamento RTL)
- Citações/referências formatadas conforme estilo escolhido
- Sem seções órfãs, sem links quebrados, sem texto de espaço reservado
- Destino de exportação confirmado (PDF/A para arquivamento, ISO 32000)
Referências (carregue conforme necessário)
document-types.md— modelos de seção e elementos obrigatórios por tipo de documentotypography-layout.md— escala tipográfica, espaçamento, grades, tabelas, figuras, exportação PDFinternationalization.md— localidade, RTL/LTR, tradução, numeração entre idiomas