# ARCHETYPE DETECTOR

Logique de détection d'archétype projet consommée par `/onboard` STEP 1.
Aucune exécution autonome — ce fichier documente l'algorithme que le skill applique.

---

## Inputs

1. Répertoire projet (cwd)
2. Résultat filesystem scan (manifests, structure, deps)
3. Liste des archétypes disponibles : `~/.claude/lib/project-archetypes/*.md` (hors `_TEMPLATE.md`)

## Algorithme

### PHASE A — Collect signals

Lire chaque archétype. Pour chaque archétype, charger les blocs :
- Strong signals (weight=3)
- Medium signals (weight=2)
- Weak signals (weight=1)

Types de signaux (syntaxe à matcher) :

| Syntaxe | Vérification |
|---|---|
| `FILE: <path>` | `test -f <path>` (relatif au projet root) |
| `DIR: <path>/` | `test -d <path>` |
| `STRING_IN_FILE: <path> contient "<pattern>"` | `grep -q "<pattern>" <path>` (fichier existe requis) |
| `DEP: <manifest> contient "<pkg>"` | parse manifest, vérifie clé `dependencies` OU `devDependencies` contient pkg |
| `EXT: N fichiers .<ext>` | `find . -name "*.<ext>" -not -path "*/node_modules/*" -not -path "*/.git/*" \| wc -l` → >= N |
| `TOOL: <cmd>` | `command -v <cmd>` existe |
| `REGEX: <path> matches "/<pattern>/"` | grep regex sur fichier |

### PHASE B — Score each archetype

Pour chaque archétype :

```
score_raw = Σ (signal_matched ? signal_weight : 0)
score_max = Σ signal_weight_total
score_pct = score_raw / score_max  (si score_max > 0, sinon 0)
```

Aussi compter `strong_hits` : nombre de strong signals matchés.

### PHASE C — Rank + select

Classer archétypes par `score_raw` décroissant.

**Règles de sélection** (dans l'ordre) :

1. **Un seul archétype avec score_raw ≥ 6 ET strong_hits ≥ 1** → SELECTED, confiance HAUTE.
2. **Top archétype dépasse le 2ème de ≥ 50% ET strong_hits ≥ 1** → SELECTED, confiance MOYENNE.
3. **2-3 archétypes avec scores proches (delta < 30%)** → AMBIGUOUS → demander à l'utilisateur.
4. **Aucun archétype avec score_raw ≥ 3** → UNKNOWN → demander manuellement ou partir d'un gabarit "generic".

### PHASE D — Composition

Certains projets sont combinés. Cas de composition détectés AUTOMATIQUEMENT :

- **WordPress + WooCommerce** : archétype `wordpress` + overlay `woocommerce` (si détecté)
- **Next.js + backend séparé dans monorepo** : plugin-advisor détecte déjà `monorepo`, on applique l'archétype par package
- **Astro + React islands** : archétype principal `astro-static`, noter la présence d'islands React dans les signaux
- **Drupal multi-site** : archétype `drupal` avec flag multisite

Ne pas inventer de compositions non listées.

---

## Output format

```
ARCHETYPE DETECTION
─────────────────────
Scores (top 5) :
  1. <name>  score: XX/YY (zz%) — strong: N, medium: N, weak: N  [SELECTED | CANDIDATE | REJECTED]
  2. ...

SELECTED     : <name>  (confiance : HAUTE | MOYENNE | BASSE | AMBIGU)
COMPOSITION  : <overlay si applicable, sinon "none">

JUSTIFICATION (signaux déterminants) :
  ✓ [strong] <signal>
  ✓ [medium] <signal>
  ✗ [strong] <signal> (attendu pour cet archétype, absent)

IMPLICATIONS AUTO-APPLIQUÉES :
  - public     : true | false
  - database   : required | optional | none
  - audit_stack: [liste]
  - plugins    : [recommandations]
```

Si AMBIGUOUS :

```
⚠️  ARCHÉTYPE AMBIGU — plusieurs candidats proches :
  A) <name>  score: XX (signaux: ...)
  B) <name>  score: XX (signaux: ...)
  C) <name>  score: XX (signaux: ...)
  D) None of the above — I'll describe it manually

Which one? (A / B / C / D)
```

Si UNKNOWN :

```
⚠️  AUCUN ARCHÉTYPE RECONNU
Je vois : <signaux détectés, ex : PHP files, no manifest, custom Makefile>
Questions manuelles :
  1. Quel type de projet ? (web / API / CLI / lib / desktop / mobile / game / firmware / autre)
  2. Public-facing (visible en recherche) ? (yes / no)
  3. Utilise une base de données ? (yes / no / depends)
  4. Stack principale ? (libre)
```

---

## Règles de robustesse

- **Ne jamais inventer un archétype** non présent dans `~/.claude/lib/project-archetypes/`.
- **Exclure** les dossiers `node_modules`, `.git`, `vendor`, `target`, `dist`, `build`, `.next`, `__pycache__` de tous les scans.
- **Timeout** : si un grep prend > 2s, l'abandonner et marquer le signal non-testé (ne compte pas dans le score).
- **Archétype non-monorepo** : si `monorepo` est détecté par plugin-advisor, passer la détection par package (un archetype par sous-package, pas un archetype global).

---

## Extension

Ajouter un nouvel archétype :
1. Créer `~/.claude/lib/project-archetypes/<name>.md` en respectant `_TEMPLATE.md`.
2. Tester avec `/onboard` en dry-run sur un projet connu de ce type.
3. Ajuster les weights si un signal s'avère trop discriminant/pas assez.

Retirer un archétype :
1. Supprimer le fichier.
2. Si des projets existants s'y référaient, migrer leur `CLAUDE.md` manuellement.