Architecture Audit

Granskar en kodbas för grunda/kopplade moduler och skriver en PRD för refaktorering av djupa moduler.

av helderberto · helderberto/agent-skills

Fungerar med konfiguration ★ 8.0/10

Architecture Audit — Granskar en kodbas för grunda/kopplade moduler och skriver en PRD för refaktorering av djupa moduler.

Vad den gör

Utforskar en kodbas för arkitektonisk friktion (pass-through wrappers, temporal decomposition, tight coupling at seams) och skriver en förbättrings-PRD som föreslår en refaktorering mot djupa moduler (small interface, large implementation), med alternativa gränssnittsdesigner och en migreringsplan. Utlöses vid förfrågningar om att granska arkitektur eller hitta strukturell friktion i en kodbas; explicit inte för gränssnittsdesign av enskilda moduler eller kodgranskning på diff-nivå.

Testrapport

SKILL.md förlitar sig på en syskon-skill-mapp ('../codebase-design/SKILL.md' och dess DEEPENING.md) för sitt kärnvokabulär och beroende-kategorilogik – kopiera bara architecture-audit/ enligt standardinstallationen med en enda katalog och dessa länkar 404 lokalt. Körde en verklig granskning mot en 4-fils engångsapp med en läroboks pass-through-tjänst; den skill-guidade körningen producerade en genuint mer handlingsbar leverans än en obeväpnad baslinje – en fullständig improvement-template.md PRD (problem/interface/dependency-strategy/migration/risks) kontra baslinjens två engångsmeningar.

Testad: 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

Kommandon och exempelprompter

  • /architecture-auditGranskar en kodbas för grunda/kopplade moduler och skriver en PRD för refaktorering av djupa moduler.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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