Pular para o conteúdo
Luiz Hogrefe

Open Template Library

Uma fonte semântica, três formas legíveis

Catálogo-piloto · protótipo

Documentos de governança, declarações de dados e checklists costumam existir em várias cópias: um PDF para pessoas, um esquema para sistemas, um prompt para ferramentas. As cópias se desencontram. Esta biblioteca foi construída para evitar isso.

A biblioteca no anylai.eu

A ideia

Um modelo é escrito uma única vez, como fonte semântica. Dessa fonte são geradas três formas: uma legível por máquina, para validação; uma legível por IA, para ferramentas que auxiliam; e uma legível por pessoas, para quem dá a aprovação final.

Como as três vêm de uma única fonte, uma alteração é feita uma só vez e não pode se contradizer entre as formas.

Uma fonte, três formas

Uma fonte, três formas
Fonte semântica
versão · proveniência · ciclo de vida
  • Legível por máquina
    esquema para validação
  • Legível por IA
    contexto para ferramentas auxiliares
  • Legível por pessoas
    documento para aprovação
Registro

A fonte semântica é a única coisa que alguém edita.

Descrição em texto do diagrama

Uma única fonte semântica, com versão, proveniência e estado de ciclo de vida, é validada e depois gerada em três formas: legível por máquina, legível por IA e legível por pessoas. Um registro guarda cada versão publicada.

O que um modelo precisa carregar

  • Versionamento

    Todo modelo publicado tem uma versão, e as versões anteriores continuam acessíveis.

  • Proveniência

    De onde vem o significado de cada campo: um regulamento, uma norma ou uma decisão interna.

  • Ciclo de vida

    Um estado como rascunho, publicado ou retirado, para que ninguém dependa de algo que foi retirado.

  • Validação

    A semântica é validada, não apenas a sintaxe.

  • Registro

    Um único lugar que lista o que existe, em qual versão e com qual estado.

  • Exemplos

    Exemplos preenchidos que são, eles próprios, validados contra o modelo.

Estado: catálogo-piloto

5modelos publicados

Desde 16 de setembro de 2026, a biblioteca é um catálogo-piloto no repositório da AnyLAI. Um gerador valida cada fonte contra controles existentes do COADF 2.2, produz as três representações, verifica que são coerentes entre si e fixa cada versão publicada; o número no anylai.eu é lido do registro gerado, não escrito à mão.

É um protótipo: cinco modelos, só em inglês. Um modelo ajuda a implementar um controle; não resolve nenhuma questão jurídica, e a sua aplicação depende do sistema em que é usado. Uma estimativa anterior para o tamanho da biblioteca não é repetida, porque esses modelos nunca foram construídos.

Quando um modelo conta

Um modelo só entra na lista publicada quando tem tudo o que segue:

  1. 1Um esquema canônico
  2. 2Semântica substantiva que é validada
  3. 3Formas para máquina, IA e pessoas geradas a partir da mesma fonte
  4. 4Testes
  5. 5Uma versão e um estado de ciclo de vida
  6. 6Um mapeamento para princípios ou controles do COADF

Os modelos publicados

Cada um está associado a um princípio do COADF 2.2 e está publicado na versão 1.0.0, com guia para pessoas, contrato para IA e modelo para máquinas.

Títulos tal como publicados; a biblioteca está em inglês.

A ideia na escala de um campo

País de origem

Legível por máquina

{
  "field": "countryOfOrigin",
  "type": "string",
  "pattern": "^[A-Z]{2}$",
  "required": true,
  "evidence": ["certificateOfOrigin"],
  "version": "0.1.0-sketch"
}

Legível por IA

Campo countryOfOrigin: ISO 3166-1 alfa-2. Nunca o deduza de um endereço; se nenhum certificado estiver anexado, deixe-o vazio e pergunte.

Legível por pessoas

País de origem: o país em que as mercadorias foram produzidas. Código de duas letras. Obrigatório. Evidência: um certificado de origem.

Um esboço ilustrativo das três formas de um único campo, escrito para esta página. Não é um dos modelos publicados.

Não confundir com

Os modelos de governança do COADF, como a carta de agentes de IA, publicados junto com o framework, e os padrões do Engineering Companion do COADF.

  • COADFFramework publicado

    Um framework publicado para construir software assistido por IA sob governança explícita: oito princípios, um manifesto de controles e fences impostos pela CI.

    COADF