Architecture Audit

Auditiert eine Codebasis auf flache/gekoppelte Module und schreibt ein PRD für Refactoring mit tiefen Modulen.

von helderberto · helderberto/agent-skills

Funktioniert mit Setup ★ 8.0/10

Architecture Audit — Auditiert eine Codebasis auf flache/gekoppelte Module und schreibt ein PRD für Refactoring mit tiefen Modulen.

Was es kann

Erkundet eine Codebasis auf architektonische Reibung (Pass-Through-Wrapper, temporäre Dekomposition, enge Kopplung an Nähten) und schreibt ein Verbesserungs-PRD, das ein Refactoring hin zu tiefen Modulen (kleine Schnittstelle, große Implementierung) vorschlägt, mit alternativen Schnittstellendesigns und einem Migrationsplan. Löst bei Anfragen zur Auditierung der Architektur oder zum Finden struktureller Reibung in einer Codebasis aus; explizit nicht für die Schnittstellen-Gestaltung einzelner Module oder Code-Reviews auf Diff-Ebene.

Testbericht

SKILL.md stützt sich auf einen Geschwister-Skill-Ordner ('../codebase-design/SKILL.md' und dessen DEEPENING.md) für seinen Kernwortschatz und seine Abhängigkeitskategorielogik – kopieren Sie nur architecture-audit/ gemäß der Standard-Einzelordner-Installation, und diese Links ergeben lokal 404. Ein echtes Audit einer 4-Datei-Wegwerf-App mit einem textbuchartigen Pass-Through-Service wurde durchgeführt; die Skill-gesteuerte Ausführung lieferte ein wirklich umsetzbareres Ergebnis als eine ungesteuerte Baseline – ein vollständiges Improvement-Template.md PRD (Problem/Schnittstelle/Abhängigkeitsstrategie/Migration/Risiken) im Vergleich zu den zwei Wegwerf-Sätzen der Baseline.

Getestet am: 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

Befehle & Beispiel-Prompts

/architecture-auditAuditiert eine Codebasis auf flache/gekoppelte Module und schreibt ein PRD für Refactoring mit tiefen Modulen.

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →