TW Legal RAG — Taiwan judgment retrieval for Claude Code
When to use
Any time the question involves Taiwan law and the answer would benefit from actual court judgments: legal questions in plain language, case-law research, checking whether a cited 字號 exists, or building an argument that needs precedent support. Retrieve FIRST, answer second.
How to retrieve
Run the bundled script with the user's question:
python3 scripts/search_judgments.py "雇主未足額提撥勞工退休準備金的法律責任" -n 5
It prints a bundle JSON containing judgments (court, case number, date,
reasoning excerpts), stable citation ids (J1, J2, ...), an
allowed_citations whitelist and verification instructions.
The script locates the twlegalrag executable automatically and falls back
to python -m twlegalrag when the console script is not on PATH (common on
Windows user-site installs). If both fail, install the CLI first:
pip install twlegalrag.
Citation rules (non-negotiable)
- Cite ONLY ids listed in the bundle's
allowed_citations. Judgments inunread_candidateswere not read in full — never present them as authority. - Quote only text that appears verbatim in a judgment's
fulltext_excerpt. Do not reconstruct holdings from memory. - If the bundle is empty or retrieval fails, say so explicitly. Never substitute invented case numbers.
- A case number appearing in the bundle proves the judgment exists — it does not prove it supports the user's position. Read the excerpt before characterising a holding.
- Follow the bundle's own
verification_instructionsfield; it is part of the data contract.
Notes
- Retrieval hits the public TLR endpoint (
tlr.dr-legal.com.tw); no API key is required and no LLM is called server-side. - Windows: if output shows garbled Chinese, the terminal is not in UTF-8; the CLI reconfigures its own streams, but pipe output to a file when in doubt.