Linter de Governança (S)

Ponto de vista: GTI — Governança de TI

O que é

O Linter de Governança é um mecanismo automatizado de verificação de conformidade documental, responsável por garantir que nenhum artefato avance de fase sem possuir todos os metadados obrigatórios, vínculos e evidências mínimas.

É parte integrante do Artefato Orquestrador.

O que o Linter verifica

Antes de qualquer revisão humana, o Linter verifica se o artefato possui:

identificador único no formato correto
versão e datas de geração e revisão
autor ou responsável rastreável
origem documental (para histórias que exigem)
dependências declaradas e resolvidas
criticidade e nível de autonomia definidos
evidências mínimas obrigatórias (conforme o tipo de artefato)
vínculos com artefatos dos demais PVs (rastreabilidade cruzada)

Dimensão da demanda — critérios objetivos (verificáveis)

Para medição, priorização ou contratos baseados em entrega e governança, a “complexidade” ou o esforço relativo não podem depender só de julgamento isolado. O SinergIA já dispõe de campos e artefatos auditáveis que o Linter (ou política GTI equivalente) pode exigir preenchidos e consistentes antes de aprovar história, promover build ou fechar gate:

Critério	Fonte no framework	O que torna auditável
Modo de atuação	Modos de Atuação (Completo, Essencial, Ágil)	Define o conjunto mínimo de artefatos SIS e o rigor do fluxo
Tipo de demanda	Tipos de Demanda	Distingue correção de defeito, evolução, sustentação ou adaptação — com consequência na política de reabertura vs nova história ESP
Criticidade	Metadado da história ESP e do contexto SIS	Valor explícito no YAML (ex.: alta/média/baixa), alinhado a gates e revisões
Nível de autonomia	Níveis de Autonomia	Classe de risco da mudança; dispara revisões e segunda engine quando aplicável
Pontos de vista tocados	Vínculos entre artefatos (ESP, IMP, INF, GTI, PDP, GDA)	Lista declarada de dependências e resolução — não basta “achar pequeno”

Comportamento

Resultado	Consequência
Verde (conforme)	Avanço para revisão humana ou gate de promoção
Amarelo (aviso)	Artefato avança com registros de pendência monitorada
Vermelho (bloqueado)	Fase bloqueada — correção obrigatória antes do próximo gate

Saída do Linter

O Linter gera:

relatório de não-conformidade indicando os campos faltantes e artefatos afetados;
evidência automatizada do resultado da verificação (gravada no dossiê da entrega).

Coerência código, especificação e desvios

Complementa a norma Desvio controlado da especificação. O Linter (ou política de CI acoplada ao Artefato Orquestrador) pode incorporar verificações objetivas que reduzem divergência silenciosa entre código e documentação oficial:

Verificação sugerida	O que falha se ausente	Nota
PR com alteração em caminhos de produto sem menção a `ESP-*` no título ou corpo	Merge ou build bloqueado (política do órgão)	Não infere equivalência semântica
Label `pendencia-documental` obrigatório quando o PR referencia arquivo `desvio` ou campo `pendencias-documentais`	Falha até correção	Liga PR à nota provisória na IMP
Diff que altera contrato de API público sem link a RFC ou história em estado compatível	Bloqueio em gate de homologação ou produção	Alinhar à tabela de impacto na página de desvio controlado
Lista de caminhos sensíveis (auth, criptografia, PDP) exige ADR ou aprovação documentada	Bloqueio de promoção	Configurável por repositório
Commit sem ID de história quando o commit toca arquivos rastreados	Aviso ou bloqueio	Base para dossiê

Limites explícitos: o Linter não detecta sozinho “comportamento diferente do aceite” sem regras de teste ou revisão humana; não valida a qualidade literária do texto de requisito; não substitui o Validador Técnico na classificação de impacto em casos limite.

← Níveis de Autonomia · Gestão de Custo de IA →