AIFC-091: Schemas and Metadata Registry

Status: Draft 0.1 Standard: AI-First Community Standard Zkráceně: AIFC Navazuje na:

AIFC-001 Core Concepts
AIFC-010 Knowledge Structure
AIFC-011 Operational DNA
AIFC-012 Metadata and Markdown
AIFC-013 Human and AI Readable Content
AIFC-050 Community Interface
AIFC-060 Knowledge Security
AIFC-061 Access Control
AIFC-062 Agent Permissions
AIFC-063 Auditability
AIFC-064 Data Classification
AIFC-080 Compliance Levels
AIFC-090 Agent-Actionable Standard

Účel dokumentu: Definovat Schemas and Metadata Registry jako centrální katalog strukturovaných artefaktů, metadat, polí, typů, stavů, vazeb a validačních pravidel používaných v AIFC knowledge base. Tento dokument popisuje, jak mají být AIFC artefakty strukturovány tak, aby zůstaly čitelné pro lidi, použitelné pro AI agenty a ověřitelné softwarem.

1. Purpose of this document

Tento dokument definuje Schemas and Metadata Registry.

AIFC knowledge base nemá být jen složka textových souborů.

Má být živý systém artefaktů.

Tyto artefakty mohou být:

purpose statement,
values record,
decision record,
change proposal,
feedback signal,
workflow definition,
human skill,
AI skill,
agent permissions,
access policy,
classification record,
AI-NDA Boundary,
audit event,
compliance assessment,
ghost AI company risk assessment,
Operational DNA record,
interface record,
incident record,
retrospective record.

Aby s nimi mohli lidé, AI agenti a software pracovat konzistentně, musí mít společný strukturální základ.

Schemas and Metadata Registry definuje tento základ.

2. Core principle

Základní princip tohoto dokumentu je:

AIFC artefacts must be structured enough for agents and software, but readable enough for humans.

Česky:

AIFC artefakty musí být dostatečně strukturované pro agenty a software, ale dostatečně čitelné pro lidi.

AIFC říká:

Do not turn knowledge into unreadable data.
Do not leave knowledge as unstructured prose.

Česky:

Nepřevádějte know-how na nečitelná data.
Nenechávejte know-how jako nestrukturovanou prózu.

Registry má chránit rovnováhu mezi lidskou čitelností a strojovou použitelností.

3. Definition

Schemas and Metadata Registry je centrální katalog schémat, metadat, typů artefaktů, povinných polí, doporučených polí, stavů, vazeb, validačních pravidel a verzí používaných v AIFC standardu a jeho implementacích.

Registry určuje:

jaké artefakty existují,
jak se jmenují,
jaká metadata mají,
jaké stavy mohou nabývat,
jaké vazby mohou mít,
která pole jsou povinná,
která pole jsou doporučená,
jaká pravidla se validují,
jak se artefakty verzují,
jak se dědí metadata,
jak se řeší kompatibilita,
jak se mapují na Human Cockpit Layer,
jak je používají AI agenti.

Minimum requirement

AIFC implementace musí mít definovaný katalog klíčových artefaktů a jejich základních metadat.

4. Why schemas matter

Bez schémat vzniká chaos.

Každý AI agent začne vytvářet trochu jiný formát.

Každý tým začne používat jiné názvy polí.

Každý projekt bude mít jiné stavy.

Každý validátor bude očekávat jinou strukturu.

Výsledek:

nižší důvěra,
vyšší attention debt,
horší agentická použitelnost,
slabá validace,
horší migrace,
horší audit,
horší compliance,
více ruční práce,
více AI waste.

Schemas neexistují proto, aby lidem komplikovaly psaní.

Existují proto, aby komunita mohla udržet pořádek při růstu.

Minimum requirement

Kritické opakovatelné artefakty musí mít stabilní strukturu.

5. Why metadata matter

Metadata dávají znalosti provozní kontext.

Text říká, co je obsahem.

Metadata říkají:

co to je,
kdo to vlastní,
v jakém je to stavu,
jak je to citlivé,
zda to může číst AI,
zda to bylo reviewované,
jaké má vazby,
kdy se to má revidovat,
zda je to active nebo draft,
zda je to public nebo Operational DNA,
zda to vyžaduje approval.

Bez metadat lidé a agenti hádají.

Hádání vytváří riziko.

Minimum requirement

Kritické knowledge artefakty musí mít metadata dostatečná pro ownerství, status, klasifikaci a review.

6. Registry as source of structure

Schemas and Metadata Registry je source of structure.

To znamená, že určuje strukturu pro ostatní AIFC artefakty.

Není to nutně source of truth pro obsah konkrétní komunity.

Je to source of truth pro formát a pravidla struktury.

Příklad:

AIFC Registry defines what a Decision Record should contain.

Community source of truth contains actual Decision Records.

Minimum requirement

Komunita musí rozlišovat registry standardu od vlastního obsahu komunity.

7. Human-readable schema

Schéma nesmí být jen technický JSON.

AIFC schéma musí být lidsky srozumitelné.

Mělo by obsahovat:

název artefaktu,
účel,
kdy se používá,
kdo jej vlastní,
povinná pole,
doporučená pole,
příklady,
anti-patterns,
vazby na požadavky standardu,
validační pravidla,
AI usage notes.

Minimum requirement

Každé klíčové schéma musí mít lidsky čitelný popis účelu a použití.

8. Agent-actionable schema

Schéma musí být použitelné pro AI agenty.

Agent musí vědět:

kdy artefakt vytvořit,
jaká pole vyplnit,
která pole nesmí vymýšlet,
kdy označit uncertainty,
kdy vytvořit gap,
kdy eskalovat,
jaký output format použít,
jak ověřit povinná pole,
jak respektovat classification,
kdy požádat o human review.

Minimum requirement

Klíčová schémata musí obsahovat instrukce nebo odkazy pro agentické použití.

9. Software-verifiable schema

Schéma musí být částečně ověřitelné softwarem.

Software může ověřit:

povinná pole,
datové typy,
povolené hodnoty,
reference,
status transitions,
classification rules,
review dates,
owner existence,
missing approvals,
expired validity,
broken links.

Software nemůže plně ověřit smysl.

Ale může zabránit formálnímu chaosu.

Minimum requirement

Kritická schémata musí mít software-verifiable část tam, kde je to praktické.

10. Recommended registry structure

Doporučená struktura registry:

/agent-actionable
  /schemas
    community-profile.schema.md
    purpose-record.schema.md
    values-record.schema.md
    decision-record.schema.md
    change-proposal.schema.md
    feedback-signal.schema.md
    workflow.schema.md
    human-skill.schema.md
    ai-skill.schema.md
    agent-permissions.schema.md
    access-policy.schema.md
    classification.schema.md
    ai-nda-boundary.schema.md
    audit-event.schema.md
    compliance-assessment.schema.md
    incident-record.schema.md
    ghost-risk-assessment.schema.md
  /metadata
    common-fields.md
    lifecycle-statuses.md
    classification-levels.md
    relationship-types.md
    severity-levels.md
  /validation-rules
  /examples

Minimum requirement

Registry musí mít stabilní umístění a pojmenování.

11. Common metadata fields

AIFC doporučuje common metadata fields.

Základní sada:

id:
title:
type:
status:
owner:
classification:
created_at:
updated_at:
last_reviewed:
review_cycle:
source:
related_artefacts:
ai_generated:
human_reviewed:
approved_by:

Ne každý artefakt musí používat vše.

Ale společná pole snižují chaos.

Minimum requirement

Registry musí definovat common metadata fields and their meaning.

12. Stable identity

Artefakty potřebují stabilní identitu.

AIFC nedoporučuje spoléhat pouze na pořadová čísla viditelná v textu.

Identita má být stabilní i při přesunu artefaktu.

Možnosti:

UUID,
short stable ID,
slug plus namespace,
repository path plus internal ID,
generated non-sequential ID.

Důležité je, aby přesun nebo přeuspořádání neměnilo identitu.

Minimum requirement

Kritické artefakty musí mít stabilní identitu nezávislou na pořadí v souboru.

13. Type

Pole type říká, jaký artefakt daný blok nebo soubor představuje.

Příklady:

purpose_record
values_record
decision_record
change_proposal
feedback_signal
workflow
human_skill
ai_skill
agent_permissions
audit_event
classification
compliance_assessment

Type může být děděn z názvu souboru nebo složky.

Ale override musí být možný, pokud artefakt změní povahu.

Minimum requirement

Každý kritický artefakt musí mít explicitní nebo děděný type.

14. Status

Status říká, v jakém životním stavu artefakt je.

AIFC doporučuje rozlišovat alespoň:

draft
proposed
under_review
approved
active
deprecated
archived
rejected

Status je kritický pro AI.

AI nesmí považovat draft za active rule.

Minimum requirement

Kritické artefakty musí mít status nebo jej dědit z kontextu.

15. Owner

Owner říká, kdo odpovídá za artefakt.

Owner může být:

osoba,
role,
tým,
komunita,
governance body.

Owner neznamená jediný autor.

Owner znamená odpovědnost.

Minimum requirement

Kritické artefakty musí mít ownera nebo jasnou owning role.

16. Classification

Classification říká, jak citlivý artefakt je.

Doporučené hodnoty:

public
internal
restricted
operational_dna

Classification ovlivňuje:

access,
AI processing,
export,
audit,
public release,
retention.

Minimum requirement

Kritické artefakty musí mít classification nebo ji dědit z kontextu.

17. AI access metadata

Metadata musí umět říct, zda a jak může AI artefakt zpracovat.

Příklad:

ai_access:
  allowed: true
  allowed_tools:
  memory_allowed: false
  training_allowed: false
  requires_ai_nda_boundary: true
  human_review_required: true

Minimum requirement

Restricted nebo Operational DNA artefakty musí mít AI processing pravidlo nebo jej dědit z classification.

18. Review metadata

Review metadata říká, kdy a jak se artefakt kontroluje.

Příklad:

review:
  last_reviewed:
  next_review:
  review_cycle:
  reviewer:
  review_status:

Review je důležité pro:

zastarávání,
compliance,
security,
AI skills,
public claims,
agent permissions,
fallbacky.

Minimum requirement

Kritické artefakty musí mít review rule nebo review trigger.

19. Approval metadata

Approval metadata říká, kdo něco schválil.

Příklad:

approval:
  required: true
  approved_by:
  approved_at:
  approval_scope:
  expires_at:

Approval je nutný pro:

active decisions,
public claims,
AI agent activation,
restricted export,
classification downgrade,
AI-NDA Boundary changes,
high-risk AI outputs.

Minimum requirement

Artefakty, které mění active governance nebo public commitments, musí mít approval metadata.

20. Lineage metadata

Lineage říká, z čeho artefakt vznikl.

Příklad:

lineage:
  source_artefacts:
  generated_by:
  ai_model:
  prompt_reference:
  human_review:
  derived_from:

Lineage je důležité pro AI-generated content, derived knowledge a audit.

Minimum requirement

Kritické AI-generated artefakty musí mít základní lineage nebo reference to source evidence.

21. Relationship metadata

Artefakty spolu souvisejí.

Příklady vztahů:

implements
depends_on
supersedes
conflicts_with
derived_from
references
requires_review_of
owned_by
affects
mitigates
validates

Relationship metadata pomáhá lidem i agentům chápat souvislosti.

Minimum requirement

Kritické vazby mezi rozhodnutími, workflows, risks, agents and skills musí být dohledatelné.

22. Lifecycle statuses

Registry musí definovat lifecycle statuses.

Příklad pro change proposal:

draft
proposed
triaged
under_review
accepted
rejected
deferred
implemented
verified
closed

Příklad pro agent:

draft
proposed
active
paused
revoked
retired
archived

Minimum requirement

Každý artefakt s řízeným životním cyklem musí mít definované status values and transitions.

23. Status transitions

Status transitions určují, jak lze přecházet mezi stavy.

Příklad:

draft → under_review → approved → active
active → deprecated → archived

Neplatný přechod:

draft → active without approval

Minimum requirement

Kritické status transitions musí být definované nebo validovatelné.

24. Required vs recommended fields

Schéma musí rozlišovat:

required fields,
recommended fields,
optional fields,
conditional fields.

Příklad:

agent_permissions.owner = required
agent_permissions.memory_allowed = required if agent has memory
agent_permissions.tool_permissions = required if agent uses tools

Minimum requirement

Každé schéma musí jasně rozlišit required, recommended and conditional fields.

25. Conditional metadata

Některá metadata jsou povinná jen za určitých podmínek.

Příklady:

pokud classification = restricted, vyžaduje access rule,
pokud ai_generated = true, vyžaduje review status,
pokud public_claim = true, vyžaduje approval,
pokud agent_tool_access = true, vyžaduje agent permissions,
pokud critical_workflow = true, vyžaduje fallback.

Minimum requirement

Registry musí definovat conditional metadata rules pro kritické situace.

26. Metadata inheritance

Metadata mohou být děděna.

Například:

složka /restricted nastaví default classification,
soubor ai-skills nastaví type,
workspace nastaví ownera,
workflow nastaví review cycle,
registry nastaví default AI processing rule.

Inheritance snižuje ruční práci.

Ale musí být transparentní.

Minimum requirement

Metadata inheritance musí být explicitní a override musí být dohledatelný.

27. Metadata override

Override umožňuje změnit zděděnou hodnotu.

Například:

artefakt ve složce internal může být restricted,
obecný skill může obsahovat Operational DNA,
public document může mít restricted draft,
AI-generated summary může být citlivější než zdroje.

Override musí být reviewovatelný.

Minimum requirement

Override kritických metadat, zejména classification and AI access, musí být auditovatelný.

28. Schema versioning

Schémata se budou měnit.

Každé schéma musí mít verzi.

Příklad:

schema:
  name: agent_permissions
  version: 0.1
  status: draft

Verze je důležitá pro:

validaci,
migraci,
kompatibilitu,
agent skills,
cockpit,
compliance.

Minimum requirement

Každé kritické schéma musí mít version and status.

29. Migration

Změny schémat mohou vyžadovat migraci.

Migration notes mají říct:

co se změnilo,
proč,
jaký je dopad,
jak migrovat staré artefakty,
zda je změna breaking,
jak se ověří úspěch,
jak dlouho se podporuje stará verze.

Minimum requirement

Breaking schema changes must include migration guidance.

30. Schema status

Schémata sama mají lifecycle.

Doporučené stavy:

draft
experimental
active
deprecated
retired

AI agent musí vědět, že draft schema není stabilní.

Minimum requirement

Registry schemas must have lifecycle status.

31. Registry governance

Registry musí mít governance.

Musí být jasné:

kdo může navrhnout nové schéma,
kdo schvaluje změny,
jak se řeší breaking changes,
jak se udržuje kompatibilita,
jak se přidávají examples,
jak se deprekují pole,
jak se řeší konflikty,
jak se mapují požadavky standardu.

Minimum requirement

Schemas and Metadata Registry musí mít ownera a change governance.

32. Registry and Human Cockpit Layer

Human Cockpit Layer může registry používat k vytvoření UI.

Schéma může definovat:

jaký formulář zobrazit,
jaké pole je povinné,
jaký help text ukázat,
jaké warnings zobrazit,
jaký workflow spustit,
jaký approval vyžadovat.

Cockpit tak není kreativní improvizace.

Je veden standardem.

Minimum requirement

Schemas should support human-readable forms and cockpit views where practical.

33. Registry and AI agents

AI agenti používají registry k tomu, aby věděli, jak vytvářet artefakty.

Agent by měl:

načíst schéma,
vyplnit povinná pole,
označit nejistotu,
nevymýšlet chybějící evidence,
vytvořit gap,
požádat o review,
respektovat status,
respektovat classification.

Minimum requirement

AI agents creating AIFC artefacts must follow the relevant schema or explain deviations.

34. Registry and validation

Validation rules vycházejí ze schémat.

Příklad:

Schema says owner is required.
Validation checks owner exists.

Validation nemá být oddělená od registry.

Minimum requirement

Validation rules must reference schema fields and standard requirements.

35. Registry and compliance

Compliance assessment může používat registry.

Například:

Minimal AIFC Compliance assessment schema,
Compliance gap schema,
Certification report schema,
Evidence reference schema.

To umožňuje srovnatelná hodnocení.

Minimum requirement

Compliance artefakty musí mít standardizovanou strukturu.

36. Registry and portability

Registry musí podporovat portabilitu.

To znamená:

textově čitelné formáty,
export,
verzování,
jasné názvy polí,
omezení vendor-specific fields,
mapování na jiné nástroje,
možnost implementace v různých prostředích.

Minimum requirement

Core schemas must be portable and not dependent on one proprietary platform.

37. Registry and security

Registry může obsahovat citlivé informace.

Například:

schéma agent permissions může odhalit security model,
validation rules mohou odhalit kontrolní mechanismy,
examples mohou obsahovat Operational DNA,
metadata names mohou odhalit governance structure.

Je třeba rozlišovat:

public standard registry,
internal implementation registry,
restricted operational registry.

Minimum requirement

Registry content must be classified according to what it reveals.

38. Registry and examples

Každé důležité schéma by mělo mít examples.

Příklady:

minimal example,
complete example,
invalid example,
AI-generated draft example,
approved example,
redacted sensitive example.

Examples jsou důležité pro lidi i AI.

Minimum requirement

High-risk schemas must include examples and anti-examples.

39. Registry and anti-patterns

AIFC odmítá tyto anti-patterny.

39.1 Creative schema drift

Každý agent vytváří jiný formát artefaktu.

39.2 Metadata overload

Artefakty mají tolik polí, že lidé přestanou systém používat.

39.3 Metadata theater

Pole existují, ale nikdo je nepoužívá pro rozhodování, validaci nebo práci.

39.4 Missing owner

Schémata existují, ale nikdo je nespravuje.

39.5 Schema without examples

Schéma existuje, ale lidé ani agenti nevědí, jak ho použít.

39.6 Hidden schema in tool

Struktura je uzavřená v proprietárním nástroji a nelze ji exportovat.

39.7 Draft schema used as active

Agent používá experimentální schéma jako stabilní pravidlo.

39.8 Validation disconnected from schema

Validátor kontroluje něco jiného než registry definuje.

39.9 Classification ignored

Metadata a schémata odhalují citlivé know-how bez ochrany.

39.10 Sequential IDs as primary identity

Pořadová čísla se používají jako hlavní identita a rozpadají se při přesunech.

39.11 No migration path

Změna schématu rozbije existující knowledge base.

39.12 Machine-only registry

Registry je tak technická, že jí lidé nerozumí.

40. Minimal requirements

Schemas and Metadata Registry musí minimálně splnit:

Implementace má katalog klíčových artefaktů a jejich metadat.
Kritické opakovatelné artefakty mají stabilní strukturu.
Kritické artefakty mají metadata pro ownerství, status, klasifikaci a review.
Komunita rozlišuje registry standardu od vlastního obsahu.
Každé klíčové schéma má lidsky čitelný účel a použití.
Klíčová schémata obsahují instrukce nebo odkazy pro agentické použití.
Kritická schémata mají software-verifiable část, kde je to praktické.
Registry má stabilní umístění a pojmenování.
Registry definuje common metadata fields and their meaning.
Kritické artefakty mají stabilní identitu nezávislou na pořadí v souboru.
Kritické artefakty mají explicitní nebo děděný type.
Kritické artefakty mají status nebo jej dědí.
Kritické artefakty mají ownera nebo owning role.
Kritické artefakty mají classification nebo ji dědí.
Restricted nebo Operational DNA artefakty mají AI processing rule.
Kritické artefakty mají review rule nebo trigger.
Artefakty měnící active governance nebo public commitments mají approval metadata.
Kritické AI-generated artefakty mají lineage nebo evidence reference.
Kritické vazby mezi decisions, workflows, risks, agents and skills jsou dohledatelné.
Artefakty s lifecycle mají status values and transitions.
Kritické status transitions jsou definované nebo validovatelné.
Schémata rozlišují required, recommended and conditional fields.
Registry definuje conditional metadata rules pro kritické situace.
Metadata inheritance je explicitní a override je dohledatelný.
Override kritických metadat je auditovatelný.
Kritická schémata mají version and status.
Breaking schema changes include migration guidance.
Registry schemas mají lifecycle status.
Registry má ownera a change governance.
Schemas podporují human-readable forms and cockpit views, kde je to praktické.
AI agents creating AIFC artefacts follow relevant schema or explain deviations.
Validation rules reference schema fields and standard requirements.
Compliance artefakty mají standardizovanou strukturu.
Core schemas jsou portable and not dependent on one proprietary platform.
Registry content is classified according to what it reveals.
High-risk schemas include examples and anti-examples.

41. Summary

Schemas and Metadata Registry dává AIFC knowledge base společný tvar.

Bez registry by každý člověk, tým, projekt a agent vytvářel jiné struktury.

S registry může komunita držet konzistenci, validovat artefakty, spouštět AI agenty, stavět Human Cockpit Layer a posuzovat compliance bez chaosu.

AIFC proto říká:

Structure knowledge enough for agents.
Keep it readable enough for humans.
Validate it enough for trust.

Česky:

Strukturujte know-how dostatečně pro agenty.
Nechte ho dostatečně čitelné pro lidi.
Validujte ho dostatečně pro důvěru.

Registry není byrokracie.

Je to společná gramatika komunitního know-how.

Schemas and Metadata Registry turns AIFC knowledge into consistent, portable and agent-usable structure.