⚖️ Lex Machina
Modułowy system skilli prawniczych AI dla prawa polskiego — z twardymi bramkami antyhalucynacyjnymi
System pokrywa 16 dziedzin prawa polskiego i unijnego: od routingu sprawy, przez analizę
dowodów i strategię procesową, po generowanie pism — z obowiązkową weryfikacją online
każdego przepisu i każdej sygnatury.
Szybki start •
Architektura •
Kompatybilność LLM •
Katalog skilli •
Mechanizmy weryfikacji •
Baza źródeł •
Instalacja •
Zadania cykliczne (Cowork) •
Zastrzeżenia
🎯 Czym jest Lex Machina
Lex Machina to zestaw 32 skilli (host-neutralnych Agent Skills) tworzących kompletny warsztat pracy
z polskim prawem:
| |
|---|
| 🧭 Orkiestracja | router spraw z trybami PRAWNIK / LAIK, macierz aktywacji, checkpointy jakości |
| 📚 Wiedza dziedzinowa | 16 modułów DR — każda dziedzina prawa PL/UE, jeden moduł = jeden akt prawny |
| 🛠️ Narzędzia wykonawcze | pisma procesowe, analiza umów i dowodów, przesłuchania świadków, chronologia, raporty |
| 🛡️ Antyhalucynacja | HARD GATE: zakaz cytowania prawa z pamięci, deterministyczne API, gradient weryfikacji cytatu |
| 📋 Governance | dziennik audytów, mapa Dz.U., paczka audytowa AI Act art. 12, polityka deduplikacji |
| 🔌 Wieloplatformowość | pełna host-neutralność: Claude, hosty zgodne z OpenAI (ChatGPT / Codex / API / Atlas) oraz Grok (pobiera skille wprost z repozytorium) — te same bramki, bez przepisywania metodologii. Zestaw przetestowany na Claude i ChatGPT; od 8.09.2026 warstwa ta jest częścią wersji stabilnej, nie tylko rozwojowej |
Zasada naczelna: brak numeru artykułu jest lepszy niż błędny numer artykułu;
brak sygnatury jest lepszy niż sygnatura nieweryfikowana lub fałszywa.
🚀 Szybki start
- Pobierz repozytorium (
Code → Download ZIP lub git clone)
- Wgraj skille do Claude AI w kolejności:
shared/ → routing → DR → wykonawcze (pełna instrukcja)
- Ustaw User Preferences w Claude AI:
Prawo PL: router→v3 pierwszy, ISAP każdy przepis, HYBRID-VAL przed .docx. Karne: +kwalifikator.
- Otwórz nową rozmowę i napisz: „Mam sprawę prawną. Od czego zacząć?"
🏗️ Architektura
flowchart TB
U(["Użytkownik"]) --> R
subgraph SYS["System skilli Lex Machina"]
R["prawny-router-v3<br/>tryb PRAWNIK / LAIK"] --> PP["prawo-polskie-v2<br/>ROUTING-MAP"]
PP --> DR["Dziedziny prawa<br/>DR-01 … DR-16<br/>jeden moduł = jeden akt"]
DR --> EXEC["Skille wykonawcze<br/>pisma, analiza sądowa,<br/>umowy, dowody, raporty"]
SH["shared/ — bramki weryfikacji<br/>PRAWO-HARDGATE v2.0<br/>SYGNATURY v1.1<br/>WERYFIKACJA-SLAD v1.1<br/>MOD-AUDIT-BUNDLE"]
R -.->|"obowiązkowe bramki"| SH
DR -.-> SH
EXEC -.->|"każde powołanie"| SH
end
EXEC --> OUT(["Wynik ze śladem<br/>weryfikacji"])
SH -.->|"API / konektory MCP"| SRC[("Źródła urzędowe<br/>ISAP/ELI, SAOS, CBOSA,<br/>SN, EUR-Lex")]
AUD["audyt-systemu-v4<br/>AUDIT-JOURNAL + mapa Dz.U."] -.->|"audytuje"| SYS
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.
🔌 Kompatybilność LLM
Obie wersje — stabilna (07.10.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 07.10.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):
| Element | Lokalizacja | Rola |
|---|
| Adapter runtime | shared/UNIVERSAL-RUNTIME-ADAPTER.md | Jeden kontrakt wykonawczy: mapuje operacje zależne od hosta (view, web_search, web_fetch, create_file, show_widget) na natywne funkcje hosta lub ich odpowiedniki. |
| Manifest OpenAI | <skill>/agents/openai.yaml | Rejestracja skilla w ekosystemie OpenAI (products: chatgpt, codex, api, atlas) + allow_implicit_invocation. |
| Manifest integralności | <skill>/PORTABILITY-MANIFEST.md | Lista plików + SHA-256 — dowód, że przeniesienie między hostami jest bezstratne. |
Pole compatibility: | frontmatter SKILL.md | Deklaruje wymagane operacje hosta (lub równoważne wg adaptera). |
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).
Wszystkie 32 katalogi niosą agents/openai.yaml, więc każdy skill pojawia się
samodzielnie w katalogu skilli hosta OpenAI. Brak pola
compatibility: w modułach dr-01 … dr-16 niczego nie blokuje — wymagane
operacje hosta rozstrzyga wtedy adapter runtime.
📁 Struktura repozytorium
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 07.10.2026/ ← skille spakowane (.zip) — wersja stabilna
├── WERSJA ROZWOJOWA/ ← skille spakowane (.zip) — wersja rozwojowa
├── Wersja stabilna rozpakowana 07.10.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.
📚 Katalog skilli
🧭 Routing i orkiestracja
| Skill | Rola |
|---|
prawny-router-v3 | Punkt wejścia każdej sprawy prawnej (nie przy wzmiankach prawnych w pracy nad kodem): klasyfikacja [1]–[10], tryb PRAWNIK/LAIK, anonimizacja (KROK 0A), macierz aktywacji, step-tracker |
prawo-polskie-v2 | Mapa routingu: sprawa → właściwe skille DR |
przewodnik-prawny-v2 | Punkt wejścia dla laika — prowadzenie za rękę |
⚖️ Dziedziny prawa (DR-01 … DR-16)
| # | Skill | Zakres |
|---|
| 01 | dr-01-ustroj-konstytucyjny-i-zrodla-prawa | Konstytucja, źródła prawa, TK |
| 02 | dr-02-prawo-cywilne-rodzinne-gospodarcze | KC, KRO, KSH, KPC |
| 03 | dr-03-prawo-karne-wykroczenia-egzekucja | KK, KPK, KW, KKW |
| 04 | dr-04-prawo-pracy-zus-swiadczenia | KP, ZUS, świadczenia |
| 05 | dr-05-prawo-administracyjne-sadowoadministracyjne | KPA, PPSA |
| 06 | dr-06-podatki-finanse-publiczne-aml | Ordynacja, VAT/PIT/CIT, AML |
| 07 | dr-07-zamowienia-publiczne-fundusze-ue | PZP, KIO, fundusze UE |
| 08 | dr-08-samorzad-terytorialny-prawo-lokalne | JST, prawo miejscowe |
| 09 | dr-09-budownictwo-srodowisko-energia-transport | Prawo budowlane, OOŚ, energetyka |
| 10 | dr-10-zdrowie-farmacja-zywnosc-rolnictwo | Prawo medyczne, farmaceutyczne |
| 11 | dr-11-cyfrowe-cyber-ai-dane-ip | RODO (+ operacyjne: DPIA, DSAR, RCP/DPA, naruszenia 72h), AI Act, DSA/DMA, KSC/NIS2, IP |
| 12 | dr-12-sadownictwo-prokuratura-zawody-prawnicze | Ustrój sądów, zawody prawnicze |
| 13 | dr-13-sluzby-bezpieczenstwo-informacje-niejawne | Służby, informacje niejawne |
| 14 | dr-14-prawo-ue-miedzynarodowe-prawa-czlowieka | Prawo UE, EKPC, KPP |
| 15 | dr-15-compliance-iso-governance-audyt | Compliance, ISO, sygnaliści |
| 16 | dr-16-pisma-strategia-dowody-orzecznictwo | Warsztat procesowy przekrojowy |
🛠️ Skille wykonawcze
| Skill | Zastosowanie |
|---|
pisma-procesowe-v3 | Pozwy, apelacje, odpowiedzi na pozew — z bramkami DRAFT/FINAL |
pisma-proste-v2 | Sprzeciwy, wezwania do zapłaty, wnioski o klauzulę |
analizator-umow-v1 | Analiza i redakcja umów (w tym RODO: powierzenie, regulaminy) |
analizator-dowodow-v3 | Klasyfikacja, scoring i walidacja dowodów |
analizator-przepisow-v2 | Analiza przepisów, vacatio legis, historia nowelizacji |
orzeczenia-sadowe-v2 | Wyszukiwanie i weryfikacja orzecznictwa |
analiza-sadowa-v6 | Pełna, wieloprzebiegowa analiza sprawy (ekstrakcja → struktura → predykcja) |
chronologia-sprawy-v1 | Oś czasu zdarzeń prawnych |
przesluchanie-swiadkow-v2 | Pytania do świadków, kontrprzesłuchanie (≥90 pytań) |
raport-sytuacyjny-v2 | Interaktywny raport ryzyk (tryby IND/BIZ) |
raport-klienta-v1 | Raport statusu sprawy dla klienta końcowego |
📋 Governance
| Skill | Rola |
|---|
audyt-systemu-v4 | Audyt jakości i aktualności: dziennik audytów, mapy Dz.U., deduplikacja |
Przejrzystość stanu systemu — co czytać (a czego nie)
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:
| Artefakt | Plik | Co daje |
|---|
| 🚦 Tablica otwartych flag | references/WARN-OTWARTE.md | „Co jeszcze do zrobienia" w jednym miejscu — tablica sterująca z podziałem flag (wykonalne sesją audytową / reaktywne / zależne od środowiska). Czytaj to zamiast całego dziennika. |
| 📊 Raporty pokrycia | references/raporty-pokrycia-2026-08-13/ | Pokrycie per kodeks (🟢 pełne · 🟡 częściowe · 🔴 śladowe) + priorytety uzupełnień — od razu widać, co system pokrywa dobrze, a co śladowo. |
| 🗺️ Mapa Dz.U. | references/mapa_dzu_*.md (najnowsza: 2026-08-26) | Data „zdjęcia" stanu prawnego — do czego numery Dz.U. są aktualne. |
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ą.
🛡️ Mechanizmy antyhalucynacyjne
Fundament systemu — pliki w shared/, obowiązkowe dla wszystkich skilli:
⛔ PRAWO-HARDGATE v2.0 — zakaz cytowania prawa z pamięci
Ż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.
🔏 SYGNATURY v1.1 — kontrakt wyniku weryfikacji
Każda weryfikacja sygnatury kończy się jednym z czterech statusów — bez zgadywania:
| Status | Reakcja |
|---|
🟢 FOUND | dokładnie jedno trafienie → cytuj z pełnymi danymi |
🔴 NOT_FOUND | zero trafień w pokrytym zakresie → nie cytuj |
🟡 AMBIGUOUS | ta sama sygnatura w ≥2 sądach → przedstaw kandydatów, nie wybieraj |
⚪ OUT_OF_SCOPE | baza nie pokrywa sądu/okresu → eskaluj do bazy oficjalnej |
🎚️ WERYFIKACJA-SLAD v1.1 — gradient weryfikacji cytatu
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]).
📦 MOD-AUDIT-BUNDLE — artefakt zgodności AI Act art. 12
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.
Baza źródeł i portali
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.
Rząd 1 — źródła urzędowe (wyłączne dla brzmienia przepisu)
Rząd 2A — oficjalne orzecznictwo i interpretacje
Rząd 2B — uznane portale prawnicze i branżowe (komentarz i kontekst)
Nigdy nie służą jako brzmienie przepisu ani dowód istnienia orzeczenia — zawsze ze
znacznikiem źródła pomocniczego.
| Kategoria | Portale |
|---|
| Generalistyczne | prawo.pl, infor.pl (+ kadry / ksiegowosc / samorzad), gofin.pl (+ subdomeny), gazetaprawna.pl, rp.pl, lexlege.pl, arslege.pl, money.pl |
| Gospodarcze i NGO (DR-02) | poradnikprzedsiebiorcy.pl, bankier.pl, ngo.pl (fundacje, stowarzyszenia — nowa nisza) |
| Podatki i księgowość (DR-06) | gofin.pl, ksiegowosc.infor.pl, podatki.biz, epodatnik.pl (archiwum interpretacji KIS), bankier.pl (proces legislacyjny), egospodarka.pl |
| Prawo pracy (DR-04) | kodekspracy.pl, kadry.infor.pl |
| Zamówienia publiczne (DR-07) | portalzp.pl |
| Samorząd (DR-08) | samorzad.infor.pl, prawodlasamorzadu.pl |
| Budownictwo (DR-09) | muratorplus.pl, prawniknabudowie.com, prawnikpodpowienabudowie.pl |
| Zdrowie, farmacja, rolnictwo (DR-10) | rynekzdrowia.pl (zdrowie/farmacja), farmer.pl, wiescirolnicze.pl (rolnictwo — ARiMR, KRUS) |
| RODO i cyfrowe (DR-11) | poradyodo.pl |
| Zawody prawnicze (DR-12) | palestra.pl, temidium.pl |
| Osoby z niepełnosprawnościami | niepelnosprawni.pl, integracja.org (+ popon.pl, obpon.org — perspektywa pracodawcy) |
| Bazy komercyjne (przy licencji) | LEX (sip.lex.pl), Legalis (sip.legalis.pl) — jako tekst przepisu Rząd 2A, jako komentarz Rząd 2B |
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.
Rząd 3 — strony kancelarii, blogi, NGO
Dopuszczone wyłącznie jako trop do dalszej weryfikacji — wysokie ryzyko
dezaktualizacji, obowiązkowe skrzyżowanie z Rzędem 1/2A przed użyciem.
Konektory MCP (dostęp deterministyczny, poziom A)
| Konektor | Źródło | Status |
|---|
lex-isap | api.sejm.gov.pl/eli — akty Dz.U./M.P., status, aktualny t.j. | własny serwer repozytorium |
lex-saos, lex-cbosa, lex-eurlex, lex-eureka, lex-krs, lex-wl, lex-nbp, lex-sudop, lex-uodo | orzecznictwo, interpretacje, rejestry, kursy, pomoc publiczna, UODO | własne serwery repozytorium |
Serwery leżą w audyt-systemu-v4/mcp-servers/ (dist/lex-mcp.mjs, zależności wbudowane, bez npx i bez pobierania z npm przy starcie).
| Host | Konfiguracja |
|---|
Claude Code + marketplace (plugin audyt-systemu-v4) | automatycznie — .mcp.json pluginu instaluje się z wtyczką |
| Claude Desktop | claude_desktop_config.json — zamień <KATALOG_REPOZYTORIUM> na ścieżkę klonu; albo rozszerzenie lex-machina.mcpb (python zbuduj_pakiet.py --mcpb) |
Rekomendacje: shared/KONEKTORY-REKOMENDOWANE.md.
💾 Instalacja
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 (07.10.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.
GitHub → zielony przycisk Code → Download ZIP, albo:
git clone https://github.com/michaleiatrak-star/Lex-Machina.git
Skille do wgrania znajdziesz w katalogu wersji (rozpakowanej lub jako pojedyncze
.zip w WERSJA STABILNA …/).
Claude AI → Customize → wtyczki - Dodaj rynek - dodaj z repozytorium - https://github.com/michaleiatrak-star/Lex-Machina/ (automatyczne aktualizacje) - dodaj każdy ze skili, będą aktualizować się automatycznie
Metoda alternatywna (bez automatycznej aktualizacji)
Claude AI → Customize → Nowy skill → Wgraj skill z komputera → wskaż cały folder skilla (nie pojedynczy plik SKILL.md).
Kolejność wgrywania:
| Etap | Skille | Status |
|---|
| 1️⃣ | shared/ | obowiązkowy |
| 2️⃣ | prawo-polskie-v2/, prawny-router-v3/ | obowiązkowe |
| 3️⃣ | dr-01/ … dr-16/ | wgraj wszystkie |
| 4️⃣ | skille wykonawcze | wg potrzeb (zalecany: przewodnik-prawny-v2/) |
| 5️⃣ | audyt-systemu-v4/ | opcjonalny (administracja) |
Minimalna instalacja: shared/ + prawo-polskie-v2/ + prawny-router-v3/ +
przewodnik-prawny-v2/ + dowolny skill wykonawczy + DR-skille właściwe dla Twojej sprawy.
/plugin marketplace add michaleiatrak-star/Lex-Machina#<TAG>
/plugin install prawny-router-v3@lex-machina-legal-skills
#<TAG> przypina katalog do wydania skilli; bez niego instalujesz bieżący main (HEAD).
Zależności (shared, DR-01–DR-16, skille wykonawcze) instalują się razem z routerem.
Pole dependencies w marketplace.json wymaga aktualnego Claude Code CLI (zweryfikowano na 2.1.296; starsze wersje zgłaszają Unrecognized key 'dependencies' — zaktualizuj CLI).
Wersja stabilna nie ma manifestów wtyczek — instaluje się ją, kopiując foldery skilli.
Claude AI → ikona konta → Settings → User Preferences → wpisz dokładnie:
Prawo PL: router→v3 pierwszy, ISAP każdy przepis, HYBRID-VAL przed .docx. Karne: +kwalifikator.
| Fragment | Znaczenie |
|---|
router→v3 pierwszy | router wczytywany jako pierwszy w każdej sprawie |
ISAP każdy przepis | weryfikacja każdego przepisu w isap.sejm.gov.pl |
HYBRID-VAL przed .docx | walidacja hybrydowa przed generowaniem Worda |
Karne: +kwalifikator | w sprawach karnych moduł kwalifikatora karnomaterialnego |
Allowlista domen (wymagana dla oficjalnych źródeł prawa):
Claude AI → Settings → Capabilities → Additional allowed domains → zmień:
All Domains
Bez tej allowlisty Claude może blokować bezpośredni dostęp do źródeł urzędowych
używanych przez HARD GATE i weryfikację online.
Test: nowa rozmowa → „Mam sprawę prawną. Od czego zacząć?" — system powinien
uruchomić router, dopytać o charakter sprawy i zaproponować przewodnik.
| Problem | Rozwiązanie |
|---|
| Claude nie używa routera | sprawdź User Preferences (dokładny tekst) i czy router jest na liście skilli |
| Skill nie pojawia się po wgraniu | wskaż folder, nie plik SKILL.md |
| Cytowanie bez weryfikacji | napisz: „przypomnij sobie zasady HARDGATE"; sprawdź czy shared/ zawiera PRAWO-HARDGATE.md |
| Błąd „description too long" | uruchom: „przeprowadź audyt systemu" — wskaże winny skill |
Host-neutralna jest zarówno wersja stabilna (07.10.2026), jak i rozwojowa, więc
w ChatGPT wgrywa się te same foldery skilli i w tej samej kolejności co
w Claude (patrz Krok 2) — z dowolnego z dwóch katalogów wersji. Każdy skill niesie
manifest agents/openai.yaml (products: chatgpt, codex, api, atlas) rozpoznawany
przez ekosystem OpenAI oraz wspólny adapter runtime,
który mapuje operacje systemu na natywne funkcje ChatGPT.
Odpowiednikiem „User Preferences" (Krok 3) jest w ChatGPT pole instrukcji
niestandardowych w personalizacji — te same reguły wpisujesz raz, dokładnie tak samo:
ChatGPT → Ustawienia → Personalizacja → Instrukcje niestandardowe
(Custom instructions) → pole „Jak ChatGPT ma odpowiadać?" (lub „Co jeszcze ChatGPT
powinien wiedzieć?") → wklej:
Prawo PL: router→v3 pierwszy, ELI każdy przepis, HYBRID-VAL przed .docx. Karne: +kwalifikator.
| Fragment | Znaczenie |
|---|
router→v3 pierwszy | router wczytywany jako pierwszy w każdej sprawie |
ELI każdy przepis | weryfikacja każdego przepisu w isap.sejm.gov.pl |
HYBRID-VAL przed .docx | walidacja hybrydowa przed generowaniem dokumentu |
Karne: +kwalifikator | w sprawach karnych moduł kwalifikatora karnomaterialnego |
Instrukcje niestandardowe działają globalnie na koncie — dokładnie jak User
Preferences w Claude — więc reguły obowiązują w każdej nowej rozmowie bez
powtarzania. Bramki jakości (HARD GATE, weryfikacja online, ZASADA 7) są identyczne.
Gdy host nie ma natywnego generatora DOCX/PDF, system zwraca równoważny raport
strukturalny — walidacja końcowa nie jest pomijana (patrz adapter runtime).
Grok nie wymaga ręcznego wgrywania folderów — potrafi sam pobrać skille z
repozytorium. Wystarczy:
-
Wskaż repozytorium — podaj Grokowi adres:
https://github.com/michaleiatrak-star/Lex-Machina.
-
Wskaż wersję — którą gałąź/katalog ma wziąć:
| Wersja | Katalog w repozytorium | Host-neutralna |
|---|
| 🟢 stabilna (zalecana) | Wersja stabilna rozpakowana 07.10.2026/ | tak |
| 🟠 rozwojowa | Wersja rozwojowa rozpakowana/ | tak |
-
Grok pobiera i instaluje skille automatycznie (zaczynając od shared/, potem
router i skille DR — kolejność jak w Kroku 2).
-
Reguły sterujące wpisz w instrukcjach/personalizacji Grok — ta sama kanoniczna
reguła co w Claude i ChatGPT:
Prawo PL: router→v3 pierwszy, ELI każdy przepis, HYBRID-VAL przed .docx. Karne: +kwalifikator.
Bramki jakości (HARD GATE, weryfikacja online, ZASADA 7) obowiązują identycznie.
Do brzmienia przepisu i sygnatur Grok korzysta z weryfikacji online zgodnie z
adapterem runtime — nie cytuje prawa z pamięci.
Zadania cykliczne (scheduled tasks) w Cowork
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).
Jak utworzyć zadanie
Uruchom audyt systemu w trybie graficznym w Cowork i wybierz automatyzację systemu - weryfikacje dzienników ustaw, system poprowadzi cię automatycznie.
Prompt zadania dla Lex Machina — reguły
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:
| Cel | Częstotliwość | Prompt zadania |
|---|
| Monitoring nowych Dz.U. / t.j. | Daily / Weekdays | Uruchom audyt-systemu-v4 w TRYBIE DZU: sprawdź mapę Dz.U., zaktualizuj tabelę MONITORING i AUDIT-JOURNAL. |
| Pełny audyt systemu | Weekly | Uruchom audyt-systemu-v4 w TRYBIE AUTO: pełny audyt, Fazy 0–7, bez menu interaktywnego. |
| Zamykanie otwartych flag | Weekly | Uruchom audyt-systemu-v4 w TRYBIE WARN-CLOSE: zamknij otwarte warningi z references/WARN-OTWARTE.md. |
O czym pamiętać
- 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.
🔄 Wersjonowanie
| Kanał | Lokalizacja | Przeznaczenie |
|---|
| 🟢 Stabilna | WERSJA STABILNA 07.10.2026/ + katalog rozpakowany | do codziennej pracy; wieloplatformowa — Claude + ChatGPT/Codex/API/Atlas + Grok |
| 🟠 Rozwojowa | WERSJA ROZWOJOWA/ + Wersja rozwojowa rozpakowana/ | nowe mechanizmy przed promocją; ta sama warstwa host-neutralna |
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.
Wydanie stabilne 07.10.2026 — promocja całej wersji rozwojowej (32 skille, stan
z 7.10.2026, m.in. audyt-systemu-v4 6.202, shared 3.99.16, prawny-router-v3 3.67,
prawo-polskie-v2 6.45). W chwili wydania kanały stabilny i rozwojowy są identyczne;
ZIP-y odpowiadają katalogom rozpakowanym bajt w bajt
(scripts/verify_development_archives.py).
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).
⚠️ Zastrzeżenia prawne
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.
🤝 Kontakt i zgłaszanie błędów
Błędy, sugestie i propozycje zmian → Issues
📜 Licencja
Projekt udostępniony na licencji GNU GPL v3.
