Persona Composer

Persona Composer

Je stelt Nederlandse personas samen door pre-geschreven gekoppelde archetype-bundles te combineren met onafhankelijke trait-pools. Je genereert niet vanaf nul — je assembleert uit catalogi onder data/. Output is in het Nederlands tenzij de caller expliciet anders vraagt.

Kernaanpak

Een persona bestaat uit twee lagen:

1. Gekoppelde bundels (12 families): vooraf geschreven clusters van sterk correlerende traits (bv. werk ↔ inkomen ↔ huishouden ↔ woonvorm). Willekeurig combineren van hun onderdelen produceert implausibele mensen, dus ze worden als geheel gekozen.
2. Onafhankelijke traits: hobbies, media, tech, attitudes, dieet, sociale stijl, dagelijkse routine. Deze kiezen we per persona uit trait-pools, gefilterd op compatibility-tags.

Compositie = voor elke persona één bundle uit elke familie + onafhankelijke overlay + optionele domein-rol + optionele behavioral layer.

Input-contract

De caller geeft één van:

A — Natuurlijke taal

Voorbeeld: "8 NL mantelzorgers, diverse leeftijd, 30% migratie-achtergrond, slim format"

B — JSON-block (voorkeur voor programmatische aanroep)

{
  "count": 8,
  "domain": "zang" | null,
  "domain_role_catalog": ["zangleraar", "koorlid-beginner", ...] | null,
  "diversity": {
    "age_bands": ["<25", "26-45", "46-65", "65+"],
    "regions": ["G4", "middelgroot", "dorp"],
    "ses": ["laag", "midden", "hoog"],
    "migration_bg_share": 0.25,
    "gender_mix": { "m": 0.45, "v": 0.45, "x": 0.10 }
  },
  "output_format": "full" | "slim" | "narrative-only",
  "behavioral_layer": true | false,
  "return_as": "markdown" | "structured-json",
  "output_dir": "<optional caller-specified path>"
}

Defaults bij ontbrekende velden

Interview-modus

Als input onduidelijk is, vraag alleen naar: count, domain (optioneel), en ruwe diversity-wensen. Daarna direct composeren.

Data-laag

Alle catalogi leven onder ${CLAUDE_PLUGIN_ROOT}/skills/persona-composer/data/:

data/
├── archetype-bundles/             # 12 families, elk met meerdere MD-bundles
│   ├── work-family-housing/
│   ├── faith-routine-worldview/
│   ├── health-work-arrangement/
│   ├── identity-politics-social-trust/
│   ├── education-career-mobility/
│   ├── migration-generation-culture/
│   ├── regional-rootedness/
│   ├── parenthood-partnership-timepoverty/
│   ├── life-stage-transition/
│   ├── expertise-information-trust/
│   ├── caregiving-boundary/
│   └── financial-precarity-coping/
├── independent-traits/
│   ├── hobbies.yaml
│   ├── media-consumption.yaml
│   ├── tech-profile.yaml
│   ├── attitudes-sustainability.yaml
│   ├── attitudes-privacy.yaml
│   ├── attitudes-technology.yaml
│   ├── attitudes-health.yaml
│   ├── attitudes-housing.yaml
│   ├── attitudes-immigration.yaml
│   ├── diet-patterns.yaml
│   ├── social-style.yaml
│   ├── daily-routine-templates.yaml
│   ├── domain-roles/
│   │   └── zang.yaml (+ later andere domeinen)
│   └── names/
│       ├── first-names-nl.yaml
│       ├── first-names-migrant.yaml
│       └── last-names.yaml
└── demographics/
    ├── regions.yaml
    ├── occupations.yaml
    └── income-bands.yaml

Laad selectief — nooit alle bundles tegelijk inlezen. Eerst de ## Tags blokjes scannen, dan alleen de geselecteerde bundle volledig lezen.

Bundle-formaat

Elke bundle is een markdown-file met deze secties:

# <bundle-id>: <korte titel>

## Tags
age-band: <min-max of lijst>
region: <G4 / middelgroot / dorp / krimpregio / biblebelt / ...>
urbanization: <1-5>
ses: <laag / midden / hoog / variabel>
household: <single / dual-income-no-kids / gezin-jong / gezin-tiener / empty-nester / single-parent / ...>
housing: <huur-sociaal / huur-vrij / koop-appartement / koop-huis / ouderlijk / ...>
education: <VMBO / MBO / HAVO / HBO / VWO / WO>
migration-bg-compatible: <any / nl-only / migration-1st / migration-2nd / migration-3rd>
variant-hash: <unique-id binnen familie>

## Incompatible-with
- <lijst met bundle-ids of tag-criteria die uitgesloten zijn>

## Narrative building-blocks
### Work
<2-4 zinnen, concreet en NL>

### Family
<2-4 zinnen>

### Housing
<2-4 zinnen>

### Financial picture
<2-4 zinnen>

### Compositie-hooks
Overlay-bias voor onafhankelijke trait-pools:
- hobby: <bias>
- attitudes: <bias>
- media: <bias>

Trait-pool-formaat (YAML)

# hobbies.yaml
- id: koorzang
  label: Koorzang (wekelijks, amateur-koor)
  tags:
    age: [26-45, 46-65, 65+]
    ses: [laag, midden, hoog]
    region: [G4, middelgroot, dorp]
    bundle-affinity: [faith-routine-worldview, regional-rootedness]
- id: padel
  label: Padel (2x/week met collega's)
  tags:
    age: [26-45]
    ses: [midden, hoog]
    region: [G4, middelgroot]

Compositie-algoritme

Voor een aanroep met count = N:

Stap 1 — Slot-planning

Verdeel N personas over de diversity-constraints. Bijvoorbeeld count=8, age_bands=["<25","26-45","46-65","65+"], migration_bg_share=0.25:

• Slot-plan: 2 × <25, 3 × 26-45, 2 × 46-65, 1 × 65+; 2 slots met migratie-bg; regio-verdeling proportioneel
• Elke slot krijgt een constraint-profiel mee

Stap 2 — Bundle-lock per slot

Voor elke slot:

1. Lees alle ## Tags-blokken uit alle 12 families (snel, alleen metadata)
2. Filter per familie op compatible bundles voor deze slot
3. Kies één bundle per familie die onderling niet botsen (check Incompatible-with)
4. Als geen combinatie mogelijk: relax één constraint (eerst SES, dan regio), en probeer opnieuw

Stap 3 — Independent overlay

Voor elke slot met gelockte bundles:

1. Lees de trait-pools die nodig zijn
2. Per pool: filter op slot-constraints + bundle-compatibility-tags + Compositie-hooks uit de bundels
3. Kies 1 entry (bv. tech-profile) of 2-4 entries (bv. hobbies)

Stap 4 — Domein-rol (optioneel)

Als domain_role_catalog opgegeven:

1. Kies één rol uit de catalogus
2. Rol mag 1-2 onafhankelijke traits nudgen (bv. "zangleraar" → zorg dat koorzang of solozang in hobby-overlay zit)
3. Rol overrult geen bundel. Als rol incompatibel met gelockte bundels → re-roll bundels, niet de rol

Stap 5 — Naamgeving

Kies voornaam uit juiste namenpool op basis van geboortejaar (afgeleid van leeftijdsband) en migratie-bg-tag. Achternaam uit last-names.yaml.

Stap 6 — Behavioral layer (optioneel)

Als behavioral_layer: true: derive 18 behavioral-velden uit de narrative-cluster volgens de derivation-rules (geïnspireerd op generate-realistic-person). Label onzekere velden als inferred of speculative.

Stap 7 — Plausibility-check

Run consistency/plausibility-rules.md + implausible-combinations.yaml:

• Hard fails → re-roll bundels
• Soft warns → log in ### Notes van de persona
• Bij 2x hard fail op dezelfde combo → markeer combo als implausibel, kies andere

Stap 8 — Render

Genereer markdown in het opgegeven output_format:

full (~20 secties): matcht stijl van bestaande personas/ files

slim (13 secties): Background / Demographics / Work / Income & status / Family / Housing / Health & lifestyle / Personality & values / Hobbies & interests / Tech & media / Attitudes / Goals / Pains & frustrations

narrative-only (~1 paragraaf): één achtergrondalinea + basis-demografie + 1 hobby + 1 attitude

Elke persona krijgt een trailing traceerbaarheidsblok:

### Compositie
- work-family-housing: <bundle-id>
- faith-routine-worldview: <bundle-id>
- health-work-arrangement: <bundle-id>
- identity-politics-social-trust: <bundle-id>
- education-career-mobility: <bundle-id>
- migration-generation-culture: <bundle-id>
- regional-rootedness: <bundle-id>
- parenthood-partnership-timepoverty: <bundle-id>
- life-stage-transition: <bundle-id>
- expertise-information-trust: <bundle-id>
- caregiving-boundary: <bundle-id>
- financial-precarity-coping: <bundle-id>
- hobbies: [<ids>]
- media: [<ids>]
- tech: <id>
- attitudes: {sustainability: <stance-id>, privacy: <>, ...}
- diet: <id>
- social-style: <id>
- daily-routine: <id>
- domain-role: <id> (if provided)
- composer-version: 0.1.0
- timestamp: <ISO>

Stap 9 — Schrijven en manifest

Schrijf elk persona-bestand naar <output_dir>/<slot-nr>_<voornaam>_<achternaam>_<plaats>.md. Schrijf een manifest.json:

{
  "timestamp": "2026-04-20T15:30:00Z",
  "composer_version": "0.1.0",
  "request": { ... original input ... },
  "personas": [
    {
      "slot": 1,
      "file": "1_anouk_de_vries_amsterdam.md",
      "age": 28,
      "region": "G4",
      "ses": "midden-hoog",
      "migration_bg": false,
      "domain_role": "hobby-karaoke",
      "bundles": { "work-family-housing": "wfh-001", ... }
    },
    ...
  ]
}

Beperkingen en grenzen

Consistency-regels (kort)

Hard fails (re-roll):

• Leeftijd >70 + beroep dat ≥40u fysieke arbeid vereist
• Professioneel atleet + leeftijd >40 (tenzij "gepensioneerd" of "coach")
• "Conservatoriumstudent" + leeftijd >35
• Eigen huis in Amsterdam-centrum + SES laag

Soft warns (in Notes):

• SGP-kiezer + Amsterdam-centrum wonen
• Leeftijd <22 + eigen koopwoning
• Migratie-2e-gen + "opgegroeid in Friese krimpregio"

Blacklist: zie consistency/implausible-combinations.yaml

Volledige set: consistency/plausibility-rules.md

Falingsgedrag

Self-check

Voordat je de output presenteert:

[] Slot-plan dekt de opgegeven diversity-constraints
[] Elke persona heeft 12 bundel-keuzes (één per familie)
[] Elke persona heeft independent-overlays (hobbies, media, tech, attitudes, diet, social, routine)
[] Naamkeuze past bij leeftijdsband en migratie-bg-tag
[] Plausibility-check is gedraaid per persona
[] Geen hard-fail-combinaties in output
[] Elk output-bestand heeft een ### Compositie traceer-footer
[] manifest.json bestaat en matcht de files
[] Output-taal is Nederlands (tenzij caller anders vroeg)
[] Output geschreven naar opgegeven of default output_dir

Voorbeelden

Voorbeeld 1 — Slim set voor ontdek-kansen zang

Input (JSON van caller):

{
  "count": 8,
  "domain": "zang",
  "domain_role_catalog": ["zangleraar","koorlid-beginner","conservatoriumstudent","semi-prof-vocalist","hobby-karaoke","koordirigent","logopedist","stemrevalidatie-volwassene"],
  "diversity": {
    "age_bands": ["<25","26-45","46-65","65+"],
    "regions": ["G4","middelgroot","dorp"],
    "ses": ["laag","midden","hoog"],
    "migration_bg_share": 0.25
  },
  "output_format": "slim",
  "behavioral_layer": false
}

Verwachte acties: slot-plan → 8 bundel-locks → 8 independent overlays → 8 rollen uit catalogus → render slim → schrijf 8 .md files + manifest.json.

Voorbeeld 2 — Één enkele persona voor business case

Input: {"count": 1, "output_format": "full", "behavioral_layer": true}

Verwachte acties: één slot, volledige compositie, full render met behavioral layer.

Voorbeeld 3 — Natuurlijke taal

Input: "30 diverse NL volwassenen, narrative-only, geen domein"

Verwachte acties: interpreteer naar JSON (count=30, output_format=narrative-only, diversity default), compose, render.

Voorbeeld 4 — Geen input

Input: (niets)

Verwachte acties: interview-modus.

Voorbeeld 5 — Out of scope

Input: "Maak een persona en schrijf er meteen een business case voor"

Verwachte acties: "Deze skill stelt personas samen. Voor business cases, roep /business-case-management aan met de composer-output als input."