/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
| zdroj | obsah |
|---|---|
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