Architecture Audit

Audite une base de code pour des modules peu profonds/couplés et écrit un PRD de refactorisation de modules profonds.

par helderberto · helderberto/agent-skills

Fonctionne avec configuration ★ 8.0/10

Architecture Audit — Audite une base de code pour des modules peu profonds/couplés et écrit un PRD de refactorisation de modules profonds.

Ce que fait

Explore une base de code à la recherche de frictions architecturales (wrappers de passage, décomposition temporelle, couplage étroit aux coutures) et écrit un PRD d'amélioration proposant une refactorisation vers des modules profonds (petite interface, grande implémentation), avec des conceptions d'interface alternatives et un plan de migration. Se déclenche sur les demandes d'audit d'architecture ou de recherche de frictions structurelles dans une base de code ; explicitement pas pour la conception d'interface de module unique ou la revue de code au niveau du diff.

Rapport de test

SKILL.md s'appuie sur un dossier de compétence sœur ('../codebase-design/SKILL.md' et son DEEPENING.md) pour son vocabulaire principal et sa logique de catégorie de dépendances — copier uniquement architecture-audit/ selon l'installation standard à répertoire unique et ces liens 404 localement. A exécuté un audit réel sur une application jetable de 4 fichiers avec un service de passage textbook ; l'exécution guidée par la compétence a produit un livrable véritablement plus actionnable qu'une base non assistée — un PRD complet avec modèle d'amélioration (problème/interface/stratégie de dépendance/migration/risques) contre les deux phrases jetables de la base.

Testé le: 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

Commandes et exemples de prompts

  • /architecture-auditAudite une base de code pour des modules peu profonds/couplés et écrit un PRD de refactorisation de modules profonds.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • 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