Das Legalize-es-Projekt: Spanische Gesetze als Git-Repository verwalten

 (github.com/EnriqueLop)
2 Punkte von GN⁺ 2026-03-29 | 1 Kommentare | Auf WhatsApp teilen
  • Ein Repository, das mehr als 8.600 Gesetze seit 1960 als Markdown-Dateien verwaltet, gesammelt über die öffentliche BOE-API der spanischen Regierung
  • Jedes Gesetz wird zusammen mit YAML-Metadaten gespeichert, und die gesamte Änderungshistorie wird über Git-Commits nachverfolgt
  • Es umfasst den gesamten konsolidierten Rechtsbestand auf nationaler Ebene, darunter Verfassung, Organgesetze, allgemeine Gesetze und Gesetzesdekrete; jeder Commit enthält einen Link zur offiziellen Quelle
  • Die Gesetzestexte stehen als Public Domain zur Verfügung, und das Repository bietet zusätzlich Strukturierung, Versionsverwaltung und Vergleichsfunktionen
  • Das Projekt soll mit der Legalize.dev API verknüpft werden und künftig erweiterte Funktionen wie Gesetzessuche, Versionsvergleiche und Änderungsbenachrichtigungen unterstützen

Überblick

  • Ein Projekt, das den gesamten spanischen Rechtsbestand als Git-Repository verwaltet; jedes Gesetz liegt als Markdown-Datei vor, und die gesamte Änderungshistorie wird in Commits festgehalten
  • Es umfasst mehr als 8.600 Gesetze seit 1960; die Daten stammen aus der öffentlichen API des BOE (Boletín Oficial del Estado) der spanischen Regierung
  • Dieses Repository ist Teil des Legalize-Projekts und ermöglicht Versionsverwaltung, Vergleiche und Nachverfolgung von Gesetzen
  • Die Gesetzestexte sind Public Domain, und das Repository stellt Strukturierung, Metadaten und Versionsverwaltung bereit

Dateistruktur

  • Alle Gesetze werden als Markdown-Dateien im Verzeichnis spain/ gespeichert
    • Beispiele: BOE-A-1978-31229.md ist die spanische Verfassung, BOE-A-1995-25444.md das Strafgesetzbuch, BOE-A-2015-11430.md das Arbeitnehmerstatut, BOE-A-2000-323.md die Zivilprozessordnung
  • Jede Datei beginnt mit Frontmatter-Metadaten im YAML-Format
    • Enthalten sind unter anderem titulo, identificador, pais, rango, fecha_publicacion, ultima_actualizacion, estado, fuente
    • Im Beispiel sind für die Verfassung (Constitución Española) das Veröffentlichungsdatum, das letzte Aktualisierungsdatum, der Status (vigente) und die URL der offiziellen Quelle angegeben

Umfang der enthaltenen Gesetze

  • Enthalten sind alle im BOE auf nationaler Ebene klassifizierten konsolidierten Gesetze
    • Verfassung, Organgesetze (Leyes Orgánicas), allgemeine Gesetze (Leyes ordinarias), Gesetzesdekrete (Decretos-ley), königliche Gesetzesdekrete (Reales Decretos Legislativos)
  • Jede Änderung wird als eigener Commit gespeichert; das Commit-Datum entspricht dem offiziellen Veröffentlichungsdatum
  • Die Commit-Nachrichten enthalten die Kennung der Änderung und den Link zur offiziellen Quelle

Anwendungsbeispiele

  • Nach dem Klonen des Repositorys lassen sich bestimmte Gesetzesartikel durchsuchen oder Änderungsverläufe prüfen
    • Beispiel: Mit dem Befehl grep nach Artikel 135 der Verfassung suchen
    • Mit git log die Änderungshistorie dieses Artikels prüfen
    • Mit git diff die konkreten Änderungen der Reform zur Haushaltsstabilität von 2011 vergleichen

Datenquelle und Lizenz

  • Alle Daten stammen aus der API für konsolidierte Gesetzgebung des BOE
  • Die Gesetzestexte sind Public Domain; das Repository fügt nur Strukturierung und Versionsverwaltung hinzu
  • Repository-Struktur, Metadaten und Tools werden unter der MIT-Lizenz veröffentlicht

API und Erweiterungspläne

  • Die Legalize API soll bald auf legalize.dev verfügbar sein
    • Geplant sind Funktionen für Gesetzessuche, Filterung, Versionsvergleiche und Änderungsbenachrichtigungen

Mitwirken

  • Bei Fehlern im konsolidierten Text oder fehlenden Änderungen kann ein Issue eröffnet und ein Korrekturvorschlag mit Gesetzesname, Artikel und offizieller Quelle eingereicht werden

Autor

  • Das Projekt wurde von Enrique Lopez erstellt
  • Es ist Teil des Legalize-Projekts und mit legalize.dev verknüpft

Verwandte Beiträge

1 Kommentare

 
GN⁺ 2026-03-29
Hacker-News-Kommentare

  • In Frankreich werden Gesetze nicht nur versionsverwaltet, sondern sogar formal bewiesen (formally proved)
    Mit der Sprache Catala werden Gesetze wie Code behandelt
    Edit: Hier sind auch ziemlich viele Leute aus Frankreich dabei. Mindestens fünf Personen sprechen über Versionsverwaltung und verweisen auf Légifrance

    • Catala ist kein Werkzeug, um Gesetze zu „beweisen“, sondern eine Sprache, die die logische Struktur (default logic) von Gesetzen direkt ausdrückt und in eine berechenbare Form übersetzt
      Bei der Implementierung von Berechnungslogik für Steuern oder Sozialleistungen lässt sich damit viel präziser prüfen, ob sie tatsächlich mit dem Gesetz übereinstimmt, als mit herkömmlichen Allzwecksprachen
    • Ich fand es ironisch, dass der Name „Catala“ in einer Diskussion über spanisches Recht auftauchte
    • Zu diesem Thema gab es schon einmal eine frühere Diskussion
    • „Borbaqui est la volonté du peuple!“ — scheint französischer Humor zu sein

  • Ich habe eine Pipeline gebaut, die das gesamte spanische nationale Recht in ein versionsverwaltetes Markdown-Repository umwandelt
    Jedes Gesetz ist eine Datei, jede Änderung wird als Git-Commit mit dem tatsächlichen Datum erfasst. Insgesamt gibt es 8.642 Gesetze und 27.866 Commits
    Gesetze sind letztlich eine „Abfolge von Patches“, daher halte ich Git für die naheliegende Lösung. Statt Formulierungen wie „Absatz 3 wird gestrichen …“ kann man die Änderungen als echten Diff sehen
    Als Quelle habe ich die API für konsolidierte Rechtstexte des spanischen Amtsblatts (BOE) verwendet und das Ganze mit Claude Code in etwa vier Stunden aufgebaut
    Ich untersuche derzeit, ob sich daraus eine Rechts-API oder Open-Data-Plattform entwickeln lässt

    • Die Intention eines Gesetzes wird oft erst durch Rechtsprechung klar, daher wäre es wertvoll, Urteile chronologisch über die Gesetzesartikel zu legen
      Man könnte auch analysieren, welche Gesetze am häufigsten zitiert wurden und welche Formulierungen immer wieder ausgelegt werden mussten
    • Mich hat interessiert, in welchem Format das Amtsblatt die Gesetze bereitstellt. In Deutschland gibt es offenbar immer noch nur PDFs, worum man Spanien beneidet
      Eine offizielle API wie in Spanien wäre viel effizienter, stattdessen beanspruchen in Deutschland sogar private Stellen Urheberrechte
    • Im römisch-napoleonischen Rechtssystem lassen sich Änderungen an einzelnen Vorschriften nachverfolgen, aber die Wechselwirkungen zwischen Gesetzen hängen weiterhin von der Auslegung durch Richter und Anwälte ab
      Im Vereinigten Königreich kann man auf legislation.gov.uk dagegen die vollständige Änderungshistorie nachvollziehen
    • In Spanien decken konsolidierte Rechtstexte nicht alles ab; das eigentliche Problem ist das Fehlen von Urteilsdaten
      Große Kanzleien haben eigene Datenbanken, daher ist das Marktpotenzial für kostenpflichtige Dienste gering
    • Wenn auch das US-Steuerrecht so als Markdown-Dump vorläge, könnte wohl jeder sein eigenes TurboTax bauen
      Siehe IRS-Steuerrechtslink

  • Solche Projekte sind ein großartiger Schritt hin zu mehr Transparenz von Rechtsdaten
    Sie könnten die Grundlage dafür schaffen, dass KI Gesetze verstehen und erklären kann
    Hoffentlich gibt es ähnliche Versuche auch in anderen Ländern

  • Noch interessanter wäre es, wenn der Commit-Autor der Politiker wäre, der tatsächlich für die Änderung verantwortlich ist
    Mit git blame könnte man dann direkt sehen, wer das Gesetz gemacht hat

    • Es wäre gut, hier auch ein Unit-Test-Konzept hinzuzufügen
      Man könnte Schlupflöcher als Testfälle anlegen und bei jeder Gesetzesänderung Regressionstests laufen lassen, um zu prüfen, ob alles noch stimmt

  • Ich halte das für eine wirklich großartige Idee. Schön wäre, wenn so ein System auf die Gesetze aller Länder angewendet würde

    • Die Rechtsbranche weiß sehr genau, dass solche Effizienzgewinne ihr Einnahmemodell bedrohen
      So wie es Lobbyarbeit gibt, um Steuererklärungen kompliziert zu halten, könnten auch Anwälte Transparenz und Effizienz blockieren wollen
      Siehe diesen Artikel
    • Unsere Non-Profit-Organisation Open Law Library arbeitet direkt mit Regierungen zusammen, um solche Systeme aufzubauen
      Der Bundesstaat Maryland hat das bereits unter regs.maryland.gov eingeführt,
      und auch das GitHub-Repository ist öffentlich
      Wir helfen lokalen Communities dabei, offizielles Recht auf GitHub zu veröffentlichen
    • Auch britische Gesetzestexte werden im Grunde diff-basiert verfasst, das ist also kein exklusiver Trick der Tech-Branche
    • Stimme völlig zu. Wirklich hervorragende Arbeit

  • Ich implementiere gerade etwas Ähnliches für Gesetzentwürfe im Bundesstaat Kalifornien
    Ich denke, dieser Ansatz sollte der Standardweg werden. Ich habe mich immer gefragt, warum die kanonische Fassung solcher Dokumente nicht in einem Git-Repository liegt

    • Zynisch betrachtet will der Staat vielleicht gar nicht, dass Bürger die Gesetze vollständig verstehen
      Wohlwollender interpretiert könnte es auch daran liegen, dass es im Rechtsbereich kaum Leute gibt, die solche Technik verstehen oder umsetzen können

  • Großartiges Projekt. Die meisten Gesetze aus der Franco-Zeit wurden 1978 aufgehoben, aber es sind trotzdem noch Gesetze aus der Zeit vor dem 19. Jahrhundert enthalten
    Allerdings beginnt die Quelle 1960 mit einem einzigen Commit, frühere Änderungshistorien fehlen also
    Das BOE hat sogar Dokumente bis ins 17. Jahrhundert eingescannt — das Niveau der Archivierung ist beeindruckend

  • Eine Grenze von Git ist, dass git blame hier nicht wirklich funktioniert
    Es wäre schön zu wissen, wer dafür oder dagegen gestimmt hat, aber Git hat keine Struktur für kollaborative Commits

    • Wenn man Abstimmungsergebnisse oder Metadaten in die Commit-Logs aufnimmt, könnte es dennoch funktionieren
      Unabhängig davon ist es schon eine enorme Leistung, überhaupt die Gesetze eines ganzen Landes in Git gebracht zu haben
    • Git ist nicht für kollaborative Commits optimiert, aber durch Community-Konventionen wie „Co-Authored-By“ lässt sich das ergänzen
      Diese Praxis stammt aus der Entwicklung des Linux-Kernels
    • Man könnte das gesamte Parlament als Hauptautor setzen und einzelne Parteien plus Abstimmungsergebnisse als Mitautoren eintragen
    • Eigentlich sind diese Informationen schon öffentlich, also könnte auch ein LLM die Antwort liefern. Ein Scherz war, dass Nerds dafür gar nicht extra Git brauchen
    • Wenn man einen PR mit Beiträgen mehrerer Personen squasht, lässt sich das als gemeinsamer Commit darstellen und hinterlässt so eine Spur der Zusammenarbeit

  • Ich bin der Autor (OP). Ich hätte nicht mit so einer großen Resonanz gerechnet
    Wegen der vielen Nachfragen habe ich den Code veröffentlicht → GitHub: legalize-dev
    Die Pipeline ist auf Unterstützung mehrerer Länder ausgelegt. Frankreich (Légifrance-Daten) funktioniert bereits,
    und um ein neues Land hinzuzufügen, müssen nur vier Python-Schnittstellen implementiert werden
    Ich habe auch einen Beitragsleitfaden geschrieben
    Es gab bereits Interessensbekundungen aus Deutschland, Portugal, Schweden, Finnland, den Niederlanden, Brasilien und weiteren Ländern
    Wenn ihr öffentliche Rechtsdatenquellen aus euren Ländern kennt, helft gerne mit einem PR
    Mit wachsender Größe braucht das Projekt Infrastruktur, daher bereite ich Finanzierung über Open Collective vor
    Es gibt auch eine Website, auf der man Gesetze und Diffs in Echtzeit ansehen kann
    Noch ist alles instabil, aber das große Bild steht

  • Glückwunsch! Wirklich ein tolles Projekt
    Früher gab es mit gitlaw schon einen ähnlichen Versuch, und in Brasilien gibt es den LexML-Standard, um Änderungen in Gesetzen technisch auszudrücken
    Ziemlich komplex, aber ein interessanter Ansatz

    • Jemand machte den Witz: „Schon wieder XML.“ Spanien war früher ebenfalls an LexML beteiligt, scheint inzwischen aber auf ein anderes Format umgestiegen zu sein