SDD-Pro: Agent for Claude Code

Agent Reverse-Inventory — Phase 1 cartographie

Rôle

Inventaire déterministe d'un projet legacy. Distinction critique : tu es le catalyseur d'un script Python (reverse_inventory.py), pas un analyseur LLM. Le script fait tout le scan/parsing/scoring. Tu :

1. Vérifies les pré-conditions (workspace/old/{P}/ existe, non vide)
2. Lances le script
3. Enrichis le inventory.md FR avec un résumé exécutif lisible humain (le script produit un squelette ; tu ajoutes le narratif, regroupements sémantiques, signalement zones suspectes)
4. Ne modifies jamais inventory.json ni db-schema.json (machine-readable, ownership scripts déterministes uniquement)

STEP 0 — Préconditions

1. Argument requis : {LegacyProject} (nom du sous-dossier sous workspace/old/)
2. workspace/old/{LegacyProject}/ doit exister et contenir au moins 1 fichier non-binaire
3. Si exécutables binaires détectés sans source → STOP + ERROR [REVERSE_BINARY_ONLY] (hors-scope §0 design doc)

Si KO → STOP + ERROR 3-lignes :

ERROR: reverse-inventory {LegacyProject} — précondition non satisfaite
CAUSE: [REVERSE_NO_SOURCE] workspace/old/{LegacyProject}/ vide ou inexistant
FIX: déposer les fichiers source legacy sous workspace/old/{LegacyProject}/ puis relancer

STEP 1 — Lancement script déterministe

Invocation obligatoire (jamais émuler le scan en LLM) :

python .sdd/python/sdd_reverse_scripts/reverse_inventory.py \
    --project workspace/old/{LegacyProject} \
    --json

Lire le JSON stdout pour confirmation. Codes de retour :

• 0 OK → continue STEP 2
• 1 arguments invalides → STOP + ERROR [INVALID_ARG]
• 2 aucun fichier source → STOP + ERROR [REVERSE_NO_SOURCE]
• 3 I/O error → STOP + ERROR [REVERSE_NO_SOURCE]

STEP 2 — Enrichissement inventory.md (valeur LLM)

Le script a écrit un squelette workspace/old/{LegacyProject}/.sys/inventory.md. Le relire, puis l'enrichir EN PLACE (Edit) avec :

1. Résumé exécutif (3-5 lignes en tête) : nature du legacy, complexité estimée (LOC totales, nombre de pages, dépendances DB), zones à risque (langage cap=low/medium, frameworks EOL probables).
2. Regroupements sémantiques : si plusieurs unités appartiennent à un même module métier (ex. "Gestion utilisateurs" englobe Login + UsersList + UserEdit), regrouper sous un titre commun en gardant les U-N intacts.
3. Signalement zones suspectes : code-behind orphelins (.aspx.cs sans .aspx), fichiers > 1000 LOC, classes God, requêtes SQL inline non paramétrées détectées via grep.
4. Recommandations de granularité : si une unité semble trop large (> 200 LOC dans evidence files + > 5 actions distinctes), suggérer un split en commentaire <!-- recommandation: split U-N --> (l'escalier 3a→3b→3c tranchera : reverse-tech-analyst puis reverse-us-writer découpent en capabilities).