First-pass review tooling
Find candidate gaps in a MiCAR white paper draft before legal review.
The linter applies fixed rules for Annexes I, II and III of Regulation (EU) 2023/1114 to a draft and lists what is missing or needs review, each with a citation. The same input always gives the same result. No language model is in the checking path.
What it is
- A checklist that flags absent or thin disclosures, per Annex Part.
- A citation and a rule page for every finding.
- Offline LEI checks: check digits and agreement across sections. No registry is queried.
- Statuses: Missing Review Pass. Severity: blocker, major, minor.
What it is not
- Not legal advice, and not a compliance opinion.
- A pass means a check matched: listed terms appear and the section is long enough. Accuracy and sufficiency need a lawyer.
- Not an iXBRL validator. The format check never passes; tag completeness needs a taxonomy validator.
Your draft stays with you
- The playground runs the rules in your browser. Nothing you paste leaves the page, and it is not stored.
- The CLI and the GitHub Action run where you run them.
- The CI summary, annotations and SARIF log carry rule IDs, citations and line numbers, never draft text. The job log still prints the full report, including the draft title and quoted figures.
Three ways to run it
| Surface | Use it for | Start |
|---|---|---|
| Playground | A quick look at a JSON or XHTML draft | Open the playground |
| Command line | Reports, review tables, review bundles and SARIF | pip install micar-whitepaper-linter, then micar-lint draft.json |
| GitHub Action | Checks on every push; from the next v1 release also a job summary, line annotations and optional code-scanning upload | uses: sebastianfoerste/micar-whitepaper-linter@v1 |
Known limits
- Rules work at Annex Part level, with topic rules for the reserve of assets. Point-level checks are not built yet.
- The Annex II and III rules have not yet been run against a real ART or EMT white paper.
- No accuracy rate is published: the pilot study's results await human review.
- Citations link to the acts on EUR-Lex at act level.
First-pass screening for review by a qualified lawyer. Use synthetic or public material in the playground.