From Scattered to Structured: A Vision for Automating Architectural Knowledge Management
Dit artikel stelt een geautomatiseerde pijplijn voor om verspreide architecturale kennis uit heterogene software-artefacten te transformeren naar een gestructureerde, consistente kennisbank die kritieke onderhoudstaken en natuurlijke taalvragen ondersteunt.
Oorspronkelijk artikel gelicentieerd onder CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Dit is een AI-gegenereerde uitleg van het onderstaande artikel. Het is niet geschreven of goedgekeurd door de auteurs. Raadpleeg het oorspronkelijke artikel voor technische nauwkeurigheid. Lees de volledige disclaimer
Stel je voor dat jij de hoofdarkitect bent van een enorme, voortdurend veranderende stad. Deze stad is jouw softwaresysteem. Om deze draaiende te houden, heb je blauwdrukken (ontwerpdiagrammen), een lijst met regels (vereisten), de daadwerkelijke bakstenen en mortel die worden gelegd (de code), en een dagboek van beslissingen gemaakt door de bouwploeg (documentatie).
Het Probleem: Een Stad van Verloren Blauwdrukken
Op dit moment is de informatie over deze stad overal verspreid. Sommige regels staan op plaknotities, sommige blauwdrukken liggen in een lade, en de eigenlijke bouw vindt plaats in een ander gebouw.
- De Bende: Omdat de informatie zo verspreid is, is het voor de werkers (ontwikkelaars) moeilijk om te weten hoe de stad eruit zou moeten zien.
- De Drift: Na verloop van tijd bouwen de werkers iets dat net iets anders is dan de blauwdrukken zeggen. In het dagboek staat "bouw een brug", maar ze hebben een tunnel gebouwd. De blauwdrukken worden niet bijgewerkt. Dit wordt "architecturale erosie" genoemd. De stad wijkt langzaam af van het oorspronkelijke plan, waardoor het moeilijk wordt om te repareren of uit te breiden.
De Visie: Een Intelligente Stadslibrarian
De auteurs, Jan Keim en Angelika Kaplan, stellen voor om een super slimme, geautomatiseerde Stadsbibliothecaris (een AI-systeem) te bouwen om deze bende op te lossen. Hun doel is om al deze verspreide, rommelige informatie te nemen en er één schone, georganiseerde en doorzoekbare bibliotheek van te maken.
Zo werkt hun "Bibliothecaris" stap voor stap:
1. De Speurtocht (Extractie)
De Bibliothecaris leest niet alleen boeken; hij leest alles. Hij heeft speciale tools om naar het volgende te kijken:
- Tekst: Hij leest vereisten en vergaderverslagen.
- Code: Hij kijdt naar de daadwerkelijke bouwmaterialen om te zien wat er echt wordt gebouwd.
- Afbeeldingen: Hij kijkt zelfs naar handgetekende schetsen en diagrammen.
- Audio: Hij kan vergaderopnames beluisteren om beslissingen die mondeling zijn genomen op te vangen.
Hij haalt de belangrijke feiten uit al deze verschillende bronnen, zoals een detective die aanwijzingen verzamelt.
2. De Waarheidsdetective (Consistentiecontrole)
Zodra de Bibliothecaris de aanwijzingen heeft verzameld, speelt hij detective. Hij vergelijkt de verschillende bronnen om te zien of ze hetzelfde verhaal vertellen.
- Voorbeeld: Als de blauwdruk zegt "Rode Deur" maar de code zegt "Blauwe Deur", ziet de Bibliothecaris het conflict.
- Hij vindt niet alleen het probleem; hij probeert ook uit te zoeken welke bron juist is. Als het een kleine fout is, kan hij het automatisch oplossen. Als het een groot, verwarrend conflict is, vraat hij aan een menselijke architect: "Hé, hebben we de kleur van de deur veranderd, of is de blauwdruk fout?"
3. De Meesterkaart (De Kennisbank)
Alle geverifieerde feiten worden opgeslagen in een Meesterkaart (een gestructureerde Kennisbank). Dit is niet zomaar een stapel papier; het is een verbonden web waar elke baksteen, regel en beslissing met de anderen is gelinkt.
- Omdat alles aan elkaar gekoppeld is, kan de Bibliothecaris je direct vertellen welke andere onderdelen worden beïnvloed als je één deel van de stad wilt veranderen (Change Impact Analysis).
- Het kan ook controleren of de huidige constructie de oorspronkelijke regels volgt (Conformance Checking).
4. De Conversationele Gids (Vraag-Antwoord)
Het beste deel? Je hoeft geen bibliothecaris te zijn om deze kaart te gebruiken. Je kunt gewoon met het systeem praten.
- Jij vraagt: "Waarom hebben we voor dit specifieke ontwerp van de brug gekozen?"
- De Bibliothecaris antwoordt: "Volgens de vergaderverslagen van afgelopen dinsdag en het ontwerpdocument hebben we hiervoor gekozen omdat het goedkoper en sterker was."
- Het gebruikt geavanceerde AI (Large Language Models) om je vragen te begrijpen en het exacte antwoord in de Meesterkaart te vinden, net zoals je een deskundige rondleidende gids om hulp vraagt.
5. De Waakzame Bewaker (Continue Monitoring)
Dit is geen eenmalige taak. De Bibliothecaris is een Agent die de stad 24/7 in de gaten houdt.
- Zodra een werker een blauwdruk verandert of nieuwe code schrijft, merkt de Bibliothecaris dit onmiddellijk op.
- Hij werkt de Meesterkaart in realtime bij.
- Als hij in de war raakt, pauzeert hij en vraagt hij om hulp van een mens, zodat de AI geen grote fouten maakt op eigen initiatief.
De Uitdagingen (Waarom het nog niet makkelijk is)
De auteurs geven toe dat dit een lastige klus is:
- Te Veel Data: De stad is enorm. De Bibliothecaris kan overweldigd raken door miljoen pagina's tekst.
- Hallucinaties: Soms "verzint" de AI feiten die waar lijken te zijn, maar dat niet zijn. Ze moeten voorzichtig zijn om geen valse informatie in de Meesterkaart toe te laten.
- Oud versus Nieuw: Software verandert over de jaren heen. De Bibliothecaris moet weten wanneer hij oude geschiedenis moet bewaren (voor context) en wanneer hij verouderde informatie moet weggooien zodat hij niet in de war raakt.
- Privacy: Als de Bibliothecaris privévergaderingen beluistert, moet hij er zeer voorzichtig mee zijn dat hij geen geheimen lekt.
Samenvattend
Het artikel is een blauwdruk voor een geautomatiseerd systeem dat voorkomt dat softwareteams verdrinken in verspreide informatie. Het heeft als doel alle rommelige aanwijzingen te verzamelen, ze te controleren op waarheid, ze te organiseren in één enkele bron van waarheid, en iedereen in gewone mensentaal de mogelijkheid te geven vragen te stellen om te begrijpen hoe hun software werkt. Het gaat over het veranderen van een chaotische bouwplaats in een goed georganiseerde, begrijpelijke stad.
Verdrinkt u in papers in uw vakgebied?
Ontvang dagelijkse digests van de nieuwste papers die bij uw onderzoekswoorden passen — met technische samenvattingen, in uw taal.