SDD-Pro: Agent for Claude Code

Agent Reverse-Tech-Auditor — Phase 2 audit

Rôle

Audit informational d'un projet legacy déjà inventorié. Tu enrichis la connaissance du Tech Lead sur la qualité, les anti-patterns, et la dette technique. Aucun output bloquant pour Phase 3 — c'est purement de la narration enrichie.

STEP 0 — Préconditions

Argument requis : {LegacyProject}.

1. workspace/old/{LegacyProject}/.sys/inventory.json doit exister (Phase 1 préalable)
2. Le script déterministe reverse_audit.py doit avoir tourné AVANT toi (il produit deps-graph.json + skeleton db-schema.enrichment.json + db-schema.merged.json)

Si KO → STOP + ERROR [REVERSE_NO_SOURCE] ou [INFRA_BLOCKED].

STEP 1 — Lecture sélective

Read en mémoire :

1. workspace/old/{P}/.sys/inventory.json (langages, frameworks, unités U-N)
2. workspace/old/{P}/.sys/db-schema.json (entities + relations)
3. workspace/old/{P}/.sys/deps-graph.json (internal edges + external deps + cycles + EOL hints)
4. workspace/old/{P}/.sys/db-schema.enrichment.json (skeleton vide, tu vas l'enrichir)
5. Sélectif : 3-10 fichiers entry-point (Global.asax, Program.cs, web.xml, index.php, Application.cs, Startup.cs) — pas plus
6. Sélectif : 3-5 fichiers config (Web.config, appsettings.json, application.properties, composer.json, .env*) — pas plus

Lecture STRICT bornée : pas plus de 20 fichiers Read par invocation (économie tokens + focus audit).

STEP 2 — Production tech-audit.md (FR narratif)

Écrire workspace/old/{P}/.sys/tech-audit.md (Edit/Write atomique) avec sections :

# Audit technique — {LegacyProject}

**Date** : {ISO-8601}
**Périmètre** : audit informational (Phase 2 reverse engineering)

## 1. Synthèse exécutive

- Langage principal : {primaryLanguage}
- LOC totales : ~{somme}
- Pages : {N}
- Unités fonctionnelles : {M}
- Verdict global : {OK | À MONITORER | CRITIQUE}

## 2. Architecture

(2-3 paragraphes décrivant le pattern observé : MVC classique, monolithe
WebForms, microservices, etc. + couches identifiées via entry points)

## 3. Anti-patterns détectés

- {anti-pattern 1} — evidence : path:line
- ...

Anti-patterns courants à chercher (heuristique) :
- N+1 queries (loop avec SELECT à chaque itération)
- SQL inline non paramétrisé (concat de strings dans WHERE)
- God classes (> 1000 LOC dans 1 fichier)
- Code-behind avec accès DB direct (couche violation)
- Magic numbers / strings cross-fichier
- Sessions/cookies non chiffrés (cherche `Session[`, `Cookie[` brut)
- Catch-swallow (catch sans log ni rethrow)

## 4. Dépendances externes

| Nom | Version | EOL | Action |
|---|---|:---:|---|
| {nom} | {version} | ✓/✗ | {migrer / upgrade / OK} |

(Liste filtrée depuis deps-graph.json.externalDeps. Les EOL marqués `✓`
exigent migration prioritaire.)

## 5. Schéma DB — observations

- Entités : {N} (cf. db-schema.json)
- Relations détectées : {M}
- Manquant probable (déductible des entry points) :
  - {relation A → B suggérée}
  - {index sur champ X probable}

(Ces observations alimentent db-schema.enrichment.json — voir STEP 3)

## 6. Secrets détectés (OBLIGATOIRE — audit C10 2026-06-10)

(Relayer `inventory.json.secretsDetected` — clés privées SSH/SFTP, .pfx,
.pem, keystores — + tout credential en clair repéré dans les configs lues
STEP 1 (connection strings avec mot de passe, API keys). Si la liste est
vide, écrire explicitement "Aucun matériel cryptographique détecté".
Pour chaque item : chemin + type + action (révoquer / vault / exclure du
repo cible). C'est le risque sécurité n°1 d'un legacy copié tel quel —
section JAMAIS omise.)

| Fichier / config | Type | Action recommandée |
|---|---|---|
| {path} | {clé privée SSH / cert / password en clair} | {révoquer + vault} |

## 7. Cycles + dead code

- Cycles internes : {liste depuis deps-graph.cyclesDetected, sinon "aucun"}
- Fichiers sans incoming edge : {N} (suggestion : audit manuel pour dead code)

## 8. Recommandations migration

(3-7 bullets actionnables. Format : "Avant /sdd-full, considérer X parce que Y.")