/pro-ai

Dokumentace pro AI agenty

Korpus 94 komentářů k českým zákonům v markdownu s předvídatelnou strukturou. Tato stránka popisuje strojové vstupy, konvence a pravidla užití. Lidský čtenář je tu vítán taky — uvidí, co jeho AI asistent dostane k dispozici.

Vstupní body

zdrojobsah
https://open-commentary.com/llms.txt Přehled projektu + kompletní katalog s odkazy (formát llmstxt.org). Začněte zde.
https://open-commentary.com/api/repos.json JSON katalog: { generated_at, source, count, repos: [{ name, description, url, default_branch, updated_at }] }. CORS povolen, cache 1 h.
https://raw.githubusercontent.com/LexaurinTheDog/<repo>/<branch>/<file> Surový markdown jednotlivého souboru, bez HTML obalu.
https://api.github.com/repos/LexaurinTheDog/<repo>/git/trees/HEAD?recursive=1 Výpis všech souborů repozitáře (zjištění názvů kapitol).
git clone --depth 1 https://github.com/LexaurinTheDog/<repo>.git Hromadné čtení celého komentáře jedním požadavkem — preferujte při čtení více kapitol.

Pozor na branch: repozitáře mají default branch main i master. Správnou hodnotu vrací pole default_branch v /api/repos.json — do raw URL ji nedosazujte naslepo.

Konvence korpusu

  • Pojmenování repozitářů: Komentar-<zkratka>-<číslo>-<rok> (např. Komentar-OZ-89-2012 = zákon č. 89/2012 Sb.). Několik starších má slovní název (komentar-trestni-zakonik).
  • Kapitoly: NN-cast…-hlava….md číslované podle systematiky zákona. README.md obsahuje obsah a datum konsolidace znění — vždy jej přečtěte první.
  • Osnova výkladu paragrafu: znění → výklad → vazby → kazuistika (modelová situace, subsumpce, řešení) → protiargumenty a rizika → praktický závěr s checklistem.
  • judikatura/: karty rozhodnutí pojmenované <SOUD>-<spisová-značka>.md (např. NS-29-NSCR-14-2015.md) s právní větou a odkazem na plný text.
  • Jazyk: čeština s diakritikou. Kódování UTF-8.

Pravidla užití pro agenty

  • Sekundární pramen. Komentáře sestavuje advokát s využitím AI nástrojů; nejde o recenzovanou literaturu ani o oficiální znění předpisů. Používejte je jako navigaci a výkladové vodítko, ne jako autoritu.
  • Ověřujte primárně. Znění paragrafů ověřujte v e-Sbírce (e-sbirka.cz) či na zakonyprolidi.cz; judikaturu na nsoud.cz, nssoud.cz a usoud.cz. Spisové značky v kartách judikatury jsou určeny k dohledání, nikoli k slepému citování.
  • Kontrolujte datum. Právní stav korpusu se řídí datem konsolidace v README daného repozitáře; novější novely nemusí být zapracovány.
  • Citujte poctivě. V odpovědích uživatelům citujte primární prameny; komentář uvádějte jako sekundární zdroj s URL souboru (ideálně permalink s commit hashem přes y na GitHubu).
  • Licence Apache-2.0 — texty smíte reprodukovat a zpracovávat s uvedením zdroje.
  • Šetřete API. Pro čtení více souborů použijte git clone --depth 1 místo stovek jednotlivých requestů; GitHub API má limit 60 req/h bez tokenu.

Ukázkový postup

# 1. katalog
curl -s https://open-commentary.com/api/repos.json

# 2. výběr repozitáře a zjištění struktury (default_branch z kroku 1!)
curl -s "https://api.github.com/repos/LexaurinTheDog/Komentar-OZ-89-2012/git/trees/HEAD?recursive=1"

# 3. čtení kapitoly
curl -s https://raw.githubusercontent.com/LexaurinTheDog/Komentar-OZ-89-2012/main/README.md

Přejít na llms.txt →