ai:platformy:rag-a-memory:open-knowledge-format-okf

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

ai:platformy:rag-a-memory:open-knowledge-format-okf [01.07.2026 07:59] – Vytvoření článku o Open Knowledge Format OKF Petr Nosekai:platformy:rag-a-memory:open-knowledge-format-okf [01.07.2026 08:01] (aktuální) – Oprava překlepů v článku o OKF Petr Nosek
Řádek 7: Řádek 7:
 ===== Co OKF řeší ===== ===== Co OKF řeší =====
  
-V softwarovém projektu bývají důležité znalosti rozptýlené mezi README, wiki, issues, komentáře v kódu, databázové migrace, OpenAPI specifikace a historii chatu. Člověk si kontext často dohledá, ale AI agent potřebuje kratší, strukturované a dobře odkazované dokumenty.+V softwarovém projektu bývají důležité znalosti rozptýlené mezi README, wiki, issues, komentáře v kódu, databázové migrace, OpenAPI specifikace a historii chatů. Člověk si kontext často dohledá, ale AI agent potřebuje kratší, strukturované a dobře odkazované dokumenty.
  
 OKF se na to dívá jako na balíček znalostí. Každý dokument popisuje jeden koncept: doménovou entitu, API endpoint, databázovou tabulku, architektonické rozhodnutí, runbook, metriku nebo externí referenci. OKF se na to dívá jako na balíček znalostí. Každý dokument popisuje jeden koncept: doménovou entitu, API endpoint, databázovou tabulku, architektonické rozhodnutí, runbook, metriku nebo externí referenci.
Řádek 84: Řádek 84:
 ===== Použití při vývoji aplikace ===== ===== Použití při vývoji aplikace =====
  
-==== Projektová paměť ==== +==== Projektová paměť ====
  
 OKF může fungovat jako projektová paměť uložená přímo v repozitáři. Před větší změnou si vývojář nebo AI agent načte související dokumenty a získá kontext, který není zřejmý jen ze zdrojového kódu. OKF může fungovat jako projektová paměť uložená přímo v repozitáři. Před větší změnou si vývojář nebo AI agent načte související dokumenty a získá kontext, který není zřejmý jen ze zdrojového kódu.
Řádek 96: Řádek 96:
   * ''runbooks/debug-payment-failure.md'' — jak řešit běžné problémy.   * ''runbooks/debug-payment-failure.md'' — jak řešit běžné problémy.
  
-==== Dokumentace domény ==== +==== Dokumentace domény ====
  
 Doménové pojmy se dají dokumentovat jako samostatné koncepty. To pomáhá hlavně tam, kde názvy tříd nebo tabulek nestačí k pochopení business významu. Doménové pojmy se dají dokumentovat jako samostatné koncepty. To pomáhá hlavně tam, kde názvy tříd nebo tabulek nestačí k pochopení business významu.
Řádek 109: Řádek 109:
 Každý koncept může odkazovat na API, databázové tabulky, rozhodnutí a runbooky. Tím vznikne graf vztahů, ne jen strom dokumentace. Každý koncept může odkazovat na API, databázové tabulky, rozhodnutí a runbooky. Tím vznikne graf vztahů, ne jen strom dokumentace.
  
-==== Architektonická rozhodnutí ==== +==== Architektonická rozhodnutí ====
  
 OKF se hodí i pro záznam rozhodnutí. AI agent pak při refaktoringu ví, proč daný návrh existuje, a nebude ho omylem rušit jako „zbytečnou složitost“. OKF se hodí i pro záznam rozhodnutí. AI agent pak při refaktoringu ví, proč daný návrh existuje, a nebude ho omylem rušit jako „zbytečnou složitost“.
  • ai/platformy/rag-a-memory/open-knowledge-format-okf.1782885591.txt.gz
  • Poslední úprava: 01.07.2026 07:59
  • autor: Petr Nosek