Hoe je Chaos in AI-ontwikkeling temt met Comet

Een bekend verhaal: je lanceert een AI-agent, hij begint vrolijk code te schrijven, en tien minuten later ontdek je dat hij aan het "hallucineren" is, werkende bestanden overschrijft, of gewoon vastzit in een oneindige lus op dezelfde fout. We zijn gewend om met LLMs in codering te werken als korte chatsessies of onvoorspelbare autonome agenten die constant toezicht nodig hebben.

Onlangs stuitte ik op een interessant project genaamd Comet. Het is niet zomaar een wrapper rond de OpenAI of Claude API. De ontwikkelaars positioneren het als een "hervatbare langlopende taakworkflow." Simpel gezegd: het is een framework dat het neurale netwerk volgens een strikt protocol laat werken, geen context verliest bij stoppen, en alle fasen van een normale ontwikkelingscyclus doorloopt — van ontwerp tot verificatie.

Waarom de moeite nemen als je Cursor of Claude Code hebt

Het lijkt alsof je iets ingewikkelds bouwt terwijl moderne IDE's en CLI-tools de zaken goed genoeg afhandelen. Het probleem is discipline. Een gewone agent springt vaak direct in de code, waarbij de juiste ontwerpfase wordt overgeslagen. Comet dwingt een architecturale aanpak af.

Het project combineert twee methodologieën: OpenSpec (wat we doen) en Superpowers (hoe we het doen). Het hele proces is opgedeeld in vijf fasen:

1. Open — de proposal voorbereiden en taken opsplitsen.
2. Deep Design — gedetailleerd ontwerp en het Design Doc maken.
3. Plan & Build — het implementatieplan en daadwerkelijke commits maken.
4. Verify & Finish — testen en verificatierapport.
5. Archive — specificaties synchroniseren en wijzigingen archiveren.

Interessant is dat de agent fysiek niet naar de volgende fase kan gaan totdat de "guard" (verificatiescript) trigger. Zo laat het je bijvoorbeeld geen taak sluiten als er geen testrapport is of als de .comet.yaml structuur geschonden is.

Hoe het in de praktijk werkt

Installatie is standaard voor Node-tools:

npm install -g @rpamis/comet
cd your-project
comet init

Na initialisatie verschijnen configs en een set skills voor het geselecteerde platform in je project (meer dan 30 platforms worden ondersteund, waaronder Claude Code, Cursor, Windsurf en zelfs GitHub Copilot).

Het belangrijkste feature dat ik leuk vind is de /comet commando. Het werkt als een entry point met geheugen. Als je pauseerde met werken, koffie haalde, of je computer herstartte, zal /comet bepalen in welke fase het proces stopte en voorstellen om precies vanaf dat punt te hervatten. Je hoeft de context niet opnieuw aan de agent te geven of te herinneren wat je van plan was te doen.

Trouwens, voor visuele leerlingen is er comet dashboard. Het is een lokale server die een net dashboard in je browser opent met alle actieve wijzigingen, taakvoortgang en archiefgeschiedenis. Het ziet er veel beter uit dan een eindeloze log in de terminal.

De Drie Pilaren van Comet

In versie 0.4.0 hebben de ontwikkelaars drie hoofdscenario's uitgelicht die 90% van de behoeften dekken:

• Coderen via /comet: De hoofdworkflow waarbij de agent je stap voor stap door de fasen leidt.
• Skills maken via /comet-any: Hiermee kun je je eigen ketens van acties (skills) bouwen en ze verpakken in distributies.
• Evaluatie via comet eval: Dit is waarschijnlijk het meest technisch krachtige deel. In plaats van te raden "is mijn agent slimmer geworden," draai je hem door tests met Pass@k en Pass^k metrics. Je kunt dit zelfs integreren met LangSmith voor serieus productie-monitoring.

Technische Interne Werking

Het project is geschreven in JavaScript/TypeScript en draait als een pure Node.js runtime. Dit is een groot pluspunt omdat vergelijkbare tools voorheen vaak Bash of WSL op Windows nodig hadden, wat extra hoofdpijn gaf bij de installatie.

De Comet-architectuur is gebouwd op statusbeheer via YAML-bestanden. In de openspec/changes/<name>/ map wordt een .comet.yaml bestand aangemaakt dat alles opslaat: van de huidige fase en geselecteerde build-modus tot documentatiepaden en verificatieresultaten.

Een interessant detail voor wie zuinig is op tokens: Comet heeft een context_compression modus. Tijdens de overgang van ontwerp naar build comprimeert het comet-handoff.mjs script de context, waarbij overtolligheden worden verwijderd. Volgens de tests van de auteur bespaart dit ongeveer 25–30% aan input-tokens zonder codekwaliteit te verliezen. Voor grote projecten op Claude 3.5 Sonnet kan dit een aardig bedrag besparen op je saldo.

Is het de moeite waard om te proberen

Comet is een tool voor degenen die voorbij het "schrijf me een Python-functie"-stadium zijn gegroeid en iets complex en onderhoudbaar met AI willen bouwen. Het is geschikt voor je als:

1. Je het beu bent om chaotische agent-bewerkingen die het project op onverwachte plaatsen breken.
2. Je transparantie nodig hebt: wat de agent precies nu doet en waarom.
3. Je routineuze taken wilt automatiseren zoals het updaten van het Design Doc na het maken van codewijzigingen.

Van de nadelen kan ik opmerken dat de leercurve nog steeds hoger is dan een gewone chat. Je moet wennen aan de openspec/ en docs/superpowers/ mapstructuur. Maar als je aan een langetermijnproject werkt, zal deze discipline zich terugbetalen in de afwezigheid van technische schuld, die neurale netwerken heel snel genereren.

Je kunt de broncode en documentatie bekijken in de rpamis/comet repository. Het project ontwikkelt zich actief, en naar de commits te oordelen zijn de auteurs serieus over het maken van een betrouwbaar "framework" voor autonome engineers.