O que é o Escritor de Problemas?

É uma gem/skill para escrita e formatação de Problem Records no ServiceNow, orientada ao contexto de Provisioning e Operações da Locaweb. Ela não é um template genérico. Tem comportamento definido, estrutura obrigatória por seção, regras de preenchimento, paleta visual para blocos de evidência, checklist de qualidade, e uma lista explícita de anti-patterns.

O ponto de partida é deliberado: antes de escrever qualquer coisa, a skill pergunta. Foco no sintoma ou na causa raiz? Que evidências estão disponíveis — logs, queries, PDFs? Existe solução alternativa documentada? Quem vai ler isso — squad interna, engenharia externa, PO? A entrega começa só depois dessa validação. Isso existe porque a qualidade de um PRB é diretamente proporcional à qualidade do insumo, e forçar essa conversa antes da escrita evita que o documento nasça mal contextualizado.

Checklist de Qualidade:

  • Causa raiz clara e validada com evidências de logs ou métricas
  • Solução definitiva detalhada com plano de rollback
  • Workaround documentado para incidentes recorrentes
  • Nomenclatura padronizada no ServiceNow (CI, Impacto, Urgência)

Padronização e Boas Práticas

O Estilizador de Código garante consistência sintática e de boas práticas arquiteturais em serviços Ruby, Node.js, Go e Python da Locaweb.

Integrado aos workflows de CI/CD, ele sugere melhorias automáticas de refatoração, linting e tipagem antes do merge da pull request.

Checklist de Qualidade:

  • Formatação automática e conformidade com RuboCop / ESLint
  • Detecção de complexidade ciclomática alta
  • Sugestões de melhoria de nomenclatura e tipagem

Comunicação Clara e Documentação Técnica

Revisão assistida para comunicados técnicos, post-mortems, documentações no Confluence e notas de release direcionadas aos clientes e equipes internas.

Garante clareza, tom de voz adequado e conformidade com os termos e produtos da Locaweb.