--- name: parse-staatscourant description: Parse een Staatscourant-publicatie (KB-XML) naar Membership-proposals met evidence_snippet als verifieerbare substring. Gebruik wanneer de gebruiker zegt 'parse staatscourant', 'verwerk KB', 'extract benoemingen', 'lees besluittekst', of in English 'parse staatscourant', 'extract appointments', 'process KB document', of een Staatscourant-XML aanlevert. version: 0.2.0 triggers: - parse staatscourant - verwerk KB - extract benoemingen - lees besluittekst - parse staatscourant - extract appointments - process KB document --- # parse-staatscourant ## Doel Lees een Staatscourant-publicatie (KB-XML van KOOP / officielebekendmakingen.nl) en zet de tekst om in Membership-proposals voor Polder. Eén proposal per benoeming, ontslag of verlenging in het KB. ## Input - Pad naar een XML-bestand, of een XML-string in geheugen. - Format: KOOP SRU-response, of een export van zoek.officielebekendmakingen.nl. - Optioneel: publicatiedatum en bron-URL als die niet uit het XML komen. ## Output **ALLEEN JSON-array als laatste output, geen andere tekst.** Output is een JSON-array met proposals, één per benoeming of ontslag. Geen introductietekst, geen samenvatting, geen markdown-fences, geen "Next step:"-suggesties. Alleen de array. **Schrijf zelf geen bestanden.** De runner vangt jouw stdout op en schrijft die naar het juiste pad. Gebruik nooit `Write` of `>` om JSON naar disk te zetten, en noem geen output-pad in je antwoord. Elk proposal heeft: - `person_name` (string): naam zoals in het KB, met titulering en initialen. - `existing_person_id` (string of null): polder-slug bij match, anders null. - `organization_id` (string): slug van de organisatie waar het KB op slaat. - `post_id` (string): slug van de post (bijv. `post:sg-min-bzk`). **NOOIT** een ABD-functie (raadadviseur, directeur, afdelingshoofd, SG, DG, IG, kwartiermaker, projectleider) mappen op `post:minister-*` of `post:staatssecretaris-*`. Een ambtenaar is geen bewindspersoon. - `role` (string): tekst zoals "Secretaris-Generaal van het Ministerie van BZK". - `start_date` (ISO 8601): ingangsdatum van de benoeming. - `end_date` (ISO 8601 of null): null voor benoeming, datum voor ontslag. - `decision_reference` (string): KB-nummer plus datum, bijv. "KB nr. 2026-001234, 15 april 2026". - `staatscourant_url` (string): URL naar de publicatie. - `confidence` (float, 0 tot 1). - `confidence_reasoning` (string): welke signalen meetelden. - `evidence_snippet` (string): letterlijke substring uit het KB-XML met de feiten. ## Stappen voor de LLM 1. Laad XML met `lxml.etree`. Zoek ``, `` of `` elementen voor de besluitinhoud. Onderwerp staat in ``, datum in `` of ``. 2. Identificeer per KB welke organisatie het betreft. Lees titel, onderwerp en eerste alinea. Match tegen `data/organisaties/` op naam of afkorting. 3. Voor elke benoeming of ontslag in de tekst: - Extract persoonsnaam (titulering, voornamen of initialen, achternaam). - Extract functie (Secretaris-Generaal, Directeur-Generaal, plaatsvervangend SG, ...). - Extract ingangsdatum: zoek "per " of "met ingang van ". - Extract KB-referentie: zoek "bij koninklijk besluit van , nr. ". 4. Stel `organization_id` en `post_id` voor volgens de Polder-conventie. Voor ministeries: `org:min-` (bv. `org:min-def`, `org:min-fin`, `org:min-jenv`, `org:min-bzk`, `org:min-ocw`, `org:min-szw`, `org:min-vws`, `org:min-bz`, `org:min-ienw`, `org:min-lvvn`, `org:min-az`, `org:min-ezk`, `org:min-kgg`). Bewindspersoon-posts: `post:minister-min-` of `post:staatssecretaris-min-`. Een aliassen-fallback in de resolver matcht varianten zoals `org:ministerie-defensie` of `post:minister-defensie` ook op de canonical slug, dus exactheid is geen blocker, maar volg de conventie waar je hem kent. 5. Bouw het proposal. Confidence-rubriek: - Volledige naam plus expliciete functie plus expliciete datum plus KB-referentie: 0.95 of hoger. - Naam ambigu (twee of meer matches in `data/personen/`): maximaal 0.7, forceert review. - KB-referentie ontbreekt of post niet matchbaar: maximaal 0.6. 6. Substring-check vóór output: `assert evidence_snippet in raw_xml_text`. Faal hard als de assert false retourneert. Geen paraphrase, geen normalisatie, geen whitespace-trimming. ## Harde regels 1. **Quote-or-die.** `evidence_snippet` is een letterlijke substring van het XML. Validator faalt anders. 2. **Two-source rule.** Een proposal merget alleen automatisch als `confidence` minimaal 0.98 is plus een 7-daags review-window. Anders is een tweede onafhankelijke bron vereist. 3. **Staging-only.** Schrijf naar `data/_staging/staatscourant-YYYY-MM-DD.json`. Nooit direct naar `data/organisaties/`, `data/personen/` of `data/posten/`. 4. **Confidence per proposal** als float in [0, 1] met expliciete `confidence_reasoning`. 5. Geen BSN, geen geboortedatum, geen privé-contactgegevens in een proposal. Alleen jaartal in `birth.year` als die elders al vaststaat. ## Voorbeeld Zie `example_input.xml` voor een KB-fragment, en `example_output.json` voor het bijbehorende proposal. De `evidence_snippet` in het output-bestand is letterlijk te vinden in de input. ## Aanroep in workflow ```yaml - uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: | Lees alle nieuwe KB's uit _cache/staatscourant/ en parse met de parse-staatscourant skill. Schrijf proposals naar data/_staging/staatscourant-{date}.json. claude_args: "--model claude-haiku-4-5 --max-turns 10" ``` ## Aanroep vanuit Claude Code CLI ```bash claude "Gebruik parse-staatscourant op _cache/staatscourant/stcrt-2026-12345.xml en schrijf naar data/_staging/staatscourant-2026-05-09.json" ``` ## Status Actief, versie 0.2.0. Tweede skill na review-pr-diff.