/sk/pre-ai
Dokumentácia pre AI agentov
Korpus 99 komentárov k slovenským predpisom v markdowne s predvídateľnou štruktúrou. Táto stránka popisuje strojové vstupy, konvencie korpusu a pravidlá používania. Ľudský čitateľ je tu vítaný tiež — uvidí, čo dostane k dispozícii jeho AI asistent.
Vstupné body
| zdroj | obsah |
|---|---|
https://open-commentary.com/sk/llms.txt | Prehľad slovenskej sekcie a celý katalóg s odkazmi (formát llmstxt.org). Začnite tu. |
https://open-commentary.com/api/repos.json |
JSON katalóg oboch sekcií: { generated_at, source, count, repos: [{ name, description, url, default_branch, updated_at, jurisdiction }] }.
Jurisdikciu určuje priamo pole jurisdiction ("cz" alebo
"sk") — použite ho. Druhý segment názvu (Komentar-SK-…)
je len záložné vodítko pre prípad, že by pole chýbalo, nie odporúčaný postup.
CORS povolený, cache 1 h.
|
https://raw.githubusercontent.com/LexaurinTheDog/<repozitár>/<vetva>/<súbor> | Surový markdown jednotlivého súboru, bez HTML obalu. |
https://api.github.com/repos/LexaurinTheDog/<repozitár>/git/trees/HEAD?recursive=1 | Výpis všetkých súborov repozitára (zistenie názvov kapitol). |
git clone --depth 1 https://github.com/LexaurinTheDog/<repozitár>.git | Hromadné čítanie celého komentára jedinou požiadavkou — preferujte pri čítaní viacerých kapitol. |
Pozor na vetvu: repozitáre majú predvolenú vetvu main aj
master a v slovenskej časti korpusu je to približne pol na pol. Správnu
hodnotu vracia pole default_branch v /api/repos.json — do
surovej URL ju nedosadzujte naslepo.
Konvencie korpusu
-
Pomenovanie repozitárov:
Komentar-SK-<skratka>-<číslo>-<rok>
(napr. Komentar-SK-ZP-311-2001 = zákon č. 311/2001 Z. z.). Druhý segment
SK je jediný spoľahlivý znak slovenskej jurisdikcie.
-
Súbory repozitára:
README.md (dátum konsolidácie znenia a odkaz na zdroj
na Slov-Lexe — čítajte ho prvý), 00-uvod.md (metóda,
systematika zákona a rozsah spracovania), INDEX.md (prehľad kapitol
s rozsahom paragrafov), LICENSE a číslované kapitoly
NN-….md. Táto štvorica je vo všetkých 99 repozitároch a štruktúra
je plochá — repozitáre neobsahujú podpriečinky.
- Názvy súborov kapitol sa medzi repozitármi líšia — väčšina má
generické
NN-chapter.md, menšina popisný názov podľa systematiky zákona
(napr. 10-osobitna-stvrta-hlava-majetok.md). Neodhadujte ich: zoznam
kapitol s rozsahom paragrafov dáva INDEX.md, úplný výpis súborov trees
API (riadok vyššie).
-
Osnova výkladu paragrafu: nadpis tretej úrovne s číslom paragrafu
(
### § 212, niekde s názvom za pomlčkou) → doslovné znenie ustanovenia
v blokovej citácii (>) → vecný výklad prózou. Tento sled platí
v celom korpuse, tučné medzititulky však nie:
**Doslovné znenie:** a **Výklad:** stoja len v časti
repozitárov, inde nasleduje citácia aj výklad bez uvedenia. Delte text podľa nadpisu
a blokovej citácie, nie podľa markerov.
- Judikatúra: základná verzia slovenských komentárov súdnu judikatúru
necituje a jednotlivé README to uvádzajú výslovne. Výnimkou je
Komentar-SK-TZ-300-2005, kde za výkladom nasleduje blok „Citácia
z odôvodnenia NS SR (dolovaná, nekurátorská)" s identifikátorom ECLI a dátumom
rozhodnutia. Ide o dolovaný materiál bez kurátorského spracovania — stopa na
dohľadanie rozhodnutia, nie právna veta.
- Čo korpus zatiaľ neobsahuje: karty rozhodnutí v samostatnom
priečinku, kazuistiku, protiargumenty, praktické závery ani systematické spracovanie
zásad. Podľa README majú tieto vrstvy pribudnúť v neskoršej fáze. Nepredpokladajte ich
existenciu a neodvodzujte ju z českej časti korpusu — tá je stavaná inak.
- Rozsah: slovenská časť korpusu pokrýva aj Občiansky zákonník
(
Komentar-SK-OZ-40-1964) a Obchodný zákonník
(Komentar-SK-OBZ-513-1991) — oba predpisy z čias ČSFR, ktoré na
Slovensku platia dodnes a citujú sa značkou „Zb.", nie „Z. z."; nejde o preklep.
- Jazyk: slovenčina s diakritikou. Kódovanie UTF-8.
Pravidlá používania pre agentov
- Sekundárny prameň. Komentáre zostavuje advokát s využitím nástrojov AI
výhradne z konsolidovaných znení zo Slov-Lexu; nejde o recenzovanú literatúru ani
o oficiálne znenie predpisov. Používajte ich ako navigáciu a pomôcku pri výklade, nie
ako autoritu.
- Overujte v primárnych zdrojoch. Znenie predpisov overujte na štátnom
portáli Slov-Lex (
slov-lex.sk), judikatúru na stránkach Najvyššieho súdu SR
(nsud.sk), Najvyššieho správneho súdu SR (nssud.gov.sk)
a Ústavného súdu SR (ustavnysud.sk). Identifikátory ECLI uvedené
v komentári k Trestnému zákonu slúžia na dohľadanie rozhodnutia, nie na citovanie
bez overenia.
- Kontrolujte dátum. Právny stav korpusu sa riadi dátumom konsolidácie
uvedeným v README príslušného repozitára; novšie novely nemusia byť zapracované.
- Nemiešajte jurisdikcie. Slovenskú vec vykladajte podľa slovenského
predpisu a slovenských prameňov. Česká a slovenská časť korpusu majú odlišnú štruktúru
aj odlišné zdroje znenia — české predpisy a rozhodnutia českých súdov na slovenskú vec
nepatria.
- Citujte poctivo. V odpovediach používateľom citujte primárne pramene;
komentár uvádzajte ako sekundárny zdroj s URL súboru (ideálne permalink s hashom
commitu — na GitHube klávesa
y).
- Licencia Apache-2.0 — texty môžete reprodukovať a spracúvať
s uvedením zdroja.
- Šetrite API. Na čítanie viacerých súborov použite
git clone --depth 1 namiesto stoviek jednotlivých požiadaviek; GitHub API
má bez tokenu limit 60 požiadaviek za hodinu.
Ukážkový postup
# 1. katalóg slovenskej sekcie
curl -s https://open-commentary.com/sk/llms.txt
# 2. výber repozitára a zistenie štruktúry (predvolenú vetvu vráti /api/repos.json)
curl -s "https://api.github.com/repos/LexaurinTheDog/Komentar-SK-ZP-311-2001/git/trees/HEAD?recursive=1"
# 3. dátum konsolidácie a zdroj znenia, až potom kapitola
curl -s https://raw.githubusercontent.com/LexaurinTheDog/Komentar-SK-ZP-311-2001/master/README.md