tollfree-agent-matrix

Files (1)

• SKILL.md

SKILL.md (first lines)

# Matrice HASH_AGENT_MATRIX — Équipe HASH Engineering

Cette matrice définit **quelle équipe d'agents** déclencher selon le **type de tâche**, son **niveau de risque**, et le **pipeline optimal**. Elle est utilisée par le routage intelligent (AGENTS.md) et par le superviseur `tollfree`.

---

## 🎯 Agents Principaux (2)

| Agent | Modèle | Rôle | Activation |
|---|---|---|---|
| `@planner` | `google/gemini-2.5-flash` (FREE) | Transforme une demande en plan validé. Ne code jamais. | L2, L3, L4 |
| `@builder` | `google/gemini-2.5-flash` (FREE) | Exécute les plans, implémente, corrige, refactorise. | L1, L2, L3, L4 |

> **Règle** : `@planner` + `@builder` sont les seuls agents principaux. Les autres sont des sous-agents spécialisés appelés à la demande.

---

## 🧠 Sous-Agents Spécialisés (7)

| Agent | Modèle | Rôle | Trigger automatique | Permissions |
|---|---|---|---|---|
| `@architect` | `google/gemini-2.5-flash` | Décisions architecturales, modularité, dette technique | L3, L4, nouveau module, refonte API | `bash: deny`, `edit: deny` |
| `@design-lead` | `google/gemini-2.5-flash` | Direction visuelle, UX, design system, accessibilité | UI majeure, nouveau produit, dashboard | `bash: allow`, `edit: allow` |
| `@quality-engineer` | `google/gemini-2.5-flash` | Détecte sur-ingénierie, code IA suspect, non-maintenable | L2, L3, L4, avant commit | `bash: deny`, `edit: deny` |
| `@tester` | `google/gemini-2.5-flash` | Tests ciblés, validation fonctionnelle, régressions | Après tout code non-trivial | `bash: allow`, `edit: deny` |
| `@security` | `google/gemini-2.5-flash` | Auth, authz, input validation, secrets, config | Auth, payments, API, production | `bash: deny`, `edit: deny` |
| `@reviewer` | `google/gemini-2.5-flash` | Revue indépendante : bugs, sécurité, qualité, cohérence | Avant merge, L2-L4 | `bash: deny`, `edit: deny` |
| `@git-engineer` | `google/gemini-2.5-flash` | Git, commits, PR, CI/CD, repo hygiene | Merge prep, pipeline CI | `bash: allow`, `edit: deny` |

> **Tous les modèles sont FREE** (`google/gemini-2.5-flash` ou équivalents).

---

## 🎨 Pipeline par Niveau de Risque (Matrice de Routage)

### L1 — Simple (typo, config, bug localisé, couleur)
```
@builder  (L1)
    ↓
✅ SHIP (vérif basique)
```

| Agent | Skills | Validation |
|---|---|---|
| `@builder` | `tollfree-verification`, `tollfree-enterprise-development` | Smoke test rapide |

---

### L2 — Moyen (feature limitée, module, endpoint, business logic)
```
@planner
    ↓
@builder
    ↓
@tester (ciblé)
    ↓
@quality-engineer (code smell check)
    ↓
@reviewer (independant)
    ↓
✅ SHIP / ❌ FIX
```

| Agent | Skills | Validation |
|---|---|---|
| `@planner` | `writing-plans`, `tollfree-code-navigation` | Plan approuvé par utilisateur |
| `@builder` | `tollfree-enterprise-development`, `tollfree-verification` | - |
| `@tester` | `tollfree-verification` | Tests ciblés uniquement |
| `@quality-engineer` | `tollfree-enterprise-development`, `simplify` | Quality report |
| `@reviewer` | `code-review-skill`, `tollfree-verification` | SHIP/FIX |

---

### L3 — Complexe (nouveau module, architecture, API change, auth, payment)
```
@planner
    ↓
@architect (décision + alternatives)
    ↓
⚠️  USER APPROVAL REQUIRED
    ↓
@builder
    ↓
@security (si zone sensible)
    ↓
@tester (module + consumers)
    ↓
@quality-engineer
    ↓
@reviewer (indépendant)
    ↓
✅ SHIP / ❌ FIX
```

| Agent | Skills | Validation |
|---|---|---|
| `@planner` | `writing-plans`, `tollfree-code-navigation` | Plan + risques identifiés |
| `@architect` | `writing-plans` (architecture), `tollfree-enterprise-development` | Décision architecturale documentée |
| `@builder` | `tollfree-enterprise-development`, `tollfree-verification` | - |
| `@security` | `tollfree-enterprise-development`, `cybersecurity` | Security audit |
| `@tester` | `tollfree-verification` | Tests module + consumers |
| `@quality-engineer` | `tollfree-enterprise-development`, `simplify` | Quality report |
| `@reviewer` | `code-review-skill`, `tollfree-verification` | SHIP/FIX |

---

### L4 — Critique (production, données sensibles, migration destructive, infra)
```
@planner
    ↓
@architect (risk assessment complet)
    ↓
⚠️  USER APPROVAL REQUISE (écrite)
    ↓
@security (audit approfondi)
    ↓
@builder (exécution protégée)
    ↓
@tester (exhaustif : module + intégration + edge cases)

From digitaleflex/eurinhash-opencode-booster, MIT.

More from digitaleflex/eurinhash-opencode-booster