Pular para o conteúdo principal

Korvian External Documentation Automation - Production Configuration

Arquitetura​

  • Orquestracao principal: script de orquestracao diario em modo incremental.
  • Assurance semanal: varredura full de documentação com deduplicacao por fingerprint.
  • Integracao por evento: processamento de deploy HML/Production em modo OBSERVE.
  • Fonte de governanca: Azure DevOps como sistema de registro de execução.

WITs​

  • AI Automation
  • Release Assurance
  • AI Engineering Task
  • Documentation Finding

Agentes​

  • Orquestrador oficial: korvian-docs-orchestrator.
  • Agentes especialistas de documentação: executados sob coordenacao do orquestrador.

Queries​

  • Automacoes por Automation ID (daily e weekly).
  • Fila noturna de tarefas explicitas AI elegiveis.
  • Findings por fingerprint para deduplicacao.

Automacoes​

  • DOC-FROTA-DAILY-001 (diaria incremental).
  • DOC-FROTA-WEEKLY-001 (semanal full assurance).

Schedules​

  • Daily: 04:07 Europe/Lisbon.
  • Weekly: 02:17 Europe/Lisbon (domingo).

Deployment Triggers​

  • Integracao ativa via repository_dispatch no korvian-docs.
  • Sinalizacao ativa via workflow_run no korvian-frota.
  • Modo operacional: OBSERVE.

Baseline Policy​

  • Não executar automacao se AI Automation estiver Disabled ou Automation Enabled=False.
  • Em caso de bloqueio de precondicoes, registrar evidencias e manter sem ação destrutiva.

Finding Policy​

  • Criacao de Documentation Finding com fingerprint estavel.
  • Quando finding ja existir, incrementar occurrenceCount e registrar histórico.

Night Queue​

  • Processar AI Engineering Tasks elegiveis para execução noturna apos assurance obrigatório.
  • Prioridade: Critical > High > Normal > Low.
  • Respeitar limite de capacidade por run e politicas de concorrencia.

Failure Policy​

  • Contadores de falha total e consecutiva por automacao.
  • Quando limite de tentativas for excedido, transicao para Attention Required.
  • Reset de falhas consecutivas apos execução bem-sucedida.

Manual Execution​

  • workflow_dispatch permanece habilitado para daily, weekly e deployment-assurance.
  • Dry-run suportado para validação segura sem efeitos colaterais indevidos.

Runbook​

  1. Validar conectividade ADO e GitHub.
  2. Validar estado da AI Automation.
  3. Executar daily incremental e fila noturna.
  4. Executar weekly full assurance conforme agenda.
  5. Processar eventos de deploy em OBSERVE.
  6. Registrar evidencias em Release Assurance e comentarios nos WIs de automacao.

Disable/Pause Procedure​

  1. Alterar State para Disabled e Custom.AutomationEnabled=False no WI de automacao.
  2. Desabilitar trigger de agenda no workflow correspondente.
  3. Registrar comentario de pausa com motivo, responsavel e prazo de revisão.

Recovery Procedure​

  1. Revalidar scripts em ValidateOnly.
  2. Corrigir causa raiz e reexecutar em dry-run.
  3. Reabilitar State=Enabled e Custom.AutomationEnabled=True.
  4. Registrar comentario de reativacao e proxima execução prevista.