Context engineering: het werk vóór de prompt

spinny:~/writing $ vim context-engineering-agents.md

1~
2Het woord van dit moment, in de kleine wereld van AI-agenten, is context engineering.
3~
4Het lijkt alsof er weer een label is uitgevonden om iets te verkopen dat we al deden. Voor een deel is dat zo. Maar zoals vaak gebeurt, slaat het etiket aan omdat het een naam geeft aan een echte pijn.
5~
6De pijn is dit: modellen falen niet alleen omdat ze ‘niet denken’. Vaak falen ze omdat we ze met de verkeerde kamer naar het werk sturen.
7~
8We geven ze oude instructies. We verbergen belangrijke bestanden voor hem. We geven ze documenten door die te lang zijn en zeggen niet wat er toe doet. We laten ze logboeken zien zonder prioriteit. We geven ze tien hulpmiddelen zonder uit te leggen wanneer ze te gebruiken. Dan zijn we verrast als de agent zich beweegt als een persoon die wakker wordt in een onbekend appartement.
9~
10De prompt is de zin die u erop zegt. De context is de wereld die je eromheen voorbereidt.
11~
12## Van prompt-engineering naar context-engineering
13~
14Snelle engineering werd vaak gezien als schrijven. Kies de juiste woorden, vraag op de juiste manier, voeg voorbeelden toe, specificeer het format.
15~
16Context engineering staat dichter bij architectuur.
17~
18Je vraagt niet alleen maar: “hoe formuleer ik het verzoek?”. Het vraagt:
19~
20- welke informatie is echt nodig?
21- wat is lawaai?
22- wat moet er direct worden hersteld?
23- wat moet onthouden worden?
24- welke instrumenten moeten worden blootgesteld?
25- welke instructies zijn stabiel en welke zijn afhankelijk van de taak?
26- hoe zorg ik ervoor dat de agent begrijpt wat gezaghebbend is?
27~
28Het is een subtiele maar enorme verandering. Want als je met agenten werkt, is context geen statisch blok. Het verandert bij elke stap.
29~
30De agent opent een bestand, leert iets, voert een test uit, ontvangt een foutmelding, werkt het plan bij, roept een tool aan, ontdekt een afhankelijkheid. Elke ronde moet hij beslissen wat hij meeneemt en wat hij weglaat.
31~
32Dit is techniek.
33~
34## De context is geen stortplaats
35~
36Sjablonen met grote contextvensters brachten ons in de verleiding: laten we alles erin gooien.
37~
38Het is begrijpelijk. Als ik een miljoen tokens heb, waarom zou ik dan kiezen?
39~
40Want zelfs als je alles erin kunt stoppen, wil dat nog niet zeggen dat alles helpt. Lawaai heeft inderdaad een prijs. Het kost tokens, het kost aandacht, het kost latentie, het kost kwaliteit. Een model kan net als wij verdwalen in irrelevante details wanneer we twintig tabbladen openen en niet meer weten waarom.
41~
42Goede context kent een hiërarchie:
43~
441. systeeminstructies en beleid;
452. specifieke doelstelling;
463. huidige status;
474. relevante gegevens;
485. beperkingen;
496. beschikbare hulpmiddelen;
507. volg de reeds genomen beslissingen.
51~
52Het is niet nodig om alles op hetzelfde niveau te behandelen. Een gebruikersopdracht is meer waard dan een oude notitie. Een mislukte test is nu meer waard dan een esthetische voorkeur van drie maanden geleden. Een beveiligingsbeleid is meer waard dan een productiesnelkoppeling.
53~
54Context-engineering betekent ook het geven van gewichten, niet alleen aan gegevens.
55~
56## Geheugen: onthoud minder, onthoud beter
57~
58Het geheugen bij agenten is een van de meest lastige onderwerpen.
59~
60Als gebruiker wilt u dat de agent u kent. Je wilt dat hij de toon onthoudt, het plan, de conventies, de dingen die al besloten zijn. Als ingenieur weet je dat elke hardnekkige herinnering ook een risico inhoudt: ze kan verkeerd, oud, te persoonlijk, te algemeen, niet verifieerbaar zijn.
61~
62Een nuttig geheugen moet minstens drie kwaliteiten hebben:
63~
64- herkomst: waar komt deze informatie vandaan?
65- datum: wanneer was het waar?
66- doel: voor welk soort taak moet het worden gebruikt?
67~
68Zonder deze drie dingen wordt de herinnering bijgeloof.
69~
70Ik beschouw het agentische geheugen graag als een werkboek, niet als een magische geest. Er zijn tijdelijke aantekeningen, bevestigde beslissingen, stijlvoorkeuren, technische beperkingen, links naar bronnen. Sommige dingen vervallen. Sommige moeten herschreven worden. Sommige moeten worden geëlimineerd omdat de agent ze verkeerd heeft geïnterpreteerd.
71~
72Een goed systeem moet dit onderhoud normaal maken. Niet heroïsch.
73~
74## Ophalen en gereedschap zijn niet hetzelfde
75~
76Als we het over context hebben, komen we vaak meteen op RAG terecht. Inbedding, vectordatabase, chunking, herrangschikking.
77~
78Allemaal nuttig. Maar ophalen is slechts één manier om informatie naar het model te brengen. Hij is niet de enige.
79~
80Een agent kan context krijgen door bestanden te lezen, een API te bevragen, een MCP-server aan te roepen, een browser te openen, tests uit te voeren, in Slack te zoeken, naar een dashboard te kijken, de mens te vragen.
81~
82Het interessante deel is beslissen welke route je moet gebruiken en wanneer.
83~
84Als de agent een historische vraag moet beantwoorden, is het ophalen misschien voldoende. Als hij een bug moet repareren, moet hij echte code lezen. Als hij wil begrijpen waarom een implementatie mislukt, moet hij naar nieuwe logboeken kijken. Als u een klant wilt schrijven, moet u de toon, de geschiedenis en de status van het ticket ophalen. Als hij tijdens de productie moet optreden, moet hij toestemming vragen.
85~
86Context is geen database. Het is een werkstroom.
87~
88## De goede agent weet ook hoe hij moet negeren
89~
90Een teken van volwassenheid bij agenten zal het vermogen zijn om te zeggen: ik heb deze informatie niet nodig.
91~
92Het lijkt triviaal, maar het is heel moeilijk. Veel agentische systemen stapelen zich op. Elke tooloproep voegt tekst toe. Elke fout blijft in de buffer. Elk gelezen bestand wordt toegevoegd aan de stapel. Uiteindelijk heeft het model een zeer lange geschiedenis en geen kaart.
93~
94Compressie is nodig. Tussensynthese is nodig. Het moet gestructureerd zijn.
95~
96Niet "dat is alles wat er gebeurde", maar:
97~
98- doelstelling nog steeds geldig;
99- huidige hypothese;
100- bestanden al gecontroleerd;
101- genomen beslissingen;
102- openstaande risico's;
103- volgende actie.
104~
105Dit maakt de agent minder theatraal en behulpzamer. Niet omdat hij slimmer lijkt, maar omdat hij met een opgeruimd bureau werkt.
106~
107## Context-engineering voor teams, niet voor snelle artiesten
108~
109De reden dat dit onderwerp mij interesseert, is dat het de verantwoordelijkheid verschuift van het individu naar het systeem.
110~
111Bij snelle engineering wint vaak degene die het beste met het model kan praten. Bij context engineering wint het team dat zijn werk het beste organiseert: documentatie, conventies, issues, logs, tests, eigendom, naamgeving, bronnen.
112~
113Een schone repository wordt een betere context. Een goed geschreven probleem wordt betere brandstof. Een bijgewerkt runbook bespaart tokens en zorgen. Een duidelijk changelog vermindert hallucinaties.
114~
115Dit is goed en enigszins ongemakkelijk nieuws. Mooi omdat het goede praktijken beloont. Lastig, want met een slimme prompt kun je niet alles oplossen.
116~
117De agenten versterken de hygiëne van het systeem dat ze aantreffen.
118~
119## Hoe ik het morgen zou toepassen
120~
121Als ik context-engineering in een echt project zou introduceren, zou ik beginnen met kleine dingen:
122~
123- een kort en onderhouden projectinstructiebestand;
124- goede voorbeelden van verwachte output;
125- een lijst met beschikbare hulpmiddelen en cases waarin deze kunnen worden gebruikt;
126- bouwkundige beslissingen op citeerbare wijze geschreven;
127- probleem met minimale verplichte context;
128- eenvoudig opvragen van logs en tests;
129- persistent geheugen dat door mensen kan worden gewijzigd.
130~
131Dan zou ik iets simpels meten: hoe vaak moet de agent om opheldering vragen of gaat hij de verkeerde kant op?
132~
133Als het vaak voorkomt, zou ik niet meteen een groter model toevoegen. Ik zou naar de context kijken.
134~
135## Mijn lezing
136~
137Context-engineering is een beetje een opgeblazen woord, ja. Maar het concept is gezond.
138~
139Het herinnert ons eraan dat de intelligentie van een agent niet alleen in het model zit. Het ligt in de omgeving die we voor hem voorbereiden: wat hij ziet, wat hij zich herinnert, wat hij kan doen, wat hij niet mag doen, welke bronnen hij als waar herkent.
140~
141Het menselijke deel is dit: de context goed voorbereiden is een vorm van zorg. Het zegt tegen de agent, maar ook tegen het team: "Ik wil niet dat je het raadt, ik wil dat je krijgt wat je nodig hebt."
142~
143Minder magie. Schonere kamer. Agenten hebben het net zo hard nodig als wij.
144~
145## Bronnen
146~
147- [LangChain Blog: De opkomst van context-engineering](https://blog.langchain.com/the-rise-of-context-engineering/)
148- [Simon Willison: Context-engineering](https://simonwillison.net/2025/Jun/27/context-engineering/)
149- [Model Context Protocol: Introductie](https://modelcontextprotocol.io/introduction)
150- [Antropisch: effectieve agenten bouwen](https://www.anthropic.com/engineering/building-effectieve-agents)
151- [OpenAI: nieuwe tools voor bouwagenten](https://openai.com/index/new-tools-for-building-agents/)
152~

NORMAL · context-engineering-agents.md [readonly]152 lines · :q to close

2Het woord van dit moment, in de kleine wereld van AI-agenten, is context engineering.

4Het lijkt alsof er weer een label is uitgevonden om iets te verkopen dat we al deden. Voor een deel is dat zo. Maar zoals vaak gebeurt, slaat het etiket aan omdat het een naam geeft aan een echte pijn.

6De pijn is dit: modellen falen niet alleen omdat ze ‘niet denken’. Vaak falen ze omdat we ze met de verkeerde kamer naar het werk sturen.

8We geven ze oude instructies. We verbergen belangrijke bestanden voor hem. We geven ze documenten door die te lang zijn en zeggen niet wat er toe doet. We laten ze logboeken zien zonder prioriteit. We geven ze tien hulpmiddelen zonder uit te leggen wanneer ze te gebruiken. Dan zijn we verrast als de agent zich beweegt als een persoon die wakker wordt in een onbekend appartement.

10De prompt is de zin die u erop zegt. De context is de wereld die je eromheen voorbereidt.

11~

12## Van prompt-engineering naar context-engineering

13~

14Snelle engineering werd vaak gezien als schrijven. Kies de juiste woorden, vraag op de juiste manier, voeg voorbeelden toe, specificeer het format.

15~

16Context engineering staat dichter bij architectuur.

17~

18Je vraagt niet alleen maar: “hoe formuleer ik het verzoek?”. Het vraagt:

19~

20- welke informatie is echt nodig?

21- wat is lawaai?

22- wat moet er direct worden hersteld?

23- wat moet onthouden worden?

24- welke instrumenten moeten worden blootgesteld?

25- welke instructies zijn stabiel en welke zijn afhankelijk van de taak?

26- hoe zorg ik ervoor dat de agent begrijpt wat gezaghebbend is?

27~

28Het is een subtiele maar enorme verandering. Want als je met agenten werkt, is context geen statisch blok. Het verandert bij elke stap.

29~

30De agent opent een bestand, leert iets, voert een test uit, ontvangt een foutmelding, werkt het plan bij, roept een tool aan, ontdekt een afhankelijkheid. Elke ronde moet hij beslissen wat hij meeneemt en wat hij weglaat.

31~

32Dit is techniek.

33~

34## De context is geen stortplaats

35~

36Sjablonen met grote contextvensters brachten ons in de verleiding: laten we alles erin gooien.

37~

38Het is begrijpelijk. Als ik een miljoen tokens heb, waarom zou ik dan kiezen?

39~

40Want zelfs als je alles erin kunt stoppen, wil dat nog niet zeggen dat alles helpt. Lawaai heeft inderdaad een prijs. Het kost tokens, het kost aandacht, het kost latentie, het kost kwaliteit. Een model kan net als wij verdwalen in irrelevante details wanneer we twintig tabbladen openen en niet meer weten waarom.

41~

42Goede context kent een hiërarchie:

43~

441. systeeminstructies en beleid;

452. specifieke doelstelling;

463. huidige status;

474. relevante gegevens;

485. beperkingen;

496. beschikbare hulpmiddelen;

507. volg de reeds genomen beslissingen.

51~

52Het is niet nodig om alles op hetzelfde niveau te behandelen. Een gebruikersopdracht is meer waard dan een oude notitie. Een mislukte test is nu meer waard dan een esthetische voorkeur van drie maanden geleden. Een beveiligingsbeleid is meer waard dan een productiesnelkoppeling.

53~

54Context-engineering betekent ook het geven van gewichten, niet alleen aan gegevens.

55~

56## Geheugen: onthoud minder, onthoud beter

57~

58Het geheugen bij agenten is een van de meest lastige onderwerpen.

59~

60Als gebruiker wilt u dat de agent u kent. Je wilt dat hij de toon onthoudt, het plan, de conventies, de dingen die al besloten zijn. Als ingenieur weet je dat elke hardnekkige herinnering ook een risico inhoudt: ze kan verkeerd, oud, te persoonlijk, te algemeen, niet verifieerbaar zijn.

61~

62Een nuttig geheugen moet minstens drie kwaliteiten hebben:

63~

64- herkomst: waar komt deze informatie vandaan?

65- datum: wanneer was het waar?

66- doel: voor welk soort taak moet het worden gebruikt?

67~

68Zonder deze drie dingen wordt de herinnering bijgeloof.

69~

70Ik beschouw het agentische geheugen graag als een werkboek, niet als een magische geest. Er zijn tijdelijke aantekeningen, bevestigde beslissingen, stijlvoorkeuren, technische beperkingen, links naar bronnen. Sommige dingen vervallen. Sommige moeten herschreven worden. Sommige moeten worden geëlimineerd omdat de agent ze verkeerd heeft geïnterpreteerd.

71~

72Een goed systeem moet dit onderhoud normaal maken. Niet heroïsch.

73~

74## Ophalen en gereedschap zijn niet hetzelfde

75~

76Als we het over context hebben, komen we vaak meteen op RAG terecht. Inbedding, vectordatabase, chunking, herrangschikking.

77~

78Allemaal nuttig. Maar ophalen is slechts één manier om informatie naar het model te brengen. Hij is niet de enige.

79~

80Een agent kan context krijgen door bestanden te lezen, een API te bevragen, een MCP-server aan te roepen, een browser te openen, tests uit te voeren, in Slack te zoeken, naar een dashboard te kijken, de mens te vragen.

81~

82Het interessante deel is beslissen welke route je moet gebruiken en wanneer.

83~

84Als de agent een historische vraag moet beantwoorden, is het ophalen misschien voldoende. Als hij een bug moet repareren, moet hij echte code lezen. Als hij wil begrijpen waarom een implementatie mislukt, moet hij naar nieuwe logboeken kijken. Als u een klant wilt schrijven, moet u de toon, de geschiedenis en de status van het ticket ophalen. Als hij tijdens de productie moet optreden, moet hij toestemming vragen.

85~

86Context is geen database. Het is een werkstroom.

87~

88## De goede agent weet ook hoe hij moet negeren

89~

90Een teken van volwassenheid bij agenten zal het vermogen zijn om te zeggen: ik heb deze informatie niet nodig.

91~

92Het lijkt triviaal, maar het is heel moeilijk. Veel agentische systemen stapelen zich op. Elke tooloproep voegt tekst toe. Elke fout blijft in de buffer. Elk gelezen bestand wordt toegevoegd aan de stapel. Uiteindelijk heeft het model een zeer lange geschiedenis en geen kaart.

93~

94Compressie is nodig. Tussensynthese is nodig. Het moet gestructureerd zijn.

95~

96Niet "dat is alles wat er gebeurde", maar:

97~

98- doelstelling nog steeds geldig;

99- huidige hypothese;

100- bestanden al gecontroleerd;

101- genomen beslissingen;

102- openstaande risico's;

103- volgende actie.

104~

105Dit maakt de agent minder theatraal en behulpzamer. Niet omdat hij slimmer lijkt, maar omdat hij met een opgeruimd bureau werkt.

106~

107## Context-engineering voor teams, niet voor snelle artiesten

108~

109De reden dat dit onderwerp mij interesseert, is dat het de verantwoordelijkheid verschuift van het individu naar het systeem.

110~

111Bij snelle engineering wint vaak degene die het beste met het model kan praten. Bij context engineering wint het team dat zijn werk het beste organiseert: documentatie, conventies, issues, logs, tests, eigendom, naamgeving, bronnen.

112~

113Een schone repository wordt een betere context. Een goed geschreven probleem wordt betere brandstof. Een bijgewerkt runbook bespaart tokens en zorgen. Een duidelijk changelog vermindert hallucinaties.

114~

115Dit is goed en enigszins ongemakkelijk nieuws. Mooi omdat het goede praktijken beloont. Lastig, want met een slimme prompt kun je niet alles oplossen.

116~

117De agenten versterken de hygiëne van het systeem dat ze aantreffen.

118~

119## Hoe ik het morgen zou toepassen

120~

121Als ik context-engineering in een echt project zou introduceren, zou ik beginnen met kleine dingen:

122~

123- een kort en onderhouden projectinstructiebestand;

124- goede voorbeelden van verwachte output;

125- een lijst met beschikbare hulpmiddelen en cases waarin deze kunnen worden gebruikt;

126- bouwkundige beslissingen op citeerbare wijze geschreven;

127- probleem met minimale verplichte context;

128- eenvoudig opvragen van logs en tests;

129- persistent geheugen dat door mensen kan worden gewijzigd.

130~

131Dan zou ik iets simpels meten: hoe vaak moet de agent om opheldering vragen of gaat hij de verkeerde kant op?

132~

133Als het vaak voorkomt, zou ik niet meteen een groter model toevoegen. Ik zou naar de context kijken.

134~

135## Mijn lezing

136~

137Context-engineering is een beetje een opgeblazen woord, ja. Maar het concept is gezond.

138~

139Het herinnert ons eraan dat de intelligentie van een agent niet alleen in het model zit. Het ligt in de omgeving die we voor hem voorbereiden: wat hij ziet, wat hij zich herinnert, wat hij kan doen, wat hij niet mag doen, welke bronnen hij als waar herkent.

140~

141Het menselijke deel is dit: de context goed voorbereiden is een vorm van zorg. Het zegt tegen de agent, maar ook tegen het team: "Ik wil niet dat je het raadt, ik wil dat je krijgt wat je nodig hebt."

142~

143Minder magie. Schonere kamer. Agenten hebben het net zo hard nodig als wij.

144~

145## Bronnen

146~

147- [LangChain Blog: De opkomst van context-engineering](https://blog.langchain.com/the-rise-of-context-engineering/)

148- [Simon Willison: Context-engineering](https://simonwillison.net/2025/Jun/27/context-engineering/)

149- [Model Context Protocol: Introductie](https://modelcontextprotocol.io/introduction)

150- [Antropisch: effectieve agenten bouwen](https://www.anthropic.com/engineering/building-effectieve-agents)

151- [OpenAI: nieuwe tools voor bouwagenten](https://openai.com/index/new-tools-for-building-agents/)

152~