SourceAtlas: Levende documentatie voor een nieuwe generatie ontwikkelaars

De ontwikkeling van AI-gedreven systemen leidt tot een explosie van 'intentie-metadata'. We besteden minder tijd aan het typen van implementatiecode, en meer tijd aan het beschrijven van wat er moet bestaan en waarom. Visiedocumenten, plannen, regels, taken, besluiten, contracten... de hoeveelheid documentatie groeit exponentieel en raakt onlosmakelijk verbonden met de codebase.

Het wordt onmogelijk om het overzicht te bewaren. De antwoorden op vragen als "Waar zijn we?", "Wat is het plan?", "Welke regel geldt hier?" en "Wat is de volgende taak?" zijn verspreid over talloze documenten. Traditioneel documentatie opzoeken is te traag en te omslachtig geworden.

Dit is het probleem dat SourceAtlas oplost. Het is geen statische documentatiehub, maar een levende, ademende metgezel die de ontwikkelaar in real-time ondersteunt.

Meer dan een zoekmachine

SourceAtlas is ontworpen als de 'single source of truth' voor een ontwikkelingsvloot. Zijn kerntaken zijn:

1. Intelligent scannen en interpreteren: SourceAtlas leest en begrijpt alle betrokken documenten, van architecturale visies tot specifieke taakbeschrijvingen.
2. Catalogiseren en taggen: Het legt verbanden, categoriseert informatie en bouwt een kennisgrafiek van het hele project.
3. Directe doorsnedes bieden: Een ontwikkelaar kan onmiddellijk een overzicht krijgen van alle plannen, alle openstaande taken, of alle regels die van toepassing zijn op een specifieke competentie, zelfs over meerdere systemen heen.

Het doel is om de ontwikkelaar direct, binnen enkele seconden, van de juiste context te voorzien.

De reconstructie van continuïteit

In een moderne ontwikkelomgeving werkt een ontwikkelaar vaak parallel aan meerdere taken. Zoals we in een volgend artikel zullen zien, leidt dit tot een verlies van 'verticale continuïteit'. De ontwikkelaar springt van de ene naar de andere taak en moet constant zijn mentale context herladen.

SourceAtlas is het mechanisme dat deze verloren continuïteit reconstrueert. Het is de horizontale controletoren die de ontwikkelaar helpt om het overzicht te bewaren over de verschillende 'verticale' stromen van werk die tegelijkertijd plaatsvinden.

Een verlengstuk van het werkgeheugen

Wanneer een ontwikkelaar naar een terminal schakelt waar een AI-agent een taak heeft voltooid, kan SourceAtlas (in combinatie met een companion als 'Atlassia') proactief de relevante informatie tonen:

• Waar waren we?: "De vorige stap was het definiëren van het datamodel."
• Wat doen we nu?: "De AI heeft zojuist de API-endpoints gegenereerd."
• Wat is de volgende stap?: "De volgende taak is het schrijven van de unit tests."
• Wat moeten we onthouden?: "Let op, de 'health check' regel is hier van toepassing."

Op deze manier wordt SourceAtlas meer dan alleen projectgeheugen; het wordt een extern, gedeeld werkgeheugen voor de ontwikkelaar. De cognitieve last van het constant wisselen van context wordt drastisch verminderd. De ontwikkelaar hoeft de staat van het project niet langer volledig in zijn eigen hoofd te houden; het wordt extern en zichtbaar gemaakt.

Dit zorgt ervoor dat de gesprekken met de AI ('conversations') tijdelijk en inwisselbaar kunnen worden. De continuïteit en de 'waarheid' worden niet langer vastgehouden in een specifieke chatgeschiedenis, maar in de centrale kennisbank van SourceAtlas.

---

Illustratie Suggestie

Plaatsing: Na de sectie "Een verlengstuk van het werkgeheugen".

Prompt (Nederlands):

"Creëer een 'cockpit'-view voor een ontwikkelaar. De ontwikkelaar zit voor meerdere (bijv. 4) computerschermen of terminals, die elk een andere lopende taak tonen ('Terminal 1', 'Terminal 2', etc.). Dit representeert zijn 'horizontale continuïteit'. In het midden, prominent aanwezig, is een groot hoofdscherm, gelabeld 'SourceAtlas'. Dit scherm toont een helder, geconsolideerd overzicht van alle taken. Pijlen wijzen van de individuele terminals naar het SourceAtlas-scherm, en van daaruit naar het hoofd van de ontwikkelaar, om te symboliseren hoe SourceAtlas de informatie centraliseert en de cognitieve last verlicht. Een kleine, behulpzame robot (Atlassia) wijst naar het SourceAtlas-scherm."