AIFC-013: Human and AI Readable Content

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

AIFC-000 Manifest AI-first komunity
AIFC-001 Core Concepts
AIFC-002 Community Model
AIFC-010 Knowledge Structure
AIFC-012 Metadata and Markdown

Účel dokumentu: Definovat principy pro tvorbu obsahu, který je současně srozumitelný člověku, použitelný AI agentem a ověřitelný softwarem. Tento dokument popisuje, jak má být znalost psána, strukturována, vysvětlována a udržována, aby se z ní nestal pouze text, ale použitelná schopnost komunity.

1. Purpose of this document

Tento dokument definuje pravidla pro psaní AIFC knowledge artefaktů.

AIFC knowledge base nemá být pouze úložištěm informací. Má být prostředím, kde lidé, AI agenti a software pracují se stejným source of truth.

Aby to bylo možné, obsah musí být:

human-readable
agent-actionable
software-verifiable

Tento dokument se soustředí hlavně na první dvě vrstvy:

jak psát pro člověka,
jak psát pro AI agenta,
a jak tyto dvě potřeby sladit.

2. Core principle

Základní princip tohoto dokumentu je:

Content must protect human attention and reduce AI ambiguity.

Česky:

Obsah musí chránit lidskou pozornost a snižovat nejednoznačnost pro AI.

Člověk potřebuje rychle pochopit význam. AI agent potřebuje jasně pochopit kontext, pravidla, hranice a očekávaný výstup.

Dobrý AIFC obsah proto není dlouhý proto, že je obsáhlý. Je přesný, strukturovaný a použitelný.

3. Human-readable content

Human-readable obsah je obsah, který člověk dokáže rychle pochopit, použít a schválit.

Musí být:

jasný,
stručný,
strukturovaný,
kontextový,
čitelný bez speciálního nástroje,
vhodný pro nového člena komunity,
použitelný při rozhodování,
nezahlcující.

Human-readable neznamená zjednodušený až na úroveň ztráty významu.

Znamená to, že obsah respektuje lidskou pozornost.

Minimum requirement

Každý kritický knowledge artefakt musí mít lidsky srozumitelný úvod, který vysvětluje:

co artefakt je,
proč existuje,
kdo ho používá,
jak se podle něj má jednat,
kdo je owner,
jaký má status.

4. Agent-actionable content

Agent-actionable obsah je obsah, podle kterého AI agent dokáže bezpečně vykonat práci nebo navrhnout další krok.

Musí obsahovat:

jasný účel,
pravidla,
hranice,
vstupy,
výstupy,
povolené akce,
zakázané akce,
rozhodovací body,
schvalovací pravidla,
vazbu na source of truth,
vazbu na lidského ownera.

AI agent nesmí hádat, co má dělat, pokud to může být jasně popsáno.

Minimum requirement

Každý artefakt určený pro AI agenty musí explicitně říkat:

co agent smí,
co agent nesmí,
kdy má požádat o schválení,
kam má zapsat výstup,
jak označit nejistotu.

5. Software-verifiable content

Software-verifiable obsah je obsah, u kterého lze automaticky ověřit alespoň část pravidel.

Například:

artefakt má ownera,
má status,
má sensitivity,
má lifecycle,
AI workflow má fallback,
change proposal má decision level,
restricted obsah nemá neomezený AI access,
deprecated artefakt není používán jako active,
Operational DNA má ochranu.

Software nemusí rozumět celému významu textu. Stačí, aby dokázal ověřit kritická pravidla.

Minimum requirement

Kritické artefakty musí mít takovou strukturu a metadata, aby bylo možné validovat alespoň minimální governance požadavky.

6. The three-layer content model

AIFC doporučuje psát kritické artefakty ve třech vrstvách:

Meaning layer
Operational layer
Validation layer

6.1 Meaning layer

Meaning layer vysvětluje význam člověku.

Odpovídá na otázky:

Proč toto existuje?
Jaký problém to řeší?
Jaký princip za tím stojí?
Jak to souvisí se záměrem a hodnotami?

6.2 Operational layer

Operational layer říká, jak se podle toho má jednat.

Odpovídá na otázky:

Kdo co dělá?
Jaké jsou vstupy?
Jaké jsou výstupy?
Jaká pravidla platí?
Kdy je potřeba approval?
Co se stane při výjimce?

6.3 Validation layer

Validation layer říká, co lze ověřit.

Odpovídá na otázky:

Jaký status musí existovat?
Jaká metadata jsou povinná?
Jaké konflikty jsou nepřípustné?
Jak poznáme, že je artefakt neúplný?
Jak poznáme, že je pravidlo porušené?

Minimum requirement

Kritické artefakty musí mít alespoň meaning layer a operational layer. Validation layer je vyžadovaná pro governance, security, AI workflow, Operational DNA a compliance artefakty.

7. Clarity before completeness

AIFC preferuje jasný a použitelný obsah před vyčerpávajícím, ale nepřehledným obsahem.

Příliš dlouhý text bez hierarchie vytváří attention debt.

Pokud dokument obsahuje mnoho informací, musí mít:

jasný účel,
obsah nebo navigaci,
sekce,
krátké shrnutí,
rozhodovací body,
odkazy na detail,
status,
vlastníka.

Komunita, která vytváří dlouhé dokumenty bez navigace, přenáší náklady na každého budoucího čtenáře.

Minimum requirement

Dlouhé artefakty musí mít strukturu, která umožní rychlou orientaci člověku i AI agentovi.

8. Context before instruction

AI agent potřebuje kontext.

Člověk také potřebuje vědět, proč je instrukce důležitá.

AIFC proto doporučuje, aby pravidla nebyla psána pouze jako příkazy.

Špatně:

Do not use AI for restricted data.

Lépe:

Restricted data may contain sensitive operational or personal information.
AI tools may process this data only within an approved AI-NDA boundary.
Do not use external AI tools for restricted data unless the specific tool, purpose and boundary are approved.

Dobré pravidlo vysvětluje:

co,
proč,
kdy,
kdo,
s jakou výjimkou,
a co dělat místo toho.

Minimum requirement

Kritická pravidla musí obsahovat dostatečný kontext, aby je člověk i AI agent dokázali aplikovat v nových situacích.

9. Use explicit ownership language

AIFC obsah musí jasně rozlišovat:

kdo navrhuje,
kdo rozhoduje,
kdo schvaluje,
kdo vykonává,
kdo ověřuje,
kdo vlastní výsledek.

AI může návrh formulovat. Komunita rozhoduje.

Tato hranice musí být v obsahu viditelná.

Example

Špatně:

AI updates the workflow.

Lépe:

AI may propose a workflow update.
The workflow owner reviews the proposal.
The approved change is written back to the source of truth.

Minimum requirement

Významné AI kroky musí jasně rozlišovat proposal, recommendation, decision, approved change a implemented change.

10. Avoid hidden assumptions

Skryté předpoklady jsou rizikové pro člověka i AI.

Člověk je může přehlédnout. AI je může doplnit nesprávně.

AIFC doporučuje důležité předpoklady explicitně zapisovat.

Příklad:

Assumption:
This workflow assumes that customer data is classified as restricted and cannot be processed by external AI tools without approved AI-NDA boundary.

Minimum requirement

Kritické artefakty musí uvádět předpoklady, pokud jejich nepochopení může vést k chybnému rozhodnutí, bezpečnostnímu riziku nebo AI misuse.

11. Use examples and anti-patterns

Příklady pomáhají člověku i AI pochopit pravidlo.

Anti-patterny pomáhají rozpoznat, co už je mimo hranici.

AIFC doporučuje u důležitých pravidel používat:

example,
counterexample,
anti-pattern,
edge case,
exception.

Příklad:

Rule:
AI-generated change proposals must be reviewed before becoming decisions.

Example:
AI suggests updating the maintenance workflow. The process owner reviews and approves it.

Anti-pattern:
AI detects a workflow issue and directly changes the active workflow without approval.

Minimum requirement

Kritická pravidla s vysokým rizikem nesprávného výkladu musí obsahovat příklad nebo anti-pattern.

12. Separate facts, interpretation and decisions

AIFC knowledge base musí rozlišovat:

fact
interpretation
proposal
decision

Fact

Ověřitelná informace.

Interpretation

Výklad nebo syntéza faktů.

Proposal

Návrh, co změnit.

Decision

Schválené rozhodnutí odpovědnou governance.

AI často vytváří interpretace a návrhy. Nesmí být automaticky zaměňovány za fakta nebo rozhodnutí.

Minimum requirement

AI-generated interpretace a návrhy musí být označeny jako interpretace nebo návrhy, dokud nejsou schváleny.

13. Mark uncertainty

AI i lidé mohou pracovat s nejistotou.

Nejistota nesmí být skrývána za sebevědomý text.

AIFC doporučuje označovat:

nejistý zdroj,
chybějící data,
konfliktní informace,
neověřený předpoklad,
zastaralý obsah,
AI-generated interpretaci,
nízkou důvěru.

Příklad:

Confidence: medium
Reason: Based on two outdated process documents and one recent meeting note. Needs process owner review.

Minimum requirement

Artefakty vytvořené z neúplných, konfliktních nebo AI-interpretovaných zdrojů musí označovat confidence a potřebu review.

14. Write for future readers

AIFC knowledge base není psána jen pro dnešní tým.

Je psána také pro:

nového člena,
budoucího ownera,
auditora,
AI agenta,
komunitu po změně lidí,
recovery situaci,
budoucí migraci.

Obsah má vysvětlovat nejen „co“, ale i „proč“.

Bez „proč“ se komunita časem dostane do stavu, kdy ví, jaké pravidlo existuje, ale neví, proč vzniklo.

Taková znalost se snadno smaže, obejde nebo špatně automatizuje.

Minimum requirement

Významná pravidla a rozhodnutí musí obsahovat důvod nebo odkaz na decision record.

15. Reduce attention debt

Attention debt vzniká, když obsah spotřebovává příliš mnoho lidské pozornosti na pochopení základního významu.

Vzniká například když:

dokumenty jsou příliš dlouhé,
chybí shrnutí,
chybí struktura,
chybí status,
chybí owner,
stejné pravidlo je popsáno na více místech různě,
není jasné, co je aktuální,
člověk musí číst celý dokument kvůli jedné akci.

AIFC content má attention debt snižovat.

Human Cockpit Layer může pomoci, ale zdrojový obsah musí být také strukturovaný.

Minimum requirement

Kritické artefakty musí mít jasný účel, status a navigovatelnou strukturu.

16. Reduce AI ambiguity

AI ambiguity vzniká, když agent nemá dost informací k bezpečnému jednání.

Vzniká například když:

není jasný owner,
není jasný status,
není jasné, zda jde o draft nebo approved pravidlo,
není jasná citlivost,
nejsou popsány zakázané akce,
není určen fallback,
není jasné, co má agent udělat při nejistotě.

AI agent potom doplňuje mezery podle pravděpodobnosti.

To je nevhodné pro governance.

Minimum requirement

Artefakty používané AI agenty musí explicitně popisovat hranice, nejistoty a schvalovací pravidla.

17. Use consistent terminology

AIFC obsah musí používat jednotné pojmy.

Pokud jeden dokument používá „source of truth“, jiný „main repo“, třetí „knowledge store“ a čtvrtý „truth base“, vzniká nejasnost.

Core terms musí být odvozené z AIFC-001 Core Concepts.

Minimum requirement

Nový významný pojem musí být buď definován v Core Concepts, nebo navržen jako change proposal.

AI agenti nesmí svévolně zavádět nové názvosloví pro existující pojmy.

18. Avoid decorative language in standards

Manifest může používat silnější jazyk. Standardní dokumenty mají být přesné.

AIFC rozlišuje:

manifest language,
standard language,
implementation guide language,
educational language,
book language.

Silná formulace může být velmi užitečná, pokud pomáhá pochopit princip. Nemá však nahradit pravidlo.

Příklad dobrého spojení:

To, o co komunita nepečuje, má tendenci degradovat nebo vytvářet dluh.

Therefore, critical knowledge artefacts must have an owner and review mechanism.

Minimum requirement

Standardní dokumenty musí rozlišovat princip, vysvětlení a požadavek.

19. Content as capability

AIFC obsah není jen popis.

Dobrý obsah zvyšuje schopnost komunity.

Například:

dobře popsaný workflow zvyšuje opakovatelnost,
dobře popsaný skill zlepšuje onboarding,
dobře popsané rozhodnutí brání opakování diskuse,
dobře popsaný fallback zvyšuje odolnost,
dobře popsaná AI-NDA boundary snižuje riziko úniku,
dobře popsaný feedback loop zvyšuje schopnost učení.

Špatný obsah vytváří dluh.

Nejasný obsah zvyšuje potřebu interpretace. Neudržovaný obsah degraduje. Neověřený obsah může vést AI i člověka špatným směrem.

Minimum requirement

Kritické knowledge artefakty musí být psány jako provozní schopnost, ne pouze jako poznámka.

20. Recommended artefact structure

AIFC doporučuje pro kritické dokumenty tuto strukturu:

Title
Status
Purpose
Context
Definitions
Rules / Requirements
Workflow or Behavior
AI Role
Human Ownership
Fallback
Examples / Anti-patterns
Metadata
Review
Related Artefacts
Summary

Ne každý dokument musí obsahovat vše.

Ale čím vyšší dopad artefakt má, tím více této struktury potřebuje.

Minimum requirement

Kritické artefakty musí mít Purpose, Owner, Status, Rules nebo Requirements a Review mechanismus.

21. Writing for Human Cockpit Layer

Human Cockpit Layer bude z obsahu vytahovat:

status,
ownera,
priority,
rozhodnutí,
rizika,
čekající approvals,
change proposals,
AI-generated návrhy,
deprecated části,
review needs.

Proto musí být obsah psán tak, aby šel rozdělit a zobrazit.

Dlouhé odstavce bez struktury jsou špatně použitelné.

Dobrá struktura umožní zobrazit:

kartu rozhodnutí,
kartu rizika,
kartu návrhu změny,
kartu skillu,
workflow step,
approval request,
maintenance item.

Minimum requirement

Artefakty, které mají být zobrazovány v Human Cockpit Layer, musí mít dostatečnou strukturu nebo metadata pro rozdělení na použitelné části.

22. Writing for AI agents

AI agent pracuje lépe, když artefakt obsahuje jasné instrukční části.

Doporučené sekce pro agenticky používaný artefakt:

Agent role
Allowed inputs
Allowed actions
Forbidden actions
Expected output
Approval rules
Uncertainty handling
Write-back rules
Fallback

Příklad:

Agent role:
Analyze submitted change proposals and prepare decision support.

Allowed actions:
Summarize, classify, identify risks, suggest decision level.

Forbidden actions:
Approve, reject or implement significant changes.

Write-back rules:
Create draft analysis linked to the proposal. Do not update active workflow directly.

Minimum requirement

AI-facing artefakty musí jasně popisovat allowed actions, forbidden actions a approval rules.

23. Writing for validation

Validátor potřebuje předvídatelnou strukturu.

Proto musí být validační pravidla formulována jednoznačně.

Příklad:

Every critical AI workflow MUST have fallback_defined: true.

Lépe než:

Critical AI workflows should have some kind of fallback if possible.

AIFC může používat slova:

MUST,
SHOULD,
MAY,
MUST NOT.

Minimum requirement

Validační požadavky musí být formulovány jednoznačně a navázány na metadata nebo strukturu.

24. Content lifecycle

Obsah se vyvíjí.

AIFC obsah může být:

draft
proposed
under_review
approved
active
deprecated
archived
rejected

Člověk i AI musí vědět, zda obsah slouží jako aktuální pravidlo.

Deprecated obsah může být užitečný historicky, ale nesmí být použit jako aktivní guidance.

Minimum requirement

Kritické artefakty musí mít lifecycle status a AI agenti musí respektovat, že ne každý text je aktuální pravda.

25. Content maintenance

Obsah bez péče degraduje.

To platí pro dokumentaci, workflow, skills, rozhodnutí, AI pravidla i hodnotový výklad.

Neudržovaný obsah vytváří:

znalostní dluh,
rozhodovací dluh,
AI ambiguity,
human attention debt,
security risk,
AI dependency risk,
onboarding debt.

AIFC obsah musí mít review a ownera.

Minimum requirement

Kritické knowledge artefakty musí mít review mechanismus a odpovědného ownera.

26. AI-generated content

AI-generated obsah musí být označen, pokud ještě nebyl schválen.

AI může vytvářet:

návrhy dokumentů,
shrnutí,
interpretace,
návrhy změn,
workflow,
skills,
rozhodovací podklady,
analýzy rizik.

Dokud není výstup schválen, je to návrh nebo interpretace.

Není to source of truth.

Minimum requirement

AI-generated knowledge artefakty musí mít status a review ownera před tím, než mohou být považovány za approved nebo active.

27. Human-approved content

Human-approved obsah je znalost, kterou odpovědný člověk nebo komunita přijala jako platnou.

Schválení musí být dohledatelné.

Může být zaznamenáno jako:

metadata status,
decision record,
approval log,
Git review,
governance decision,
cockpit approval.

Minimum requirement

Kritické schválené artefakty musí mít dohledatelný approval mechanismus.

28. Content migration

Při migraci z existující dokumentace musí být rozlišeno:

původní obsah,
AI extrakce,
AI interpretace,
lidsky schválený výsledek,
nejisté části,
konfliktní části,
deprecated části.

Migrace není jen přesun textu.

Je to transformace obsahu do struktury, která je použitelná pro komunitu, AI i validaci.

Minimum requirement

Migrovaný obsah nesmí být automaticky považován za approved source of truth, pokud nebyl zkontrolován nebo označen odpovídajícím confidence/status.

29. Conflict handling

Knowledge base může obsahovat konfliktní informace.

Konflikt může být mezi:

starým a novým dokumentem,
dvěma owners,
deklarovanou hodnotou a workflow,
AI interpretací a lidským rozhodnutím,
lokálním pravidlem a vyšší governance,
veřejným textem a internal source of truth.

Konflikt nesmí být skryt.

Musí být označen a převeden na:

review task,
change proposal,
decision record,
nebo governance issue.

Minimum requirement

Detekované konflikty v kritickém obsahu musí být označeny a přiřazeny ownerovi.

30. Recommended language patterns

AIFC doporučuje používat jasné jazykové vzory.

Purpose

This artefact exists to...

Rule

The community MUST...

AI limitation

AI may propose...
AI must not decide...

Human ownership

The responsible owner reviews and approves...

Fallback

If AI is unavailable, the workflow continues by...

Review

This artefact must be reviewed...

Uncertainty

Confidence is low because...

Change proposal

This observation should be processed as a change proposal because...

Minimum requirement

AIFC implementation guides should provide reusable language patterns for common artefacts.

31. Anti-patterns

AIFC odmítá následující anti-patterny.

31.1 Long text without structure

Člověk ani AI nemá jasnou navigaci.

31.2 Rules without context

Pravidla jsou krátká, ale neaplikovatelná v nových situacích.

31.3 Context without decision

Dokument dlouze vysvětluje situaci, ale není jasné, co platí.

31.4 AI suggestion as approved truth

AI výstup je uložen bez review jako platná znalost.

31.5 Mixed fact and interpretation

Není jasné, co je fakt, co je výklad a co je návrh.

31.6 Missing owner

Nikdo neodpovídá za obsah.

31.7 Missing status

Není jasné, zda je obsah draft, active, deprecated nebo rejected.

31.8 No uncertainty marking

Neověřený obsah působí jako jistý.

31.9 Human-hostile structure

Obsah je validovatelný, ale člověk ho neumí číst.

31.10 AI-hostile prose

Obsah je literárně pěkný, ale AI agent podle něj nemůže bezpečně jednat.

32. Minimal requirements

AIFC komunita musí v oblasti human and AI readable content minimálně splnit:

Kritické artefakty mají lidsky srozumitelný účel.
Kritické artefakty mají ownera.
Kritické artefakty mají status.
Kritická pravidla obsahují kontext.
AI-facing artefakty definují allowed actions.
AI-facing artefakty definují forbidden actions.
AI-facing artefakty definují approval rules.
AI-generated obsah je označen jako návrh, dokud není schválen.
Významná rozhodnutí obsahují důvod nebo odkaz na decision record.
Neúplné nebo nejisté informace označují confidence nebo review need.
Obsah rozlišuje fact, interpretation, proposal a decision.
Kritické artefakty mají review mechanismus.
Dlouhé artefakty mají navigovatelnou strukturu.
Human Cockpit Layer může z obsahu vytáhnout klíčové stavové informace.
Validátory mohou ověřit minimální governance požadavky.

33. Summary

AIFC obsah musí sloužit lidem, AI agentům i software validaci.

Člověk potřebuje význam, kontext a přehled.

AI agent potřebuje pravidla, hranice a očekávané chování.

Software potřebuje strukturu a ověřitelné požadavky.

Proto AIFC říká:

Protect human attention.
Reduce AI ambiguity.
Make critical knowledge verifiable.

Česky:

Chraňte lidskou pozornost.
Snižujte nejednoznačnost pro AI.
Dělejte kritické znalosti ověřitelnými.

Dobře napsaný obsah není jen informace.

Je to schopnost komunity.

Human and AI readable content turns knowledge into shared understanding and safe action.