← Naar het model Capability

Context engineering

Wat het is

Een taalmodel weet niets van jouw organisatie. Het kent je domeintaal niet, je architectuurafspraken niet en de fout van vorige maand ook niet. Wat het wΓ©l weet, is wat op dat moment in zijn contextvenster staat. Context engineering is het vak van bepalen wΓ‘t daar staat, wanneer, en in welke vorm.

Het verschil met prompting: een goede prompt helpt één persoon in één sessie. Context engineering maakt kennis herbruikbaar, zodat elke sessie en elke agent ermee begint. Het verschil met Harness & platform: de harness is de hele werkomgeving van een agent, inclusief tools en controles. Context engineering is de kennislaag daarin, en die laag is van jou. Een model of een agent-runtime koop je in; je domeinkennis niet.

Een herkenbaar voorbeeld: een agent blijft β€žklant” en β€žrelatie” door elkaar halen, hoe vaak je het ook corrigeert. De oplossing is geen strengere prompt, maar één regel in de projectinstructies die verwijst naar de gedeelde begrippenlijst. Vanaf dat moment gaat het in elke sessie goed, bij iedereen.

Waarom

Anthropic beschrijft context engineering als het zoeken naar de kleinste set informatie met het meeste signaal. Meer context is niet beter: naarmate het venster voller raakt, neemt de kwaliteit van het redeneren af. Dat heet context rot. Alle documentatie in het venster laden is dus geen oplossing, maar een nieuw probleem.

DORA vond in het AI Capabilities Model (september 2025) zeven capabilities die het effect van AI op softwareteams versterken. EΓ©n daarvan is AI-accessible internal data: AI-tools koppelen aan interne bronnen vergroot hun effect op individuele effectiviteit en op codekwaliteit. Een andere is healthy data ecosystems. Context engineering is wat je doet om die koppeling bruikbaar en veilig te maken.

BΓΆckeler (martinfowler.com, april 2026) noemt alles wat een agent stuurt vΓ³Γ³rdat hij handelt guides, ofwel feedforward. Projectinstructies, skills en begrippenlijsten zijn guides. Ze bepalen of een agent de goede kant op gaat, nog voordat een test of review iets kan zien.

De positie van dit model: context is organisatie-eigendom en dus organisatiewerk. Zolang alleen de handigste engineer goede context heeft, blijft de winst persoonlijk. Pas als context gedeeld, beheerd en herleidbaar is, wordt het een capability.

Wat je nodig hebt

Dataclassificatie gaat vΓ³Γ³r bronontsluiting: wie interne bronnen voor agents openstelt zonder te weten welke data een agent nooit mag zien, bouwt een lek in plaats van een capability.

Hoe je het meet

Het aandeel repositories met projectinstructies is makkelijk op te krikken met een leeg sjabloon. Tel alleen instructies die het afgelopen kwartaal zijn aangepast naar aanleiding van iets dat misging.

Instrumenten om in te groeien

Vijf lagen van context

Context engineering groeit in lagen. Elke laag maakt kennis duurzamer en breder beschikbaar dan de vorige. Je slaat er geen over: zonder goede projectinstructies heeft een Context Space niets om op te bouwen.

Het venster beheren

Naast wΓ‘t er in de context komt, telt hoe je het venster beheert tijdens langlopend werk:

  • Compaction: oudere context samenvatten en afvoeren bij het naderen van de limiet.
  • Tool-output wegzetten: een log van tweeduizend regels niet in het venster houden, maar de kern bewaren en de rest op afroep beschikbaar maken.
  • Progressive disclosure: tools, MCP-servers en skills pas laden als de taak erom vraagt.
  • Context-reset: de sessie afbreken en opnieuw opbouwen vanuit een compact overdrachtsbestand, zoals je een nieuwe collega inwerkt.

Ook tools kosten venster: hun namen, beschrijvingen en schema's staan in de prompt. Vuistregel: tien gerichte tools verslaan vijftig overlappende. De agent weet dan beter wat hij waarvoor kan inzetten.

De Context Space: gedeelde bestanden

De Context Space bestaat uit gewone bestanden die mensen en agents delen. Ze verbinden het vastleggen van de bedoeling, het specificeren en het bouwen:

  • AGENTS.md β€” projectinstructies; elke regel herleidbaar tot iets dat misging. CLAUDE.md ernaast voor wat Claude-specifiek is.
  • ubiquitous_language.md β€” de gedeelde begrippen van het domein, voor mensen en agents.
  • scenarios.md β€” gedragsscenario's, de uitkomst van het gesprek met domeinexperts.
  • gherkin.md β€” uitvoerbare specificaties: de brug van scenario naar geautomatiseerde test.
  • bounded_contexts.md en ddd_rules.md β€” de domeingrenzen en de regels per domein, die de controles stroomafwaarts bewaken.
  • Skills β€” de herbruikbare instructiesets zelf, zie Harness & platform.

Projectinstructies: twee praktijkregels

Kort. Richtlijn: onder de zestig regels. Alles wat bij elke beurt wordt meegeladen, kost venster en aandacht.

Herleidbaar. Elke regel is terug te voeren op iets dat een keer misging. Een AGENTS.md is een signaalsysteem, geen documentatie.

Let op bij bronontsluiting

Beschrijvingen van MCP-tools komen in de prompt terecht. Raakt een server gecompromitteerd, dan is dat een route voor prompt-injectie. Bronontsluiting hoort daarom onder de security-baseline, zie AI Governance Canvas, blok O7.

Downloads

Lees en luister verder

Een model weet alles, behalve wat jouw organisatie weet. Dat verschil is geen modelprobleem, maar jouw werk.