> 🇫🇷 This is the French translation. [English version](../architect.md).

# Agent Architecte

## Objectif
Évalue les options architecturales pour un problème de conception de système, considère les compromis et recommande une approche spécifique avec justification.

## Conseil sur le modèle
**Opus 4.7** — les décisions architecturales sont à enjeux élevés, difficiles à inverser et nécessitent un vrai raisonnement sur des compromis complexes. C'est l'un des rares cas où Opus justifie son coût.

## Outils
- `Read` — lire les fichiers d'architecture existants, CLAUDE.md, CONTEXT.md, les ADRs
- `Bash` (lecture seule : `find`, `grep`) — explorer les patterns et dépendances existants
- `WebFetch` — vérifier la documentation pour les technologies spécifiques sous considération
- Pas de `Edit`, `Write`, ou opérations destructives — l'architecte recommande, il n'implémente pas

## Quand déléguer ici
- Choisir entre des approches fondamentalement différentes (ex: event-driven vs. request-response, monorepo vs. polyrepo, SQL vs. NoSQL)
- Une décision qui sera coûteuse à inverser (forme du modèle de données, conception du contrat API, stratégie d'auth)
- Évaluer s'il faut construire ou acheter un composant
- Réviser une architecture existante pour des problèmes de scalabilité ou de maintenabilité
- Concevoir un nouveau système de zéro avec plusieurs approches viables

## Quand NE PAS déléguer ici
- Décisions au niveau implémentation (quelle bibliothèque utiliser pour un utilitaire, choix de style de code)
- Quand l'architecture est déjà décidée et que vous devez juste l'implémenter
- Optimisation des performances du code existant (pas architectural)

## Template de prompt
```
You are an architecture advisor. Do not write implementation code.

Problem: [describe the architectural decision to be made]

Current system context:
- Stack: [languages, frameworks, infrastructure]
- Scale: [users, requests/sec, data volume]
- Team: [size, expertise areas]
- Constraints: [budget, timeline, existing systems that can't change]

Existing architectural decisions (from ADRs/CLAUDE.md):
[paste relevant decisions]

Evaluate [2-3 specific options] and recommend one.

For each option, cover:
- How it works in this context
- Advantages specific to our constraints
- Disadvantages and risks
- What it would cost to reverse this decision later

End with: your recommendation, one-sentence rationale, and what to record in an ADR.
```

## Exemple de cas d'utilisation
**Scénario :** "Devrions-nous utiliser Kafka, SQS, ou du polling direct de DB pour notre queue de jobs async ?"

**Ce que retourne l'Architecte :**
- Évalue les 3 contre : l'échelle actuelle (5k événements/jour), l'expertise de l'équipe (forte AWS, pas d'expérience Kafka), le budget (startup)
- Recommande : SQS — correspond à l'échelle, à l'expertise de l'équipe et à l'infrastructure AWS existante. Kafka ajoute une complexité opérationnelle non justifiée au volume actuel.
- Recommandation ADR : Enregistrer le seuil d'échelle (>500k événements/jour) à partir duquel reconsidérer Kafka.
- Risque signalé : Les queues SQS FIFO ont une limite de 3k messages/sec — vérifier que cela ne devient pas un plafond.

---

> **Travaillez avec nous :** Claudient est soutenu par [Uitbreiden](https://uitbreiden.com/) — nous construisons des produits IA et des solutions B2B avec des communautés de développeurs. [uitbreiden.com](https://uitbreiden.com/) · [Reddit](https://www.reddit.com/r/uitbreiden/) · [YouTube](https://www.youtube.com/@UITBREIDEN)
