Home/Forum/Claude Skills/Gratis Claude Skill: architectuur-audit die elke refactor eerst adversarieel controleert
Gratis Claude Skill: architectuur-audit die elke refactor eerst adversarieel controleert
1 bericht · 2 weergaven
Angelo
Lid
OP #129 juli 2026, 11:40
De meeste "review mijn architectuur"-prompts geven je een lange lijst refactors, waarvan de helft complexiteit alleen maar verplaatst. Deze skill doet drie dingen die dat niet doen.
Het doel is diepere modules: meer gedrag verborgen achter een kleinere interface, zodat je code makkelijker te wijzigen en te navigeren is, ook voor AI.
Wat je krijgt:
Voor wie: developers, tech leads en teams die een codebase makkelijker onderhoudbaar willen maken, technische schuld willen aanpakken, of een second opinion willen die niet klakkeloos elke refactor aanraadt.
Deze skill voert de refactor niet voor je uit. Hij levert een geverifieerd, geprioriteerd plan waar jij over beslist, en labelt zwakke voorstellen eerlijk als "speculatief" in plaats van ze mooier te maken dan ze zijn. Hij draait ook geen gedocumenteerde beslissing (ADR) terug zonder nieuwe informatie.
Waarop gebaseerd: de theorie komt van John Ousterhout (A Philosophy of Software Design) en David Parnas (information hiding). Dit is een zelfstandige, verbeterde uitwerking met een objectief script en een verplichte adversariële controle erbij.
Installeren (Claude Code)
Gebruiken
Een dependency-vrij script haalt objectieve signalen uit je code: modules met een brede oppervlakte (grab-bags), over-gefragmenteerde mini-modules, barrels en god-files.
Zo start de audit met signalen in plaats van gokwerk. Werkt op JavaScript, TypeScript, Vue, Go en Python.
De skill redeneert in echt vocabulaire (module, interface, diepte, seam, leverage), geworteld in Ousterhout's A Philosophy of Software Design.
Bevindingen zijn daardoor precies, bijvoorbeeld "de betekenis van deze enum wordt op zes plekken gedecodeerd", in plaats van "dit voelt rommelig".
En het belangrijkste: geen enkele aanbeveling haalt het rapport voordat een aparte, adversariële agent hem heeft proberen te slopen.
Verdwijnt de complexiteit echt, of verschuift hij alleen? Verandert deze module wel vaak genoeg om het waard te zijn? De agent die een refactor voorstelt is nooit de agent die hem goedkeurt. Zo vang je "refactoring theatre" dat er mooi uitziet maar niets oplost.
Het doel is diepere modules: meer gedrag verborgen achter een kleinere interface, zodat je code makkelijker te wijzigen en te navigeren is, ook voor AI.
Wat je krijgt:
- Een kant-en-klare Claude Skill (SKILL.md + alle instructies) die je in je project laat vallen en direct werkt.
- Een script zonder installatie of afhankelijkheden dat module-diepte-signalen uit je codebase haalt (JS, TS, Vue, Go, Python).
- Drie agent-prompts: verkennen, voorstellen (met "design it twice"), en een adversariële verify.
- Een principes-referentie met het vocabulaire, de deletion test en design-it-twice.
- Een Markdown-rapport dat zo in een pull request of issue past: topaanbeveling, gerangschikte geverifieerde kandidaten, en een "overwogen en afgewezen"-lijst die de redenering laat zien.
Voor wie: developers, tech leads en teams die een codebase makkelijker onderhoudbaar willen maken, technische schuld willen aanpakken, of een second opinion willen die niet klakkeloos elke refactor aanraadt.
Deze skill voert de refactor niet voor je uit. Hij levert een geverifieerd, geprioriteerd plan waar jij over beslist, en labelt zwakke voorstellen eerlijk als "speculatief" in plaats van ze mooier te maken dan ze zijn. Hij draait ook geen gedocumenteerde beslissing (ADR) terug zonder nieuwe informatie.
Waarop gebaseerd: de theorie komt van John Ousterhout (A Philosophy of Software Design) en David Parnas (information hiding). Dit is een zelfstandige, verbeterde uitwerking met een objectief script en een verplichte adversariële controle erbij.
Installeren (Claude Code)
Pak de zip uit in .claude/skills/architecture-audit/ en herstart Claude. Werkt ook in andere Agent Skills-hosts. Je hebt alleen Node 18 of hoger nodig voor het script, geen betaalde tools.
Gebruiken
Wijs de skill naar een map of subsysteem:
Gebruik de architecture-audit skill.
Scope: ./src/checkout
Aanleiding: dit deel is eng om aan te passen en verandert vaak.
Doel: makkelijker te wijzigen en te testen maken. Bewerkt (4×) · 29 juli 2026, 12:07