---
name: werkdossier-lokaal-invullen
description: Stel een volledig Notary.AI-werkdossier (compromis/akte + modelmails + afrekening) samen EN vul de werkelijke dossiergegevens lokaal in het .docx in, zonder Word M365 Copilot als tweede agent. Gebruik dit wanneer een notaris/medewerker vraagt om een dossier (compromis, verkoopakte, schenking, …) op te stellen op basis van lokaal beschikbare dossierstukken.
---

# Werkdossier opstellen én lokaal invullen (Claude-agent, geen Word M365 Copilot nodig)

Notary.AI (de kantoor-API/MCP-server) genereert werkdocumenten met veilige,
geanonimiseerde placeholders — persoonsgegevens mogen nooit naar de server.
Bij een chat-only agent (Copilot Studio) moet een TWEEDE agent (Word M365
Copilot) daarom manueel de echte gegevens intypen. Claude Code heeft wél
lokale bestandstoegang: deze skill laat je die mechanische invulstap zelf en
deterministisch uitvoeren — geen tekst overtypen, dus geen risico op een
verkeerd overgenomen naam of bedrag.

**GDPR-grens, expliciet**: stap 1 (hieronder) mag alleen geanonimiseerde
kenmerken (enums/booleans) en placeholders naar Notary.AI sturen. Stap 2
gebeurt 100% lokaal — het maakt geen enkele netwerkoproep.

## Stap 1 — Genereer het werkdossier via Notary.AI (geanonimiseerd)

1. Lees de lokale dossierstukken en bepaal: dossiertype, gewest, en de
   deterministische kenmerken. Twijfel over de tools? Roep `haalWerkwijze` op.
2. Roep `genereerWerkdossierAlsWord` aan (via de Notary.AI MCP-server/API) met:
   - `modeldocumentId`, `taal`;
   - **álle kenmerken die je met zekerheid kent** (`goedType`, `metKrediet`,
     `epcAanwezig`, `syndicusInfo`, `fiscaalRegime`, …) — elk kenmerk sluit een
     open hypothesekeuze in het ontwerp. Zie het toolschema of de
     `handleiding` in het antwoord van `genereerOntwerpUitKenmerken` voor de
     volledige lijst met toegelaten waarden.
   - **geen persoonsgegevens** — enkel geanonimiseerde `{{parameter}}`-waarden
     indien nodig.
3. Decodeer het teruggegeven bestand lokaal: `base64` (indien aanwezig) of
   download `downloadUrl` (24 u geldig) naar een lokaal `.docx`-bestand.

## Stap 2 — Vul de werkelijke gegevens lokaal in (nooit via de server)

1. Open het gedownloade `.docx` (of lees de tekst eruit, bv. via een tijdelijke
   `.txt`-extractie) en zoek elke `[AAN TE VULLEN: naam]` (Frans:
   `[À COMPLÉTER: naam]`).
2. Bepaal voor elke plaatshouder, **uitsluitend uit de lokale dossierstukken**,
   de werkelijke waarde. Weet je het niet met zekerheid: laat de plaatshouder
   staan, of geef als "waarde" een tekst als
   `"[TE VERIFIËREN: vermoedelijke waarde — reden]"` mee — verzin nooit een
   waarde.
3. Schrijf de invullingen naar een lokaal JSON-bestand (kladbestand, bv. in de
   scratchpad-map), als een simpele object-map:
   ```json
   { "prijs_cijfers": "395.000", "naam_koper": "Jan Janssens" }
   ```
4. Voer het lokale invulscript uit (geen netwerkverkeer):
   ```bash
   npx tsx scripts/vul-werkdossier-lokaal.ts \
     --docx pad/naar/gedownload.docx \
     --waarden pad/naar/waarden.json \
     --out pad/naar/ingevuld.docx
   ```
   Dit vervangt elke gevonden plaatshouder door een échte Word-getrackte
   wijziging: de oude plaatshouder blijft zichtbaar als doorgehaalde tekst
   (`<w:del>`), de nieuwe waarde verschijnt als invoeging (`<w:ins>`) —
   precies zoals een medewerker het zelf had getypt met 'Wijzigingen
   bijhouden' aan.
5. **Controleer de uitvoer**: het script meldt `Ingevuld (N): …` en, als er
   een tikfout in een parameternaam zat, een `WAARSCHUWING — niet gevonden`
   met afsluitcode 2. Herstel de naam en herhaal de aanroep tot alles
   `ingevuld` is (of bewust bewaar je een resterende parameter, bv. omdat de
   naam in het model gewijzigd is — dan meld je dat aan de notaris).

## Stap 3 — Opleveren

Lever `ingevuld.docx` af met een korte controlelijst: welke velden lokaal
zijn ingevuld, welke bewust open bleven (`[AAN TE VULLEN]`/`[TE VERIFIËREN]`)
en waarom, en eventuele tikfouten die je moest herstellen. De notaris opent
het bestand zelf in Word om de getrackte wijzigingen na te lezen vóór
gebruik — dit blijft, zoals altijd bij Notary.AI, een werkdocument.

## Valkuilen

- **Nooit** de werkelijke dossiergegevens (namen, bedragen, data, RR-nummers,
  adressen) meegeven aan een Notary.AI-tool (kenmerken, `bevindingenJson`,
  `{{parameter}}`-waarden) — die reizen over het netwerk. Enkel het lokale
  script in stap 2 mag ze zien.
- **`bevindingenJson`** (de tabel "Bevindingen van de voorbereidende agent" in
  het .docx) is bedoeld voor een chat-only agent zónder bestandstoegang
  (Copilot Studio); als jij zelf lokale bestandstoegang hebt, gebruik je stap
  2 hierboven in plaats daarvan — niet allebei door elkaar.
- Het script vult platte tekst in (geen automatische vet-/onderlijnopmaak per
  parameter, zoals de server dat wél doet bij generatie). Voor een bedrag of
  naam die normaal vet zou staan, is dat een cosmetisch verschil, geen
  inhoudelijke fout — de notaris kan het bij het nalezen zelf vet maken.
- Een parameter die meermaals in het document voorkomt (bv. de prijs in
  verschillende clausules), wordt door het script overal in één keer
  vervangen — dat is bedoeld gedrag, geen bug.
- Geen `[AAN TE VULLEN: …]`-marker meer gevonden voor een parameter die je wél
  wou invullen? Controleer de exacte parameternaam in het `.docx` (kopieer
  hem letterlijk) — het script matcht exact, geen gedeeltelijke namen.