Repo lexifina/global-law biến luật pháp thành dữ liệu git. Mỗi quốc gia là một submodule, mỗi commit là một đạo luật có hiệu lực, và bạn interleave các history đó theo ngày hiệu lực. Kết quả: một commit trong repo cha là trạng thái luật của toàn bộ các quốc gia được cover vào đúng một ngày.
Cụ thể hơn, nó giải quyết bài toán “luật này nói gì vào ngày X”. Với luật thông thường bạn chỉ có bản hiện hành trên trang của chính phủ, còn muốn biết bản 2019 hay 2022 thì phải lục archive, đối chiếu thông tư sửa đổi bằng tay. Repo này đảo ngược: cấu trúc git tự nhiên đã là một dòng thời gian. Muốn xem văn bản ngày 1/5/2022 thì checkout đúng commit đó.
Nó làm gì cụ thể
Repo cha có manifest.json liệt kê từng corpus (đường dẫn, source repo, độ phủ, trailer nào chứa ngày hiệu lực), và jurisdiction.json mô tả cây thế giới: 193 nước thành viên UN, các vùng lãnh thổ có mã ISO riêng, và EU. Bên trong mỗi thư mục quốc gia là một submodule trỏ tới repo luật riêng của nước đó.
global-law/
├── manifest.json every corpus: path, source repo, coverage, which trailer holds the in-force date
├── jurisdiction.json the world, and its children: 193 UN members, other territories with their own ISO code, and the EU
├── germany/ Germany (ISO code DE in its jurisdiction.json)
│ ├── SOURCES.md where German law can be read, with what each source offers
│ └── bund/ federal law
│ └── acts/ submodule: the Grundgesetz since 1949 (grundgesetz/), every other federal act since 2019
├── estonia/ Estonia
│ └── national/acts/ submodule: Estonia's law history, from its corpus.json
├── france/ France: jurisdiction.json and SOURCES.md, no history yet
└── … every other country, the same way
Điểm đáng giá nằm ở chỗ mỗi commit được ghi có author là chính đạo luật, kèm trailer ghi corpus, commit của corpus, tên luật và ngày hiệu lực. Nhờ vậy git log và git blame cho ra câu trả lời trực tiếp: ai (luật nào) viết ra từng chữ này, vào lúc nào.
README nói rõ độ phủ không đều. Vài nước có cả bộ luật (Czechia, Spain, Switzerland, Georgia, Malta), vài nước chỉ có một ít. Corpus Mỹ là chín title của United States Code, corpus UK là luật về nhu cầu giáo dục đặc biệt. manifest.json ghi từng corpus ở mức coverage nào, và history ghi cách dựng lại quá khứ: in-force (bản chính thức có ngày), replayed (dựng lại bằng cách áp từng đạo luật sửa đổi, có ghi verification đã kiểm tra ngày nào), hoặc current-only (chỉ có bản hôm nay).
Vì sao đang được chú ý
Repo mới tạo ngày 28/10/2026, tới 30/10 đã 839 sao. README nói rõ nó là bản mở rộng của một dự án tương tự cho US Code từng lên #1 Hacker News cùng ngày 28/10. Cộng đồng dev quan tâm vì hai lý do: thứ nhất là ý tưởng dùng git làm mô hình dữ liệu cho văn bản pháp luật nghe rất hiển nhiên nhưng chưa ai làm ở quy mô toàn cầu; thứ hai là nó ship kèm MCP server, cho phép LLM truy vấn luật theo ngày. Đó là thứ nhiều người đang cần cho các bài toán compliance, tra cứu hợp đồng, kiểm tra citation trong brief.
Khác biệt so với các trang luật điện tử: bạn có toàn bộ dữ liệu trên máy, chạy offline, không phụ thuộc API của bên thứ ba, và mọi thay đổi đều truy vết được tới từng commit.
Cài và chạy thử
Clone kèm submodule, sau đó thêm MCP server vào client. Lệnh giữ nguyên như README:
git clone --recurse-submodules https://github.com/lexifina/global-law && cd global-law
claude mcp add global-law -- python tools/mcp_server.py # Claude Code; or approve the project's .mcp.json
Với client khác (Claude Desktop, Cursor và tương tự), thêm vào MCP settings:
{ "mcpServers": { "global-law": { "command": "python", "args": ["/path/to/global-law/tools/mcp_server.py"] } } }
Sau đó hỏi bằng tiếng người. Ví dụ trong README:
- “What did 11 U.S.C. §1182(1) say on 1 May 2022, and which law last changed it?”
- “A case was commenced on 2022-05-01 under §1182. Which text applies, period by period?”
- “Which provisions rely on 11 U.S.C. §1182, and which judgments does the record hold for it?”
- “Check every citation in this brief against the law in force today.”
MCP server có 18 tool read-only, ba prompt và một resource template. Nó chạy local qua stdio, chỉ dùng Python 3.10+ và git, không gọi mạng, không sửa gì trong repo. Test chạy bằng python -m unittest tests.test_mcp.
Ai nên dùng
Dev làm legal tech, đặc biệt các sản phẩm tra cứu án lệ hay kiểm tra hợp đồng. Luật sư hoặc paralegal biết dùng command line có thể dùng trực tiếp để tra bản luật đúng ngày. Team research cần dữ liệu offline cho LLM có thể fork repo và trỏ MCP server vào bản của mình.
Còn nếu bạn chỉ cần “luật hiện hành của Việt Nam” thì chưa dùng được. README nói rõ corpus chưa cover hết, và file thiếu vào một ngày có thể có nghĩa là provision đó chưa có hiệu lực, hoặc đơn giản là corpus chưa vươn tới mốc đó.
Ưu điểm và hạn chế
Ưu điểm thật: mô hình dữ liệu sạch, chạy offline, deterministic (build lại từ đầu là ra cùng kết quả), MCP server đi kèm, giấy phép CC0 cho phần khung repo (luật nằm trong repo riêng của từng nước, theo điều khoản của repo đó). Bạn được phép fork, nhúng vào sản phẩm thương mại, không cần xin phép.
Hạn chế thì README tự thừa nhận khá thẳng:
- Độ phủ lệch. Mỹ chỉ chín title, UK chỉ một mảng luật.
- Git không lưu được ngày trước 1970, nên các thay đổi Grundgesetz trước mốc đó bị dồn về ngày 1/1/1970, cách nhau một giây cho giữ thứ tự. Trailer
In-forcemới là thứ đáng tin, và tool dùng trailer, nênlaw.py show 1956-03-19 …vẫn chạy đúng. - Luật hồi tố được ghi trong commit message nhưng không đổi văn bản hiển thị ở ngày cũ.
git blametheo dòng, nên một dòng bị sửa một nửa thì gán cho luật gần nhất chạm vào dòng đó.law.py wordsmới gán theo từng từ.
Về license: repo cha ghi CC0 nhưng dữ liệu luật trong submodule theo điều khoản của từng nước, cái này phải đọc riêng. Về độ trưởng thành: mới hai ngày tuổi, số commit ít, chưa có topic tag trên GitHub, tài liệu chính là README và MCP.md. Đừng kỳ vọng nó thay được LexisNexis hay Westlaw ngay. Nó là hạ tầng dữ liệu để bạn tự xây lớp tra cứu lên trên.
Tôi thấy điểm hấp dẫn nhất không nằm ở 839 sao, mà ở chỗ thiết kế trailer đủ chặt để mọi truy vấn “luật nào đã viết ra chữ này, từ ngày nào” trở thành một câu git log. Đó là nền móng tốt, miễn là độ phủ corpus còn tiếp tục dày lên. Ai tò mò thì clone về chạy thử MCP server trước, mất khoảng vài phút. Repo ở đây: lexifina/global-law.
Câu hỏi thường gặp
global-law là gì và dùng git để làm gì với luật pháp?
Đây là repo biến luật pháp thành dữ liệu git: mỗi quốc gia là một submodule, mỗi commit là một đạo luật có hiệu lực, và các history được interleave theo ngày hiệu lực. Nhờ đó một commit trong repo cha thể hiện trạng thái luật của toàn bộ các quốc gia được cover vào đúng một ngày.
Làm sao tra luật của một quốc gia vào đúng một ngày cụ thể?
Vì cấu trúc git tự nhiên đã là một dòng thời gian, bạn chỉ cần checkout đúng commit tương ứng với ngày muốn xem, ví dụ văn bản ngày 1/5/2022. Mỗi commit có author là chính đạo luật kèm trailer ghi corpus, commit của corpus, tên luật và ngày hiệu lực, nên git log và git blame trả lời trực tiếp luật nào viết ra từng chữ và vào lúc nào.
Repo này đã cover luật Việt Nam chưa và độ phủ ra sao?
Chưa. Nếu bạn chỉ cần luật hiện hành của Việt Nam thì chưa dùng được, vì README nói rõ corpus chưa cover hết. Độ phủ không đều: vài nước có cả bộ luật như Czechia, Spain, Switzerland, Georgia, Malta, trong khi corpus Mỹ chỉ là chín title của United States Code và corpus UK chỉ là luật về nhu cầu giáo dục đặc biệt.
