Lore: Repurposing Git Commit Messages as a Structured Knowledge Protocol for AI Coding Agents

Dit paper introduceert Lore, een lichtgewicht protocol dat git-commitberichten herstructuriseert tot zelfstandige beslissingsrecords om het verloren redeneringsproces achter code-aanpassingen voor AI-coderingsagenten te behouden.

Ivan Stetsenko

Gepubliceerd 2026-03-17
📖 4 min leestijd☕ Koffiepauze-leesvoer

Each language version is independently generated for its own context, not a direct translation.

Stel je voor dat je een enorme bibliotheek bouwt, vol met boeken (code) die een computer heeft geschreven. Maar er is een groot probleem: als je een boek openslaat, zie je alleen de tekst. Je ziet niet waarom de schrijver die woorden heeft gekozen, welke andere woorden hij overwoog maar verwierp, of welke geheimzinnige regels hij moest volgen.

De auteur van dit paper, Ivan Stetsenko, noemt dit het "Schaduw van de Beslissing". Het is alle wijsheid die verdwijnt zodra de code wordt opgeslagen.

Vroeger was dat geen probleem, omdat mensen de code schreven en de "waarom"-verhalen mondeling vertelden tijdens vergaderingen. Maar nu schrijven AI's (kunstmatige intelligenties) de code. AI's zijn slim, maar ze hebben geen geheugen van wat er voor de code is gebeurd, tenzij het ergens staat. Als een AI een fout maakt in een oude code, kan hij niet weten dat er een reden was om die fout te maken, omdat die reden nooit is opgeschreven.

Hier komt Lore (een woord dat "oude wijsheid" of "overlevering" betekent) in beeld.

Wat is Lore eigenlijk?

Lore is een slim idee dat zegt: "Waarom moeten we een nieuw, duur systeem bouwen om deze verhalen op te slaan, terwijl we al een systeem hebben dat elke programmeur gebruikt?"

Dat systeem is Git, de tool die elke programmeur gebruikt om versies van code te bewaren. Normaal gesproken schrijft een programmeur (of AI) bij elke wijziging een korte zinnetje: "Bugfix: wachtwoord reset werkt nu."

Lore zegt: "Nee, laten we dat zinnetje gebruiken als een tijdcapsule."

De Analogie: De Magische Postkaart

Stel je voor dat elke wijziging in de code een postkaart is die je naar de toekomst stuurt.

  • Vandaag (zonder Lore): Je schrijft alleen: "Ik heb de deur dichtgedaan."

    • De toekomstige lezer (of AI) vraagt zich af: "Waarom? Was er een storm? Was er een dief? Moet ik de deur morgen weer openen?" Ze weten het niet. De kaart is nutteloos voor de toekomst.
  • Met Lore: Je gebruikt een speciale stempel op de postkaart (in het jargon: Git Trailers). Je schrijft niet alleen wat je deed, maar ook:

    • De Regel: "Ik deed dit omdat de windstorm van buiten te hard was."
    • Het Afgewezen Alternatief: "Ik overwoog om het raam te sluiten, maar dat zou te veel geluid maken."
    • De Waarschuwing: "Als de wind morgen stopt, moet je de deur weer openen, anders verstik je!"
    • Het Vertrouwen: "Ik ben 90% zeker dat dit werkt."

Deze postkaarten worden niet in een apart archief bewaard (zoals een losse notitie op een muur die vaak verdwijnt). Ze zijn onlosmakelijk verbonden met de deur zelf. Als je de deur (de code) ooit verplaatst, nemen de postkaarten (de Lore) automatisch mee.

Waarom is dit zo slim?

  1. Geen dure apparatuur nodig: Je hoeft geen nieuwe servers, databases of ingewikkelde software te kopen. Het werkt met de tools die al op elke computer van een programmeur staan.
  2. AI's kunnen het lezen: AI's zijn geweldig in het lezen van tekst en het uitvoeren van commando's. Lore is zo opgebouwd dat een AI-agent makkelijk kan vragen: "Welke postkaarten liggen er bij dit stukje code?" en direct het antwoord krijgt.
  3. Het voorkomt fouten: Als een AI probeert een oplossing te bedenken die in het verleden al is afgewezen (bijvoorbeeld: "Laten we het raam dichtdoen!"), kan Lore zeggen: "Stop! Dat hebben we al geprobeerd, het maakte te veel lawaai." Dit bespaart tijd en voorkomt dat AI's dezelfde fouten blijven maken.

Hoe werkt het in de praktijk?

Stel je voor dat je een AI-programmeur bent. Je krijgt de opdracht om een oude functie in een programma aan te passen.

  1. Je draait een klein commando: lore context <de-code-bestand>.
  2. De computer toont je niet alleen de code, maar ook de postkaarten van de vorige schrijvers.
  3. Je leest: "We hebben deze functie zo gemaakt omdat de server traag was. Probeer het niet andersom, want dat werkt niet."
  4. Je weet nu precies wat je moet doen, zonder dat je uren hoeft te gissen.

Conclusie

De kernboodschap van dit paper is simpel: We gooien te veel wijsheid weg.

Elke keer dat code wordt veranderd, is er een verhaal achter. Tot nu toe werd dat verhaal weggegooid. Lore is een manier om dat verhaal direct op de code te plakken, zodat het nooit verloren gaat. Het is een manier om de "stille wijsheid" van programmeurs en AI's vast te leggen in een vorm die ook toekomstige AI's kunnen begrijpen.

Het is alsof we stoppen met het bouwen van huizen zonder instructieboekjes, en beginnen met het schrijven van die boekjes op de muren zelf, zodat elke nieuwe bewoner precies weet hoe het huis in elkaar zit en waarom de muren zo dik zijn.

Ontvang papers zoals deze in je inbox

Gepersonaliseerde dagelijkse of wekelijkse digests op basis van jouw interesses. Gists of technische samenvattingen, in jouw taal.

Probeer Digest →