Lex Machina to zestaw 32 skilli (host-neutralnych Agent Skills) tworzących kompletny warsztat pracy z polskim prawem:

Zasada naczelna: brak numeru artykułu jest lepszy niż błędny numer artykułu; brak sygnatury jest lepszy niż sygnatura nieweryfikowana lub fałszywa.

1. Pobierz repozytorium (Code → Download ZIP lub git clone)
2. Wgraj skille do Claude AI w kolejności: shared/ → routing → DR → wykonawcze (pełna instrukcja)
3. Ustaw User Preferences w Claude AI:

   Prawo PL: router→v3 pierwszy, ISAP każdy przepis, HYBRID-VAL przed .docx. Karne: +kwalifikator.
   

4. Otwórz nową rozmowę i napisz: „Mam sprawę prawną. Od czego zacząć?"

flowchart TB
    U([👤 Użytkownik]) --> R

    subgraph ROUTING["🧭 Warstwa routingu"]
        R[prawny-router-v3<br/>tryb PRAWNIK / LAIK] --> PP[prawo-polskie-v2<br/>ROUTING-MAP]
    end

    subgraph DR["📚 Dziedziny prawa — DR-01 … DR-16"]
        D1[dr-01 ustrój] ~~~ D2[dr-02 cywilne] ~~~ D3[dr-03 karne] ~~~ DN[… dr-16 pisma/strategia]
    end

    subgraph EXEC["🛠️ Skille wykonawcze"]
        E1[pisma-procesowe-v3] ~~~ E2[analiza-sadowa-v6] ~~~ E3[analizator-umow / dowodow] ~~~ E4[raporty / przesłuchania]
    end

    subgraph SHARED["🛡️ shared/ — biblioteka współdzielona"]
        S1[PRAWO-HARDGATE v2.0<br/>ŹRÓDŁO-0: API ELI/SAOS/CELLAR] ~~~ S2[SYGNATURY v1.1<br/>FOUND / NOT_FOUND / AMBIGUOUS] ~~~ S3[WERYFIKACJA-SLAD v1.1<br/>gradient ISTNIENIE/TREŚĆ/FRAGMENT] ~~~ S4[MOD-AUDIT-BUNDLE<br/>AI Act art. 12]
    end

    AUD[📋 audyt-systemu-v4<br/>AUDIT-JOURNAL + mapa Dz.U.]

    PP --> DR
    DR --> EXEC
    ROUTING -.obowiązkowe bramki.-> SHARED
    DR -.-> SHARED
    EXEC -.-> SHARED
    AUD -. audytuje .-> ROUTING & DR & EXEC & SHARED

Przepływ sprawy: router klasyfikuje sprawę i tryb → ładuje właściwe moduły DR (lazy loading: jeden moduł = jeden akt prawny) → skill wykonawczy realizuje zadanie → każde powołanie przepisu/orzeczenia przechodzi przez bramki shared/ → wynik z widocznym śladem weryfikacji.

Obie wersje — stabilna (8.09.2026) i rozwojowa — są w pełni wieloplatformowe. Ten sam zestaw skilli działa na Claude, na hostach zgodnych z OpenAI (ChatGPT, Codex, API, Atlas) oraz na Grok, bez przepisywania metodologii, HARD GATE ani bramek jakości. Działanie na Claude i ChatGPT zostało potwierdzone testami całego zestawu. Wieloplatformowość nie jest już cechą wyłącznie kanału rozwojowego: warstwa portowalności została promowana do wersji stabilnej i w obu katalogach jest identyczna co do bajtu. Skille to zwykły Markdown czytany pod wspólnym adapterem, więc nazwy operacji odziedziczone z jednego runtime są traktowane jako semantyka, nie jako wymóg konkretnego API danego dostawcy.

Grok — automatyczne pobranie z repozytorium. Grokowi wystarczy wskazać repozytorium (URL GitHub) i którą wersję ma wziąć — rozwojową (Wersja rozwojowa rozpakowana/) albo stabilną (Wersja stabilna rozpakowana 8.09.2026/) — obie niosą warstwę host-neutralną. Grok pobiera i instaluje skille samodzielnie, bez ręcznego wgrywania folderów. Reguły sterujące (odpowiednik User Preferences) wskazujesz w jego instrukcjach/personalizacji tak samo jak na pozostałych hostach — patrz Instalacja.

Warstwa portowalności — obecna w obu kanałach (stabilnym i rozwojowym):

Zasady adaptera:

• Fail-closed — jeżeli obowiązkowy zasób nie może zostać świeżo odczytany, skill zatrzymuje się; nie zastępuje go pamięcią modelu.
• Bramki bez zmian — PRAWO-HARDGATE, TEMPORAL-LAW-CHECK, LEGAL-QUALITY-GATE działają identycznie na każdym hoście. Brak natywnego generatora DOCX/PDF nie znosi walidacji — obniża jedynie format wyjścia do raportu strukturalnego.
• Prywatność — statyczne widgety i skrypty nie wysyłają danych bezpośrednio do żadnego dostawcy AI; wysyłka do zewnętrznego API tylko przez hosta i po jawnej decyzji użytkownika. Domyślna anonimizacja jest lokalna i deterministyczna.
• Ścieżki — zapis shared/PLIK.md oznacza kanoniczny zasób zainstalowanego skilla, a nie konkretny katalog systemowy; historyczne ścieżki /mnt/... są normalizowane do skill/path.

Wieloplatformowość jest pełna — i potwierdzona w praktyce. Skille to zwykły Markdown w standardzie Agent Skills; nie zawierają kodu ani wywołań API związanych z konkretnym dostawcą, więc działają na każdym hoście, który potrafi wczytać skill i wykonać operacje opisane w adapterze. Cały zestaw został przetestowany z powodzeniem na Claude i na ChatGPT — te same bramki, ta sama metodologia, ten sam wynik merytoryczny, bez żadnej wersji „portowanej" ani osobnej gałęzi kodu. Grok instaluje ten sam zestaw, pobierając go wprost z repozytorium (Krok 6).

Jedyna różnica między hostami jest rejestracyjna, nie funkcjonalna: 31 z 32 katalogów niesie agents/openai.yaml, dzięki czemu pojawia się samodzielnie w katalogu skilli hosta OpenAI; analizator-dowodow-v3 tego manifestu nie ma, więc uruchamia się przez router zamiast z listy. Analogicznie brak pola compatibility: w modułach dr-01 … dr-16 niczego nie blokuje — wymagane operacje hosta rozstrzyga wtedy adapter runtime.

Lex-Machina/
├── README.md                                ← ten plik
├── LICENSE                                  ← GNU GPL v3
├── DOKUMENTACJA-WDROZENIOWA-2026-07-13.md   ← dokumentacja wdrożeniowa systemu
├── claude_desktop_config.json               ← przykładowa konfiguracja konektorów MCP
├── benchmark/                               ← wyniki testów na bankach kazusów (per data)
├── WERSJA STABILNA 8.09.2026/               ← skille spakowane (.zip) — wersja stabilna
├── WERSJA ROZWOJOWA/                        ← skille spakowane (.zip) — wersja rozwojowa
├── Wersja stabilna rozpakowana 8.09.2026/   ← źródła skilli — wersja stabilna
│                                              (host-neutralna: Claude / OpenAI / Grok)
└── Wersja rozwojowa rozpakowana/            ← źródła skilli — tu trafiają bieżące zmiany
    ├── shared/                              ← bramki (PRAWO-HARDGATE, SYGNATURY,
    │   │                                      WERYFIKACJA-SLAD), UNIVERSAL-RUNTIME-ADAPTER,
    │   │                                      moduły MOD-*, definicje
    │   └── tools/                           ← skrypty audytowe + mcp-servers/ (przykłady
    │                                          konektorów: ISAP/ELI, SAOS, EUR-Lex, KRS…)
    │   (każdy skill: agents/openai.yaml + PORTABILITY-MANIFEST.md — warstwa host-neutralna)
    ├── prawny-router-v3/                    ← orkiestrator
    ├── prawo-polskie-v2/                    ← mapa routingu dziedzin
    ├── przewodnik-prawny-v2/                ← punkt wejścia dla laika
    ├── dr-01-… … dr-16-…/                   ← 16 dziedzin prawa
    ├── analiza-sadowa-v6/                   ┐
    ├── analizator-dowodow-v3/               │
    ├── analizator-przepisow-v2/             │
    ├── analizator-umow-v1/                  │
    ├── chronologia-sprawy-v1/               │
    ├── orzeczenia-sadowe-v2/                ├─ skille wykonawcze
    ├── pisma-procesowe-v3/                  │
    ├── pisma-proste-v2/                     │
    ├── przesluchanie-swiadkow-v2-min90/     │
    ├── raport-klienta-v1/                   │
    ├── raport-sytuacyjny-v2/                ┘
    ├── *_build/                             ← katalogi robocze buildów — NIE wgrywać
    └── audyt-systemu-v4/                    ← governance: modules/, references/
                                               (AUDIT-JOURNAL, mapy Dz.U.), scripts/, widgets/

Katalog wersji stabilnej ma tę samą strukturę — łącznie z warstwą host-neutralną (agents/openai.yaml, PORTABILITY-MANIFEST.md, adapter runtime w shared/). Każdy skill to folder z SKILL.md w korzeniu — wgrywa się cały folder skilla, niezależnie od hosta.

Dziennik audytów to pełny ślad forensyczny (ponad 950 sesji, dowody reprodukcji — materiał dla audytora i pod AI Act art. 12), nie codzienna lektura. Aby poznać aktualny stan i granice systemu, użytkownik ma trzy zwięzłe punkty wejścia:

Znane granice pokrycia (na dzień ostatniego audytu): m.in. KKW (moduł istnieje, ale bez treści artykułów KKW), PPSA (brak dedykowanego modułu — rozproszone cytaty), SUS rozdz. 2 (zasady podlegania ubezpieczeniom), Układ w Prawie restrukturyzacyjnym. Pełna lista i priorytety: indeks raportów pokrycia. System uczciwie odnotowuje luki, zamiast je maskować — zgodnie z zasadą naczelną.

Fundament systemu — pliki w shared/, obowiązkowe dla wszystkich skilli:

Żaden przepis, numer Dz.U., stawka, termin ani sygnatura nie może paść bez weryfikacji online w tym samym kroku. Hierarchia źródeł (od najsilniejszego):

POZIOM A  🔌 konektory MCP (verify_article, verify_signature — gdy skonfigurowane)
POZIOM B  🌐 strukturalne API:  api.sejm.gov.pl/eli (akty + łańcuch t.j.)
                                saos.org.pl/api (sygnatury) · EUR-Lex/CELEX (UE)
POZIOM C  🔍 web_search / web_fetch — wyłącznie fallback

Zawsze najnowszy tekst jednolity (deterministycznie przez endpoint ELI /references), weryfikacja przedmiotu aktu (tytuł vs teza), specjalny reżim dla wyroków TK 2024–2026.

Każda weryfikacja sygnatury kończy się jednym z czterech statusów — bez zgadywania:

Poziom weryfikacji musi odpowiadać sile twierdzenia — zamyka lukę „prawdziwy cytat, fałszywa teza":

ISTNIENIE  → samo powołanie kotwicy (sygnatura, nr Dz.U.)
TREŚĆ      → parafraza („SN przyjął, że…")
FRAGMENT   → cytat dosłowny / pinpoint

• guard STRON (sygnatura realna doczepiona do innej sprawy = 🔴 blokada)
• reguła kalibracji (twierdzisz FRAGMENT, osiągasz TREŚĆ → 🟠 złagodź tezę)
• widoczny ślad weryfikacji w każdej odpowiedzi (✅ [VER: źródło, data]).

Paczka audytowa deliverable: manifest JSON, sumy SHA-256, metadane (model, tryb, źródła, zatwierdzający), jawne statusy MISSING. Dowód dla audytora i compliance — nigdy załącznik do pisma.

Lex Machina nie przeszukuje internetu "na ślepo" — każde wyszukiwanie trafia do skatalogowanej bazy źródeł o przypisanym rzędzie wiarygodności. Rejestry kanoniczne: shared/HIERARCHIA-ZRODEL.md (kategoryzacja wiarygodności Rząd 1 / 2A / 2B / 3) oraz shared/PORTALE-BRANZOWE-RZAD-2B.md (mapa portali per dziedzina DR, z empirycznymi testami site:, wersja 2.1).

Integracja jako źródła wyszukiwania (router v3.17, 2026-07-21): oba rejestry istniały wcześniej, ale nie były ładowane przez żaden skill. Teraz HIERARCHIA-ZRODEL.md i PORTALE-BRANZOWE-RZAD-2B.md są w required_modules orkiestratora prawny-router-v3, więc każda sprawa prowadzona przez router — a przez to każdy uruchamiany przez niego skill DR — ma dostęp do kategoryzacji wiarygodności i mapy portali branżowych.

Nigdy nie służą jako brzmienie przepisu ani dowód istnienia orzeczenia — zawsze ze znacznikiem źródła pomocniczego.

Portale oznaczone jako AI-wspomagane (np. egospodarka.pl — część artykułów generowana przez AI) system traktuje z podwyższoną ostrożnością i krzyżuje z innym źródłem przy kluczowych ustaleniach.

Rejestr uczciwie odnotowuje dziedziny bez dominującego portalu branżowego (DR-03 karne, DR-05 administracyjne, DR-15 compliance) — tam system korzysta z portali generalistycznych z zawężonym zapytaniem.

Dopuszczone wyłącznie jako trop do dalszej weryfikacji — wysokie ryzyko dezaktualizacji, obowiązkowe skrzyżowanie z Rzędem 1/2A przed użyciem.

Wymagania: konto na jednym z obsługiwanych hostów — claude.ai, host zgodny z OpenAI (ChatGPT / Codex / API / Atlas) albo Grok. Skille wymagają planu, w którym host udostępnia wgrywanie skilli · przeglądarka — bez instalacji oprogramowania.

Inne hosty: host-neutralne są obie wersje — stabilna (8.09.2026) i rozwojowa (wspólny adapter runtime). Kroki 1–4 opisują ścieżkę Claude AI; Krok 5 — instalację w ChatGPT (hosty zgodne z OpenAI), a Krok 6 — w Grok, który pobiera skille wprost z repozytorium po wskazaniu wersji. Na każdym hoście te same reguły trafiają do jego instrukcji/personalizacji, a bramki jakości są identyczne.

git clone https://github.com/michaleiatrak-star/Lex-Machina.git

Prawo PL: router→v3 pierwszy, ISAP każdy przepis, HYBRID-VAL przed .docx. Karne: +kwalifikator.

api.sejm.gov.pl
eli.gov.pl
isap.sejm.gov.pl
gov.pl

Prawo PL: router→v3 pierwszy, ISAP każdy przepis, HYBRID-VAL przed .docx. Karne: +kwalifikator.

Cowork (aplikacja desktop Claude, plany płatne) pozwala uruchamiać skille systemu automatycznie według harmonogramu — typowo cykliczny audyt audyt-systemu-v4 (monitoring nowych Dz.U., zamykanie flag WARN).

Uruchom audyt systemu w trybie graficznym w Cowork i wybierz automatyzację systemu - weryfikacje dzienników ustaw, system poprowadzi cię automatycznie.

Zadanie startuje w świeżej sesji: prompt musi być samowystarczalny i musi precyzować zakres audytu. Samo „przeprowadź audyt" uruchamia w audyt-systemu-v4 interaktywne menu wyboru (FAZA 0B), na które w sesji automatycznej nikt nie odpowie. Wskazuj wprost tryb z sekcji „TRYBY WYWOŁANIA" w audyt-systemu-v4/SKILL.md:

• Zadanie lokalne wykonuje się tylko przy otwartej aplikacji i niewyłączonym komputerze; pominięty termin → jeden przebieg nadrabiający po wybudzeniu. Zadania niezależne od komputera twórz jako zdalne routines (chmura Anthropic).
• Wynik każdego przebiegu pojawia się jako sesja w sekcji Scheduled — sprawdź, czy audyt zakończył się obowiązkowym wpisem w AUDIT-JOURNAL.md (FAZA 7).
• Wszystkie bramki systemu (HARDGATE, weryfikacja online, ZASADA 7) obowiązują również w sesjach automatycznych — skille shared/ i audyt-systemu-v4/ muszą być wgrane na koncie, na którym działa Cowork.

Zmiana wobec poprzednich wydań: do 21.08.2026 warstwa host-neutralna była wyłączną cechą kanału rozwojowego, a wersja stabilna niosła profil wyłącznie Claude AI. Wraz z wydaniem 8.09.2026 warstwa została promowana do wersji stabilnej — oba katalogi mają dziś identyczną zawartość, więc wybór kanału nie wpływa już na to, na jakim hoście system zadziała.

Każda zmiana w systemie jest odnotowana w dzienniku audytów (audyt-systemu-v4/references/AUDIT-JOURNAL.md) — format: jedna sekcja ## AUDYT-YYYY-MM-DD na sesję, z tabelą zmienionych plików, naprawami i otwartymi flagami. Bieżący zakres „do zrobienia" (bez przekopywania całego dziennika) trzyma references/WARN-OTWARTE.md. Aktualność numerów Dz.U. pilnowana jest w centralnej mapie (audyt-systemu-v4/references/mapa_dzu_*.md).

Lex Machina dostarcza informację prawną, nie poradę prawną.

• System jest narzędziem wspomagającym — nie zastępuje adwokata ani radcy prawnego; w sprawach o istotnej wadze skonsultuj się z profesjonalnym pełnomocnikiem.
• Mimo wielowarstwowych bramek weryfikacyjnych każdy przepis i każdą sygnaturę zweryfikuj samodzielnie w źródłach oficjalnych (isap.sejm.gov.pl, sn.pl, orzeczenia.ms.gov.pl) przed użyciem w postępowaniu.
• Wygenerowane pisma mają status DRAFT do czasu ich świadomej akceptacji przez człowieka.
• Stan prawny zmienia się stale — mapy aktów są „zdjęciem" na datę ostatniego audytu.

Błędy, sugestie i propozycje zmian → Issues

Projekt udostępniony na licencji GNU GPL v3.