Escritor de Problemas
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)
Estilizador de Código
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
Corretor Gramatical
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.