Architecture Audit

Auditerer en kodebase for lave/koblede moduler og skriver en dyb-modul refactor PRD.

Af helderberto · helderberto/agent-skills

Virker med opsætning ★ 8.0/10

Architecture Audit — Auditerer en kodebase for lave/koblede moduler og skriver en dyb-modul refactor PRD.

Hvad det gør

Udforsker en kodebase for arkitektonisk friktion (pass-through wrappers, temporal decomposition, tæt kobling ved sømme) og skriver en forbedrings-PRD, der foreslår en refactor mod dybe moduler (lille interface, stor implementering), med alternative interface-designs og en migrationsplan. Udløses ved anmodninger om at auditere arkitektur eller finde strukturel friktion på tværs af en kodebase; eksplicit ikke til enkelt-modul interface design eller diff-niveau kodegennemgang.

Testrapport

SKILL.md læner sig op ad en søster-skill-mappe ('../codebase-design/SKILL.md' og dens DEEPENING.md) for sit kerne-vokabularium og afhængigheds-kategori logik — kopier kun architecture-audit/ pr den standard enkelt-mappe installation, og de links 404 lokalt. Kørte en reel audit mod en 4-fils kasserbar app med en tekstbog-pass-through service; den skill-guidede kørsel producerede en ægte mere handlingsorienteret leverance end en uledsaget baseline — en fuld improvement-template.md PRD (problem/interface/dependency-strategy/migration/risks) vs. baselinens to kasserbare sætninger.

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

Installation

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

Kommandoer og eksempelprompter

  • /architecture-auditAuditerer en kodebase for lave/koblede moduler og skriver en dyb-modul refactor PRD.

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • 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