| name | parse-abd-nieuws |
| description | Parse een ABD-nieuwsbericht (HTML van algemenebestuursdienst.nl/actueel/nieuws) naar Membership-proposals met evidence_snippet als verifieerbare substring en organization_chain (ministerie, DG, directie, afdeling). Gebruik wanneer de gebruiker zegt 'parse abd-nieuws', 'verwerk abd-bericht', 'extract benoeming uit abd', 'lees abd-nieuwsbericht', of in English 'parse abd news', 'extract appointments from abd', 'process abd article'. |
| version | 0.6.0 |
| triggers | ["parse abd-nieuws","verwerk abd-bericht","extract benoeming uit abd","lees abd-nieuwsbericht","parse abd news","extract appointments from abd","process abd article"] |
parse-abd-nieuws
Instructie: OUTPUT ENKEL JSON
Je gaat een ABD-nieuwsbericht (HTML) in een membership-proposal omzetten. De ENIGE output die je moet produceren is een JSON-array. GEEN inleiding, GEEN analyse, GEEN verklaring, GEEN samenvatting. Alleen het JSON, startend met [ en eindigend met ].
Doel
Lees een nieuwsbericht van algemenebestuursdienst.nl/actueel/nieuws/... (HTML) en zet de tekst om in Membership-proposals voor Polder. Eén proposal per benoeming, ontslag of verlenging in het bericht. ABD plaatst benoemingen vaak voor het KB in de Staatscourant, dus deze skill is een early-warning bron.
Input
Een gestructureerde plain-text payload met deze secties (in volgorde):
CANONICAL_URL:
<absolute URL van het nieuwsbericht>
TWITTER_DESCRIPTION:
<éénregelige samenvatting van de benoeming, hoogste signaal-dichtheid>
STAATSCOURANT_URLS: (optioneel, alleen als er Staatscourant-links in het bericht staan)
<URL 1>
<URL 2>
...
BODY:
<plain-text artikel-tekst, footer-boilerplate al afgekapt>
CANONICAL_URL is de waarde voor abd_nieuws_url in elk proposal.TWITTER_DESCRIPTION is de gegarandeerde kern-zin: hieruit haal je in de meeste gevallen person_name, role, organization, en start_date.STAATSCOURANT_URLS (als aanwezig) levert staatscourant_url. Als de sectie ontbreekt, is staatscourant_url null.BODY bevat de volledige artikel-tekst voor extra context: KB-referentie, opvolging, CV-zinnen, datum-bevestiging via Nieuwsbericht DD-MM-YYYY.- Datum leid je af uit het URL-pad in
CANONICAL_URL (/YYYY/MM/DD/) of uit BODY.
Output
ALLEEN JSON-array als laatste output, geen andere tekst. Geen introductie, geen samenvatting, geen markdown-fences, geen "Next step:". De runner vangt jouw stdout op en schrijft die naar het juiste pad. Schrijf zelf geen bestanden met Write en noem geen output-pad in je antwoord. Tools zijn alleen voor read-only lookups (polder search, polder show).
JSON-array met proposals, één per benoeming, ontslag, verlenging of aankondiging. Elk proposal in de array heeft:
person_name (string): naam zoals in het bericht, met titulering en initialen indien aanwezig.existing_person_id (string of null): polder-slug bij match in data/personen/, anders null.organization_id (string): slug van het diepste organisatie-niveau dat in het bericht genoemd wordt (afdeling boven directie boven DG boven ministerie). Verbreed niet automatisch.organization_chain (array): hiërarchische keten vanaf ministerie naar afdeling. Elke entry is {level, name, slug_proposal}. Levels: ministerie, directoraat-generaal, directie, afdeling. Alleen niveaus die letterlijk in het bericht voorkomen, in volgorde van top naar diepst.post_id (string): slug van de post (bijv. post:dg-migratie-min-jenv of post:afdelingshoofd-beleid-wonen-min-vro). Stel een nieuwe slug voor als er geen match is, en flag dat in confidence_reasoning. NOOIT een ABD-functie (raadadviseur, directeur, afdelingshoofd, SG, DG, IG, kwartiermaker, projectleider) mappen op een post die begint met post:minister- of post:staatssecretaris- of post:vice-minister-. Een raadadviseur "bij het Kabinet Minister-President" is geen minister-president maar een ambtenaar; gebruik een nieuwe slug zoals post:raadadviseur-<portefeuille>-min-az.role (string): functie zoals "Afdelingshoofd Beleid Wonen, Directie Wonen, ministerie van VRO". Casing: begin de role met een hoofdletter (de functietitel: Afdelingshoofd, Directeur, Directeur-generaal, Secretaris-generaal, Minister, Staatssecretaris, ...) ook als het bericht klein schrijft. Uitzondering: gevestigde afkortingsvormen die met een kleine letter beginnen (pSG, plv.). Dit raakt alleen het afgeleide role-veld; een letterlijke evidence_snippet behoudt de bron-casing (quote-or-die).start_date (ISO 8601 of null): ingangsdatum van de benoeming, expliciet uit "per " of "met ingang van ".end_date (ISO 8601 of null): null bij benoeming, datum bij ontslag of einde verlenging.decision_reference (string): KB-nummer als het bericht dit noemt, anders "ABD-nieuwsbericht <YYYY-MM-DD>".staatscourant_url (string of null): URL naar het KB in de Staatscourant als het bericht ernaar linkt; anders null.abd_nieuws_url (string, verplicht): de canonical URL van het nieuwsbericht.event_type (string): één van benoeming, ontslag, verlenging, aankondiging, overlijden, overig.confidence (float, 0 tot 1).confidence_reasoning (string): welke signalen meetelden, en welke ontbreken.evidence_snippet (string): letterlijke substring uit de payload (uit TWITTER_DESCRIPTION of BODY) met de feiten.
Stappen voor de LLM
-
Lees de payload-secties (CANONICAL_URL, TWITTER_DESCRIPTION, evt. STAATSCOURANT_URLS, BODY). De combined payload is je raw text voor de evidence-substring-check; evidence_snippet MOET een letterlijke substring van de payload zijn (whitespace en interpunctie meetellen).
-
Identificeer organisatie en post. Lees titel, eerste alinea en de "bij " suffix. Stel slugs voor volgens de Polder-conventie: ministeries als org:min-<afkorting> (org:min-jenv, org:min-fin, org:min-bzk, ...), DG/directie/afdeling als org:onderdeel-<slug>-min-<min-slug>. De resolver matcht varianten (ministerie-X, minister-X) achteraf op de canonical slug, dus exactheid is geen blocker; volg de conventie waar je hem kent.
-
Zoek benoemings- en ontslagpatronen. ABD-berichten volgen meestal één van deze sjablonen:
- Standaard benoeming: "X wordt [met ingang van ] bij/onderdeel van . ... De benoeming gaat in op ."
- Alternatief: "X wordt , een van de bij het ministerie van Y. De benoeming gaat in op ."
- Ontslagmelding: "X neemt afscheid / vertrekt per . X wordt opgevolgd door Y."
- Verlenging: "X wordt herbenoemd / verlengd als voor ."
- Overlijdensbericht: "X is op overleden" / "X is op -jarige leeftijd overleden" / "In memoriam: X". Hier is er geen post-mutatie; het bericht meldt een overlijden van een (oud-)topambtenaar.
-
Per benoeming of ontslag in de tekst:
- Extract persoonsnaam (volledige naam, zelden titulering).
- Extract functie. Let op samenstellingen zoals "kwartiermaker/directeur", "waarnemend pSG", "plaatsvervangend directeur".
- Extract ingangsdatum: zoek "De benoeming gaat in op ", "per ", "met ingang van ", of bepaal uit context.
- Extract KB-referentie als die in het bericht staat (meestal laatste alinea).
-
Identificeer organisatie-niveaus. Berichten beschrijven vaak een keten van top naar diepst:
- "ministerie van X" (top, level
ministerie).
- "directoraat-generaal Y" of "DG Y" (level
directoraat-generaal, organisatieonderdeel).
- "directie Z" of "concerndirectie Z" (level
directie).
- "afdeling W" (level
afdeling, het diepst).
Extract alle niveaus die het bericht letterlijk noemt en bouw organization_chain als array van top naar diepst. Per entry een slug-voorstel volgens de Polder-conventie:
- Ministerie:
org:min-<slug> (bestaat al, ROO).
- DG, directie, afdeling:
org:onderdeel-<slug>-min-<min-slug> of korter org:onderdeel-<slug> als die slug al bestaat in data/organisaties/organisatieonderdelen/.
organization_id is altijd de slug van het diepste niveau in organization_chain. Geen automatische verbreding: als het bericht alleen "directeur Wonen" zegt, is organization_id directie-niveau; bij "afdelingshoofd Beleid Wonen" is het afdeling-niveau.
Chain is verplicht voor abd-classification-rollen. Voor directeur, afdelingshoofd, secretaris-generaal, directeur-generaal, inspecteur-generaal: lever ALTIJD minimaal 2 chain-entries (ministerie + één tussenliggend organisatieonderdeel). Een directeur hoort onder een directie of agentschap, geen ministerie direct. Als de bron het tussenliggende niveau niet expliciet noemt: leid het af uit de role-string ("directeur concerndirectie Mens en Organisatie" -> concerndirectie als chain[1] met slug org:onderdeel-concerndirectie-mens-en-organisatie-min-<min>). Een chain met alleen ministerie + organization_id=ministerie is fout voor deze classifications.
-
Bouw event_type. Heuristieken:
- Titel of tekst noemt "benoemd", "wordt directeur", "wordt DG":
benoeming.
- "neemt afscheid", "vertrekt", "wordt opgevolgd":
ontslag.
- "verlengd", "wordt herbenoemd":
verlenging.
- "is overleden", "overlijdensbericht", "is op X-jarige leeftijd overleden", "in memoriam":
overlijden.
- Persbericht zonder concrete persoon-functie-koppeling (jaarverslag, ABD-blad):
overig met confidence-cap 0.4.
Bij overlijden: post_id, organization_id en organization_chain zijn niet van toepassing. Een overlijden is geen post-mutatie maar sluit van rechtswege alle nog lopende mandaten. Lever post_id: null, organization_id: null, organization_chain: []. Vul end_date met de overlijdensdatum (uit "is op DD-MM-YYYY overleden", "op DD-MM-YYYY", of "Nieuwsbericht DD-MM-YYYY" als laatste terugval). Laat start_date: null. person_name is verplicht; existing_person_id invullen als je een match in data/personen/ vindt (de resolver matcht anders op familienaam).
-
Bepaal confidence volgens de regels in "Confidence-bepaling" hieronder.
-
Substring-check vóór output: assert evidence_snippet in payload_text waar payload_text de complete input-payload is (alle secties samen). Faal hard als de assert false retourneert. Geen paraphrase, geen normalisatie, geen whitespace-trimming.
Confidence-bepaling
Vanaf v0.4.0 vervangen onderstaande regels de oude vlakke 0.85-cap. De drempel voor apply-staging-auto is 0.85; tussen 0.85 en 0.94 is een proposal dus auto-mergeable.
Floor: 0.85 als de vier kernfeiten expliciet en ondubbelzinnig zijn
Bij event_type van benoeming, ontslag of verlenging geldt een vloer van 0.85 als alle vier hieronder waar zijn:
- Familienaam expliciet in de tekst (volledige achternaam letterlijk genoemd).
- Functie expliciet (functietitel woordelijk in de tekst).
- Organisatie expliciet (ministerie of organisatieonderdeel woordelijk genoemd, of duidelijk in de
organization_chain).
- Datum expliciet (
start_date of end_date afleidbaar uit een ISO-converteerbare datum-frase).
Als deze vier kloppen: confidence mag niet onder 0.85 zakken, ook niet door de verzwarende factoren hieronder.
Cap: 0.94 zonder staatscourant_url
De two-source rule blijft staan: zonder externe verificatie via een Staatscourant-URL is de bovengrens 0.94. Met een geldige staatscourant_url mag de confidence tot 0.97. Boven de 0.97 vereist een tweede onafhankelijke bron buiten ABD plus Staatscourant.
Lagere ceiling bij ontbrekende kernfeiten
- 1 van de 4 kernfeiten ontbreekt (bijvoorbeeld geen datum, of organisatie alleen impliciet): max 0.80.
- 2 of meer kernfeiten ontbreken: max 0.65.
- Naam ambigu (twee of meer matches in
data/personen/ zonder onderscheidende informatie): max 0.55, forceert review.
Overlijden: aparte schaal
Een overlijden-proposal kent geen vier kernfeiten (geen functie/organisatie/start). De confidence hangt af van twee dingen:
- Familienaam expliciet in titel of body.
- Overlijdensdatum expliciet (een ISO-converteerbare datum uit "op DD-MM-YYYY overleden" of, bij ontbreken, de berichtdatum als die als overlijdensdatum gelezen kan worden).
Beide expliciet: confidence 0.90. Alleen naam, datum onzeker of alleen berichtdatum als proxy: 0.70. De two-source-cap is hier niet van toepassing: een ABD-overlijdensbericht is de gezaghebbende bron voor het feit zelf. De resolver/apply sluit alleen mandaten van een eenduidig gematchte persoon; bij ambigue naam forceert de lage person-confidence sowieso review.
Verzwarende factoren (verlagen, niet onder de floor)
- "voorlopig", "tijdelijk", "vermoedelijk" in de zin rond de benoeming: -0.05 op de berekende confidence.
- Meerdere benoemingen in één bericht waarvan onduidelijk welke persoon welke post krijgt: cap 0.70 op alle betrokken proposals, met expliciete note in
confidence_reasoning.
- Functie of niveau niet matchbaar tegen bestaande post of organisatieonderdeel in
data/: cap 0.85 (op het floor-niveau, niet eronder), met de nieuwe slug-suggestie expliciet in confidence_reasoning.
Verzwarende factoren mogen de confidence niet onder 0.85 brengen wanneer de basis 4-uit-4 expliciet was. De boete voor "voorlopig" is een nuance, geen blokkade.
Voorbeelden
Aart van der Vlist (waarnemend pSG bij EZK, 20 april 2026):
- Familienaam ✓, functie "waarnemend pSG" ✓, organisatie "EZK" ✓, datum "20 april 2026" ✓.
- Geen
staatscourant_url: cap 0.94.
- Geen verzwarende factoren.
confidence = 0.92.
Gerdine Keijzer-Baldé (legt pSG-functie neer, 13 april 2026):
- Familienaam ✓, functie "pSG (voorlopig)" ✓, organisatie "EZK" ✓, datum "13 april 2026" ✓.
- Geen
staatscourant_url: cap 0.94.
- "voorlopig" in de zin: -0.05.
confidence = 0.89.
Beide vallen boven de 0.85-drempel en zijn auto-mergeable in apply-staging.
Harde regels
- Quote-or-die.
evidence_snippet is een letterlijke substring van de input-payload (TWITTER_DESCRIPTION of BODY). Validator faalt anders.
- Two-source rule. Een proposal uit alleen ABD-nieuws krijgt confidence-cap 0.94 (was 0.85 in v0.3.0). Met expliciete KB-link of staatscourant-URL in de tekst mag de cap naar 0.97. Boven 0.97 vereist een derde onafhankelijke bron.
- Staging-only. Schrijf naar
data/_staging/abd-nieuws-YYYY-MM-DD.json. Nooit direct naar data/personen/, data/organisaties/ of data/posten/.
- Geen privé-data. Alleen functie en naam en datum. Geen geboortedatum (alleen jaartal als die elders al vaststaat), geen contactgegevens, nooit BSN.
- Confidence per proposal als float in [0, 1] met
confidence_reasoning als string. Volg de regels in "Confidence-bepaling".
- Niveau-discipline.
organization_chain bevat alleen niveaus die letterlijk genoemd worden. Geen geraden DG-tussenlaag als het bericht die niet noemt. organization_id is het diepste niveau, niet het breedste.
Voorbeeld
Zie example_input.md voor de relevante body-tekst van een ABD-nieuwsbericht (afdelingsbenoeming met vier niveaus), en example_output.json voor het bijbehorende proposal met organization_chain. De evidence_snippet in het output-bestand is letterlijk te vinden in de input.
Aanroep vanuit Claude Code CLI
claude "Gebruik parse-abd-nieuws op _cache/abd-nieuws/marleen-heijster-afdelingshoofd-beleid-wonen-2026-05-09.html en schrijf naar data/_staging/abd-nieuws-2026-05-09.json"
Status
Actief, versie 0.6.0. Vierde skill in Polder, na review-pr-diff, parse-staatscourant en parse-organogram. Nieuw in 0.6.0: event_type: overlijden met eigen confidence-schaal; sluit van rechtswege alle lopende mandaten via een aparte apply-sweep, zonder post/org. Nieuw in 0.4.0: confidence-vloer 0.85 bij vier expliciete kernfeiten, cap 0.94 zonder staatscourant_url, en expliciete verzwarende factor voor "voorlopig"-formuleringen. Nieuw in 0.3.0: organization_chain met expliciete niveau-keten en organization_id op diepste genoemde niveau.
KRITIEK: OUTPUT ENKEL JSON, GEEN MARKDOWN
Je eindresultaat moet zuiver JSON zijn, zonder markdown code blocks. Dus NIET:
```json
[...]
Maar dit (start direct met `[`):
[...]
WICHTIG: Geen ` ```json `, geen ` ``` ` eromheen. Geen inleiding. Geen samenvatt. Alleen de array, eerste karakter `[`, laatste karakter `]`.
