Architecture Audit

Auditeert een codebase op ondiepe/gekoppelde modules en schrijft een diepe module refactor PRD.

Door helderberto · helderberto/agent-skills

Werkt met setup ★ 8.0/10

Architecture Audit — Auditeert een codebase op ondiepe/gekoppelde modules en schrijft een diepe module refactor PRD.

Wat het doet

Onderzoekt een codebase op architectonische wrijving (pass-through wrappers, temporele decompositie, strakke koppeling bij naden) en schrijft een verbeterings-PRD die een refactor naar diepe modules (kleine interface, grote implementatie) voorstelt, met alternatieve interface ontwerpen en een migratieplan. Triggert op verzoeken om architectuur te auditen of structurele wrijving in een codebase te vinden; expliciet niet voor enkelvoudige module interface ontwerp of diff-niveau code review.

Testrapport

SKILL.md leunt op een sibling skill map ('../codebase-design/SKILL.md' en zijn DEEPENING.md) voor zijn kernvocabulaire en afhankelijkheid-categorie logica — kopieer alleen architecture-audit/ per de standaard single-directory installatie en die links 404 lokaal. Voerde een echte audit uit tegen een 4-bestand throwaway app met een tekstboek pass-through service; de door de skill geleide run produceerde een werkelijk meer bruikbaar resultaat dan een onbegeleide baseline — een volledige improvement-template.md PRD (probleem/interface/afhankelijkheid-strategie/migratie/risico's) versus de twee throwaway zinnen van de baseline.

Getest op: 2026-07-15 · Claude Code 2.x (agent harness)

Installatie

git clone https://github.com/helderberto/agent-skills
mkdir -p ~/.claude/skills
cp -r agent-skills/skills/architecture-audit ~/.claude/skills/architecture-audit
cp -r agent-skills/skills/codebase-design ~/.claude/skills/codebase-design   # required sibling dependency, see notes

Commando's en voorbeeldprompts

  • /architecture-auditAuditeert een codebase op ondiepe/gekoppelde modules en schrijft een diepe module refactor PRD.

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Audit this codebase for architectural friction and propose a refactor
  • Find the shallow, pass-through modules coupling this service together
  • Write a PRD proposing deeper module boundaries for this messy repo