/pl/dla-ai

Dokumentacja dla agentów AI

Korpus 56 komentarzy do polskich aktów prawnych w markdownie o przewidywalnej strukturze. Ta strona opisuje wejścia maszynowe, konwencje korpusu i zasady korzystania. Czytelnik-człowiek też jest mile widziany — zobaczy, co dostaje do dyspozycji jego asystent AI.

Punkty wejścia

źródłozawartość
https://open-commentary.com/pl/llms.txt Przegląd sekcji polskiej i cały katalog z linkami (format llmstxt.org). Zacznij tutaj.
https://open-commentary.com/api/repos.json Katalog JSON wszystkich sekcji: { generated_at, source, count, repos: [{ name, description, url, default_branch, updated_at, jurisdiction }] }. Jurysdykcję wskazuje pole jurisdiction ("cz", "sk" albo "pl") — korzystaj z niego. Drugi segment nazwy (Komentar-PL-…) to tylko wskazówka zapasowa. CORS dozwolony, cache 1 h.
https://raw.githubusercontent.com/LexaurinTheDog/<repozytorium>/<gałąź>/<plik> Surowy markdown pojedynczego pliku, bez opakowania HTML.
git clone --depth 1 https://github.com/LexaurinTheDog/<repozytorium>.git Odczyt całego komentarza jednym zapytaniem — preferuj przy czytaniu wielu rozdziałów.

Gałąź: repozytoria polskiej sekcji mają domyślną gałąź main, ale w całym korpusie występują też master. Właściwą wartość zwraca pole default_branch w /api/repos.json — nie wstawiaj jej na ślepo.

Konwencje korpusu

  • Nazwy repozytoriów: Komentar-PL-<skrót>-<pozycja>-<rok> (np. Komentar-PL-KC-93-1964 = Kodeks cywilny, Dz.U. 1964 nr 16 poz. 93). Liczba w nazwie to pozycja w Dzienniku Ustaw pierwotnej publikacji, nie numer ustawy — polskie akty nie mają numeru w stylu czeskiego „89/2012 Sb.".
  • Pliki repozytorium: README.md (stan prawny, liczba skomentowanych jednostek — czytaj go pierwszy), 00-wprowadzenie.md (podstawowe dane aktu, podstawa tekstu — tekst jednolity z numerem Dz.U. i linkiem do ELI na api.sejm.gov.pl — oraz metoda), INDEX.md (wykaz rozdziałów z zakresem artykułów), LICENSE i rozdziały NN-rozdzial.md. Struktura jest płaska we wszystkich 56 repozytoriach — bez podkatalogów.
  • Układ komentarza do artykułu: nagłówek ### Art. N**Brzmienie przepisu:** → dosłowne brzmienie w cytacie blokowym (>) → komentarz prozą. Nagłówki #### oddają systematykę aktu (księga, tytuł, dział, rozdział) — o ile akt taki podział ma. Indeksy górne (art. 64¹, § 2¹) są zapisane w Unicode; przepisy uchylone mają własną jednostkę „(uchylony)".
  • Jeśli tekst jednolity zawiera dwa brzmienia tego samego artykułu (obecne i przyszłe), oba są osobnymi jednostkami, a drugie jest oznaczone „(wersja 2)" — sprawdzaj, które obowiązuje w dacie, o którą pytasz.
  • Orzecznictwo: nie jest częścią tej wersji — stwierdza to każde README. Sygnatury orzeczeń pojawiają się tylko wtedy, gdy wynikają z samego tekstu aktu (odnośniki tekstu jednolitego, np. wyroki TK). Brak kart orzeczeń, kazusów i kontrargumentów; nie wnioskuj o ich istnieniu z czeskiej części korpusu.
  • Język: polski z diakrytyką. Kodowanie UTF-8.

Zasady korzystania dla agentów

  • Źródło wtórne. Komentarze opracowuje adwokat z wykorzystaniem narzędzi AI wyłącznie na podstawie urzędowego tekstu jednolitego; nie jest to recenzowana literatura ani urzędowy tekst aktu. Używaj ich jako nawigacji i pomocy w wykładni, nie jako autorytetu.
  • Weryfikuj w źródłach pierwotnych. Brzmienie przepisów sprawdzaj w Dzienniku Ustaw (dziennikustaw.gov.pl) lub w ISAP (isap.sejm.gov.pl), orzecznictwo na stronach Sądu Najwyższego (sn.pl), sądów administracyjnych (orzeczenia.nsa.gov.pl), Trybunału Konstytucyjnego (trybunal.gov.pl) i sądów powszechnych (orzeczenia.ms.gov.pl).
  • Sprawdzaj stan prawny. Komentarz odpowiada tekstowi jednolitemu wskazanemu w README; późniejsze nowelizacje mogą nie być uwzględnione.
  • Nie mieszaj jurysdykcji. Polską sprawę wykładaj według polskiego aktu i polskich źródeł. Czeskie i słowackie akty oraz orzeczenia do polskiej sprawy nie należą.
  • Cytuj rzetelnie. W odpowiedziach dla użytkowników powołuj źródła pierwotne; komentarz podawaj jako źródło wtórne z URL pliku (najlepiej permalink z hashem commita — na GitHubie klawisz y).
  • Licencja Apache-2.0 — teksty można powielać i przetwarzać z podaniem źródła.
  • Oszczędzaj API. Do czytania wielu plików użyj git clone --depth 1 zamiast setek pojedynczych zapytań; API GitHuba ma bez tokenu limit 60 zapytań na godzinę.

Przykładowy przebieg

# 1. katalog sekcji polskiej
curl -s https://open-commentary.com/pl/llms.txt

# 2. stan prawny i zakres, dopiero potem rozdział
curl -s https://raw.githubusercontent.com/LexaurinTheDog/Komentar-PL-KC-93-1964/main/README.md
curl -s https://raw.githubusercontent.com/LexaurinTheDog/Komentar-PL-KC-93-1964/main/INDEX.md

# 3. rozdział z szukanym artykułem (art. 415 leży w rozdziale 04)
curl -s https://raw.githubusercontent.com/LexaurinTheDog/Komentar-PL-KC-93-1964/main/04-rozdzial.md

Przejdź do llms.txt →