Waarom AI-assistenten maar niet begrijpen wat je aan het bouwen bent

Je kent het vast. Je vraagt je AI-assistent om iets te wijzigen in je project, en dan begint het: bestand na bestand wordt geopend. Twintig minuten later heeft het veertig bestanden gelezen, de helft weer vergeten, en komt met een suggestie die totaal niet past bij hoe je project in elkaar zit.

Herkenbaar? Reken maar. Dit is een van de grootste frustraties met AI-gestuurde ontwikkeling op dit moment — en precies het probleem dat een nieuwe tool genaamd Mycelium probeert op te lossen.

Het contextprobleem

Het ding is: AI-assistenten zijn alleen maar zo goed als de context die ze krijgen. Geef ze de juiste informatie, en ze schrijven elegante, accurate code. Gooi er een stortvloed van irrelevante bestanden tegenaan, en je krijgt spaghetti die volledig herschreven moet worden.

Het probleem is dat de meeste AI-hulpmiddelen starten met vrijwel geen begrip van je projectstructuur. Ze weten niet welk bestand authenticatie afhandelt, welke je kernlogica bevat, of welke bestanden gewoon oude rommel zijn waar niemand aan moet komen. Dus ze gokken. Ze openen bestanden alfabetisch, of op importvolgorde, of wat voor heuristiek maar veelbelovend lijkt. Het is langzaam, verspild, en vaak gewoon ineffectief.

Mycelium op het toneel

Mycelium pakt dit anders aan. In plaats van je AI-assistent blind door je codebase te laten dwalen, bouwt het een uitgebreide kaart van je hele project — elk bestand, elke afhankelijkheid, elke verbinding ertussen. Wanneer je assistent een wijziging moet maken, bevraagt het deze kaart en krijgt het precies de bestanden terug die ertoe doen, met duidelijke uitleg in gewoon Engels over wat elk bestand doet.

De workflow is verrassend eenvoudig. Je draait npx @kopikocappu/mycelium init één keer, en Mycelium parseert je hele codebase, lost alle imports op, en bouwt een afhankelijkheidsgraaf. Er wordt zelfs een klein AI-model (Claude Haiku) gebruikt om beschrijvingen te schrijven voor elk bestand.

Voor je assistent aan een taak begint, roept het /preflight aan met een beschrijving van wat het moet doen. Mycelium stuurt dan de vier bestanden terug die ertoe doen — niet veertig.

Meer dan alleen bestanden opzoeken

Maar Mycelium gaat verder dan simpel bestanden zoeken. Er zijn diverse functies die het echt bruikbaar maken voor teams:

De live grafiekviewer laat je je hele codebase visualiseren in een browser. Bestanden worden knooppunten, imports worden verbindingen, en je ziet in één oogopslag hoe je project is opgezet. Voor nieuwe ontwikkelaars die bij een project komen, is dit alleen al de installatietijd waard.

De agent-wijzigingsgeschiedenis logt elke bestandswijziging met tijdstempels, taakbeschrijvingen en agent-identiteit. Dit creëert een audit trail die tot nu toe ontbrak in AI-hulpmiddelen. Je kunt eindelijk precies zien wat je AI-assistenten hebben gewijzigd — en wanneer.

Semantisch zoeken betekent dat je bestanden kunt vinden op concept in plaats van op trefwoord. Zoek naar "betaling verwerken" en Mycelium vindt de juiste bestanden, zelfs als geen van hen het woord "betaling" bevat. Dit is bijzonder handig voor grotere codebases waar de terminologie in de loop der tijd is veranderd.

Privacy waar je op kunt vertrouwen

Een detail dat belangrijk is voor enterprise-gebruikers: Mycelium draait lokaal op je machine op localhost:47821. Je code verlaat nooit je ontwikkelomgeving. Dit is geen cloudservice die je bedrijfslogica analyseert — het is een lokaal hulpmiddel dat je niet in de weg zit.

Is het de moeite waard om in te stellen?

Voor individuele ontwikkelaars die aan kleine projecten werken, is Mycelium misschien overkill. Als je codebase uit een handvol bestanden bestaat die je uit je hoofd kent, heb je waarschijnlijk geen afhankelijkheidsgraaf nodig.

Maar voor teams, grotere projecten, of iedereen die heeft toegekeken hoe hun AI-assistent twintig minuten aan het worstelen was voordat het het juiste bestand vond — Mycelium is een echte productiviteitsboost. De eenmalige installatiekosten betalen zich uit bij elke keer dat je AI-assistent context moet begrijpen.

De belofte is aantrekkelijk: je AI-codeerassistent die eindelijk begrijpt waar het eigenlijk mee bezig is. Vier bestanden. Geen gissen. Code die daadwerkelijk past bij je architectuur.

Als je gefrustreerd bent door AI-assistenten die slim lijken maar het punt missen, dan is Mycelium misschien de kaart waar je op hebt gewacht.