Teaching AI Agents to Navigate French Bureaucracy

What it does

Paperasse is a collection of Markdown-based skills that specialize AI agents in six flavors of French bureaucracy: accounting, tax control, auditing, personal tax law, notary work, and condominium management. Each skill encodes domain knowledge like the French chart of accounts (PCG), tax codes (CGI, BOFiP), and legal procedures so the agent can generate journal entries, simulate tax audits, calculate notary fees, or draft co-ownership meeting minutes. The repo also includes Node.js scripts and HTML templates for generating formal documents such as FEC files, balance sheets, and tax declarations.

The interesting bit

The skills are plain Markdown, meaning they work with any agent that can read a file—Claude Code, Cursor, Codex, Mistral Vibe, or Aider. The project also wires into real data via Qonto and Stripe connectors, and it runs automated evals to prove the skills actually help: aggregate accuracy jumps from 75% to 88% when the skill is loaded.

Key highlights

• Six specialist personas covering everything from VAT and corporate closing to succession law and condo fee disputes
• Deterministic document generation via Node.js scripts: FEC, financial statements, liasse fiscale drafts, and professional PDFs
• Built-in guardrails: automatic company context checks, fiscal deadline reminders, and stale-data warnings if a skill hasn’t been updated in six months
• Open-source data sourcing: French chart of accounts and tax nomenclature from data.gouv.fr, plus public APIs for BOFiP and the Sirene business directory
• Automated evaluation suite using LLM-as-judge grading, with per-skill scorecards and a GitHub Actions smoke test for pull requests

Caveats

• The README is explicit that these skills do not replace certified professionals (experts-comptables, notaires, commissaires aux comptes) and should be treated as decision-support tools only
• French regulatory data changes frequently; the project warns that skills older than six months should be verified against current sources before use

Verdict

A practical addition if you’re a French developer or small-business owner already using AI agents and tired of explaining TVA regimes to a generalist model. If your situation involves litigation, complex tax structures, or an actual DGFIP audit, the project itself advises hiring a human with a SIRET number and professional insurance.