Simple English: instruções técnicas claras sem prometer conformidade STE

ANÁLISE EDITORIAL

Documentação técnica pode estar gramaticalmente correta e ainda ser difícil de executar. Uma condição aparece depois do comando, três palavras diferentes nomeiam a mesma ação, uma frase reúne instrução, motivo e alerta, ou um termo surge sem definição. A Simple English transforma esse problema em regras observáveis para escrever e revisar instruções em inglês claro.

A Skill se inspira na ASD-STE100, uma linguagem controlada usada em documentação técnica. Ela aplica limites de comprimento, voz ativa, tempos verbais simples, uma instrução por frase e vocabulário consistente. O projeto é independente e não entrega certificação. A norma oficial e a revisão humana continuam sendo a referência quando a conformidade é necessária.

Ilustração editorial exclusiva do Bastidores da IA. Não é captura de tela, texto real, certificação, benchmark nem prova de conformidade com ASD-STE100.

O que esta Skill faz de verdade

A Simple English tem dois modos. O modo Plain é o padrão e busca inglês direto para documentação, runbooks, mensagens de erro, notas de versão, relatórios de incidente, guias de API e explicações para pessoas fora da área. O modo Strict entra somente quando o usuário pede STE, ASD-STE100 ou conformidade. Nesse caso, a Skill também consulta uma referência de disciplina vocabular e precisa avisar que nenhuma ferramenta garante conformidade.

O arquivo principal separa texto procedural de texto descritivo. Procedimentos dizem o que fazer e usam comando direto. Descrições explicam o que algo é ou faz. Essa classificação importa porque a Skill atribui limites e formas verbais diferentes a cada tipo. Ela também protege código, identificadores, comandos, flags, caminhos, mensagens de erro citadas, nomes de produtos e fatos contra reescrita acidental.

Quatro referências completam o fluxo. Um catálogo organiza 53 regras para auditoria. Outra referência trata vocabulário estrito. A terceira adapta o método a casos como runbooks e incidentes. A quarta troca expressões vagas por alternativas mais simples. O pacote local preserva esses documentos, mas não inclui hooks, scripts ou instaladores do repositório.

Para quem serve

A Skill serve a equipes que escrevem documentação técnica em inglês para leitores internacionais. Isso inclui suporte, operações, engenharia, segurança, manutenção, produto e tradução. Ela é especialmente útil quando uma instrução precisa sobreviver a uma leitura rápida, quando o leitor não domina o assunto ou quando o texto será traduzido para outros idiomas.

Também ajuda revisores que precisam apontar problemas concretos. Em vez de dizer apenas que uma frase está confusa, o modo de auditoria associa o trecho a uma regra registrada e propõe uma versão controlada. Esse formato torna a revisão rastreável e reduz a chance de o modelo inventar números de regras de memória.

Ela não substitui a Humanizer do catálogo. A Humanizer procura hábitos artificiais e preserva a voz do autor. A Simple English reduz ambiguidade em instruções técnicas em inglês, mesmo que o resultado fique deliberadamente neutro. Para conteúdo de marca ou marketing, o próprio projeto diz que a técnica pode apagar persuasão e voz.

Compatibilidade e pré-requisitos

O frontmatter declara compatibilidade com Claude Code, Cursor, Codex, Gemini CLI e OpenCode. Na prática, o uso documental exige um cliente que consiga carregar um diretório de Agent Skill em Markdown ou receber instruções equivalentes. O comportamento final também depende do modelo e das regras do agente hospedeiro.

O pacote auditado contém sete arquivos textuais e não depende de Python, Node.js ou binários. Isso não significa que qualquer método de instalação seja livre de efeitos. O comando promovido pelo README usa um pacote executado por npx, consulta a rede e grava arquivos. O repositório também oferece hooks para alguns clientes, mas eles ficaram fora do download do Bastidores.

Para uso responsável, tenha o texto de origem, o público, o tipo de documento e os trechos que não podem mudar. Em modo Strict, obtenha a edição oficial atual da ASD-STE100 e o dicionário aplicável. A Skill é uma ajuda de escrita, não uma cópia completa nem autorizada da norma.

Instalação recomendada

Comece pelo ZIP documental do Bastidores. Descompacte em uma pasta de teste e leia ORIGEM.md, LICENSE e SKILL.md. Compare os arquivos com o diretório oficial fixado. Depois copie somente a pasta simple-english para o diretório de Skills que seu cliente documenta.

A instalação manual evita executar um instalador durante o primeiro teste. Se você preferir o comando npx skills add AminBlg/SimpleEnglish, trate-o como código de terceiro: confirme o pacote, a rede, o destino e o diff antes de aprovar. Uma discussão encerrada no repositório questionou telemetria do instalador externo. O Bastidores não verificou uma execução do CLI e não o inclui no ZIP.

O download local também não instala hooks, estilos de saída ou configurações globais. Esses componentes podem mudar todas as respostas do agente e exigem uma auditoria separada. Para a primeira avaliação, prefira ativação somente no projeto e um documento descartável.

Configuração antes do primeiro uso

Defina se a tarefa é escrever, reescrever ou auditar. Informe se o texto é procedural, descritivo ou misto. Marque código, comandos, nomes, números, mensagens de erro, avisos e citações como conteúdo protegido. Diga que nenhuma informação nova pode ser acrescentada sem fonte.

No modo Plain, permita os termos técnicos necessários, mas peça uma definição curta na primeira ocorrência. Escolha uma única palavra para ações equivalentes. Por exemplo, o documento não deve alternar entre check, verify, validate e confirm sem motivo. Faça o mesmo para configuration, settings e options quando todos representam o mesmo objeto.

No modo Strict, anexe ou disponibilize a norma oficial dentro do escopo permitido. Não peça ao modelo que reproduza a norma nem o dicionário. Peça que cite a regra consultada, registre dúvidas e encaminhe decisões vocabulares para um revisor qualificado. A página oficial oferece a edição 9, de janeiro de 2025, mediante solicitação gratuita.

Primeiro uso seguro

Teste com uma instrução curta e sem dados confidenciais. Peça duas saídas: a versão revisada e uma lista das mudanças com os trechos de origem. Compare cada comando, condição, parâmetro, valor e alerta. O objetivo é reduzir ambiguidade sem mudar o que o sistema realmente faz.

Depois aplique o conjunto mínimo de avaliação de prompts. Inclua exemplos com uma condição antes do comando, uma mensagem de erro literal, um identificador longo, um aviso de risco e uma passagem descritiva. Verifique se o agente mantém os elementos protegidos e escolhe a regra correta.

Não comece por um manual inteiro. Um lote grande esconde regressões e pode padronizar incorretamente centenas de frases. Revise uma seção, aceite ou rejeite cada mudança e só então aumente o escopo. Mantenha sempre o original recuperável.

Como o fluxo deve funcionar

Primeiro, o agente classifica a passagem. Depois identifica código e fatos que não podem mudar. Em seguida escolhe vocabulário consistente, coloca condições antes de comandos, divide frases longas e reduz construções complexas. Por fim, executa uma autoverificação e apresenta o resultado para confronto humano.

Quando o usuário pede auditoria, a Skill consulta references/rule-catalog.md. Cada achado precisa ter número de regra, trecho ofensivo e reescrita proposta. O agente não deve inventar regra ausente. No modo Strict, também consulta references/strict-vocabulary.md, mas isso continua sendo uma aproximação independente.

Em documentos mistos, o fluxo deve preservar a diferença entre explicação e ação. Uma nota pode explicar um risco, mas não deve esconder um comando. Um aviso começa pela ação ou condição e depois apresenta a consequência. A ordem ajuda o leitor a agir antes de encontrar o dano descrito.

Resultado esperado

O resultado esperado é um texto técnico em inglês com frases curtas, ações explícitas e nomes estáveis. Cada procedimento apresenta uma instrução por frase. Cada conceito importante recebe uma definição curta. Condições aparecem antes da ação que controlam. Alertas preservam a consequência real sem criar gravidade.

Uma revisão correta também informa o que permaneceu intacto. Comandos, caminhos, flags, códigos, mensagens citadas, nomes de produtos, datas e quantidades devem coincidir com a origem. Se uma simplificação muda uma obrigação ou remove uma exceção, a mudança falhou.

Não espere estilo literário, voz de marca ou prova de autoria humana. O texto pode parecer plano porque clareza operacional é o objetivo. Também não espere conformidade automática. O STEMG alerta em seu material sobre IA que texto plausível pode parecer compatível sem aplicar corretamente regras e vocabulário.

Permissões, privacidade e riscos

A Skill local é textual, mas o agente hospedeiro pode ler documentos, gravar arquivos e enviar contexto ao provedor do modelo. Restrinja a pasta, use cópias e remova dados pessoais, segredos, informações controladas para exportação e conteúdo confidencial antes do processamento. Confira a política de retenção do ambiente usado.

O maior risco editorial é uma simplificação que muda o significado. Trocar um modal, dividir uma frase ou remover uma exceção pode alterar responsabilidade, segurança ou comportamento de um sistema. Documentos jurídicos, médicos, aeronáuticos e de segurança exigem revisão especializada.

Outro risco é apresentar a saída como certificada. O site oficial da ASD-STE100 é a fonte do padrão. O projeto Simple English declara que é não oficial e sem endosso. Use a expressão inspirado em ou auxílio para, nunca certificado, aprovado ou garantido.

Erros comuns

• Aplicar a marketing: a técnica pode remover voz, persuasão e ritmo que fazem parte do objetivo.
• Usar Strict sem a norma: a referência local não substitui o documento oficial e seu dicionário.
• Alterar comandos: código, flags, caminhos, identificadores e erros citados precisam permanecer literais.
• Confundir curto com incompleto: artigos, condições e relações gramaticais não devem desaparecer.
• Trocar obrigação por sugestão: modais mudam responsabilidade e exigem confronto com a fonte.
• Instalar globalmente primeiro: hooks ou estilos podem afetar projetos fora do teste.
• Enviar documento sensível: uma Skill Markdown não controla a retenção do modelo hospedeiro.
• Publicar sem revisão: clareza aparente não comprova correção técnica nem conformidade.

Versão, licença e origem verificadas

A curadoria fixou o repositório no commit 9ce426c79b1736c28af7e91f1b730e7a7cc3f468. O último commit específico do SKILL.md encontrado na consulta foi 43d6c26d6726d6dfc9aa730cd16357f22b6cd2cd. O arquivo declara versão 2.0.1 e compatibilidade com cinco famílias de clientes.

A API oficial do GitHub registrou 3.210 estrelas em 06/09/2026 e repositório não arquivado. Esse número atende ao corte editorial de mil estrelas, mas não prova correção, segurança nem aderência à norma. O commit fixado preserva a árvore usada na auditoria.

O repositório usa licença MIT. A licença permite redistribuição com o aviso mantido. O pacote do Bastidores contém exatamente SKILL.md, LICENSE, ORIGEM.md e quatro referências Markdown. O hash SHA-256 abaixo identifica esse ZIP auditado: 5af418bcad38839750df22306f2bb304a5d5b3ee9191480d9c79a416d7ca95ce.

Checklist antes de automatizar

• Fixe o commit, a versão, a licença e o diretório de origem.
• Escolha Plain ou Strict e registre por que o modo foi usado.
• Defina texto procedural, descritivo e conteúdo protegido.
• Use cópia sem dados sensíveis e limite leitura e escrita.
• Compare comandos, fatos, números, avisos e exceções com o original.
• Consulte a norma oficial quando houver requisito de conformidade.
• Exija revisão humana qualificada antes de publicar ou executar.

Fontes primárias

• Repositório oficial AminBlg/SimpleEnglish.
• Diretório da Skill no commit auditado.
• SKILL.md versão 2.0.1.
• Catálogo de 53 regras para auditoria.
• Referência de vocabulário para modo Strict.
• Casos de uso para documentos técnicos.
• Mapa de substituições de palavras.
• Licença MIT preservada no pacote.
• Portal oficial ASD-STE100.
• Solicitação da edição 9 e orientação oficial sobre IA.
• ASD-STE100 Issue 9, janeiro de 2025.