# Promptbibliotheek opzetten en beheren

[[TOC]]

## Waarom een promptbibliotheek?

Elke prompt die je schrijft, test en verbetert is een investering. Zonder een bibliotheek raak je die investering kwijt: prompts worden vergeten, opnieuw geschreven, inconsistent toegepast of niet gedeeld met collega's.

Een promptbibliotheek is een gestructureerde, doorzoekbare verzameling van bewezen prompts die je hergebruikt, verbetert en deelt. Het is het verschil tussen ad-hoc promptwerk en professioneel promptbeheer.

## Minimale structuur voor een promptbibliotheek

Elke prompt in je bibliotheek heeft minimaal de volgende velden:

- **Naam**: duidelijke, beschrijvende naam (geen afkortingen).
- **Doel**: waarvoor gebruik je deze prompt?
- **Prompt**: de volledige prompttekst.
- **Variabelen**: welke onderdelen pas je aan per gebruik?
- **Model**: voor welk model is de prompt geoptimaliseerd?
- **Versie**: versienummer of datum van laatste aanpassing.
- **Testresultaten**: hoe presteert de prompt op je testset?

Optioneel maar nuttig:

- **Tags**: voor doorzoekbaarheid.
- **Eigenaar**: wie is verantwoordelijk voor onderhoud?
- **Gerelateerde prompts**: ketenprompts of alternatieven.

:::info title="Begin simpel"
Een markdownbestand in Git is een uitstekend startpunt. Voeg pas complexiteit toe (database, eigen UI) wanneer de eenvoudige aanpak echt te beperkend wordt.
:::

## Structuurkeuzes

**Plat versus hiërarchisch.** Een platte bibliotheek (alle prompts in een lijst) werkt tot ongeveer 50 prompts. Daarboven wil je categorieën: per use-case, per team of per modeltype.

**Bestandsgebaseerd versus database.** Markdownbestanden in Git zijn eenvoudig, versioneerbaar en doorzoekbaar via grep of de zoekfunctie van GitHub. Voor grotere teams met UI-wensen is een database of een dedicated tool handiger.

**Tools.** Een paar veelgebruikte opties:

| Aanpak | Sterk in | Aandachtspunt |
| --- | --- | --- |
| Notion of Confluence | Toegankelijk, goed deelbaar | Beperkt in versiebeheer |
| Git plus Markdown | Degelijk versiebeheer, developer-vriendelijk | Minder geschikt voor niet-developers |
| Promptfoo, LangSmith, Humanloop, PromptLayer | Native promptbeheer met evaluatie-integratie | Leercurve en eventueel kosten |

## Een prompttemplate

Onderstaand template is een werkbaar startpunt. Pas de velden aan op je eigen situatie.

```markdown
# Prompt: [Naam]

## Metadata
- Versie: 1.2
- Datum: 2026-06-01
- Model: Claude Sonnet 4.6, GPT-5.5
- Eigenaar: [naam of team]
- Tags: samenvatting, zakelijk, kort

## Doel
Vat zakelijke e-mails samen voor drukke managers.

## Prompt
Je bent een executive assistent. Vat de volgende e-mail samen voor een manager met weinig tijd.
Structuur:
- Actie vereist: [ja/nee, en welke actie]
- Kern in een zin
- Drie bullets met details

E-mail: {{EMAIL_TEKST}}

## Variabelen
- EMAIL_TEKST: de e-mail die samengevat moet worden

## Testresultaten
- Testset: 50 zakelijke e-mails
- Kwaliteitsscore (LLM-as-judge): 4.2/5
- Uitvalrate: 2%

## Notities
- Werkt minder goed bij e-mails langer dan 1000 woorden: split die dan in twee passages
- Versie 1.1: toon bijgesteld naar neutraler na feedback van collega's
```

:::tip title="Houd het modelveld actueel"
Modelnamen verouderen snel. In juni 2026 zijn Claude Sonnet 4.6 en GPT-5.5 actueel, maar de praktijk is dat er elke paar maanden een nieuwe versie verschijnt. Noteer het exacte model waarop je een prompt hebt getest, zodat je bij een modelwissel weet wat je opnieuw moet valideren.
:::

:::howto title="Zo zet je je eerste bibliotheek op"
1. **Begin met je meest gebruikte prompts.** Documenteer wat je al hebt voordat je nieuwe prompts toevoegt.
2. **Kies een opslagformaat.** Git plus Markdown voor developers, Notion of een dedicated tool voor niet-developers.
3. **Markeer de variabelen.** Geef aanpasbare delen consequent aan met `{{VARIABELE}}` of `[VARIABELE]`.
4. **Voeg testresultaten toe.** Maak de kwaliteit meetbaar bij het eerste gebruik.
5. **Plan onderhoud in.** Wijs eigenaren toe en plan reviewmomenten rond modelupdates.
:::

## Versiebeheer voor prompts

Prompts veranderen. Modellen worden geüpdatet, use-cases evolueren en feedback van gebruikers leidt tot verbeteringen.

Goed versiebeheer betekent:

- Elke wijziging is gedocumenteerd (wat is er gewijzigd en waarom).
- Terugkeren naar een eerdere versie is mogelijk.
- Je kunt versies met elkaar vergelijken op testresultaten.

In Git: gebruik commit messages die de verandering beschrijven, niet alleen "update prompt". Gebruik tags voor stabiele versies die in productie draaien.

## Samenwerking en governance

**Wie mag prompts toevoegen?** In kleine teams: iedereen. Bij grotere teams: een reviewproces met minimaal een reviewer.

**Hoe ga je om met conflicterende prompts?** Als meerdere mensen voor dezelfde use-case een prompt hebben, voer dan een A/B-test uit op de gedeelde testset en kies de winnaar op basis van de scores.

**Wanneer verwijder je prompts?** Als een prompt structureel slecht presteert, vervangen is door een betere versie of verwijst naar een afgeschaft model. Archiveer in plaats van verwijderen, zodat je de historie behoudt.

:::warn title="Onderhoud is geen bijzaak"
Een promptbibliotheek die niet wordt onderhouden, verandert snel in een bron van verouderde of slechte prompts. Plan onderhoudscycli rond modelupdates en leg eigenaarschap duidelijk vast.
:::

## Promptbibliotheek voor teams

Bij teamgebruik zijn extra afspraken nodig:

- **Naamgevingsconventie**: bijvoorbeeld `[team]-[usecase]-[versie]`, zoals `marketing-social-v2`.
- **Reviewworkflow**: nieuwe prompts worden voor publicatie gereviewd op kwaliteit en veiligheid.
- **Toegangsbeheer**: leg vast wie productieprompts mag aanpassen.
- **Changelog**: documenteer elke productiewijziging.

:::faq
### Hoe groot mag een promptbibliotheek worden?
Er is geen harde limiet, maar bij meer dan 200 prompts wordt je zoekmogelijkheid een knelpunt. Investeer dan in tags, categorieën en een goede zoekfunctie.

### Moet ik prompts voor verschillende modellen apart opslaan?
Ja, als de prompts significant verschillen. Sla modelspecifieke aanpassingen op als varianten van dezelfde basistemplate, zodat de samenhang bewaard blijft.

### Hoe migreer ik prompts naar een nieuw model?
Test de bestaande prompts op het nieuwe model met je evaluatiesuite, pas aan waar nodig, documenteer de wijzigingen en voer een A/B-test uit op je testset.

### Kan ik mijn promptbibliotheek delen buiten mijn bedrijf?
Prompts kunnen intellectueel eigendom zijn. Overweeg of je ze als bedrijfsgeheim behandelt, intern houdt of open source publiceert. De keuze hangt af van je businessmodel en de strategische waarde van de prompts.

### Welke tool kies ik voor promptbeheer?
Voor developers werkt Git plus Markdown prima. Heeft je team niet-technische gebruikers of wil je evaluatie en versiebeheer combineren, kijk dan naar tools als Promptfoo, LangSmith, Humanloop of PromptLayer.
:::

Een goed beheerde promptbibliotheek is een van de meest waardevolle AI-activa die je als team kunt opbouwen. Het is de opbouw van je promptexpertise over tijd, gemakkelijk deelbaar en voortdurend verbeterbaar.