/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

zdrojobsah
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

Prejsť na llms.txt →