1---2name: web-agency3description: Méta-orchestrateur de l'agence Web IA Full-Automatisée. Utilise ce skill quand: (1) routing d'une demande vers le bon skill, (2) orchestration multi-skills, (3) vue d'ensemble d'un projet, (4) coordination entre départements, (5) escalade de décisions stratégiques.4---5
6# Web Agency - Agence Web IA Full-Automatisée
7
8Tu es le **méta-orchestrateur** de l'agence web IA. Ta responsabilité unique : **router les requêtes vers le bon skill**.
9
10## Philosophie
11
12> Les clients demandent → l'intake qualifie → l'orchestrateur distribue → les skills exécutent → les humains supervisent.
13
14```
15 CLIENT
16 │
17 ▼
18┌───────────────────────────────────────────────────────────────┐
19│ NIVEAU 0 : ENTRÉE │
20│ ┌─────────────────────────────────────────────────────────┐ │
21│ │ client-intake │ │
22│ │ Réception → Qualification → Extraction → Routing │ │
23│ │ (23 agents) │ │
24│ └─────────────────────────────────────────────────────────┘ │
25└───────────────────────────────────────────────────────────────┘
26 │
27 ▼
28┌───────────────────────────────────────────────────────────────┐
29│ NIVEAU 1 : ORCHESTRATION │
30│ ┌─────────────────────────────────────────────────────────┐ │
31│ │ task-orchestrator │ │
32│ │ Queue → State Machine → Execution → Tracking │ │
33│ │ (16 agents) │ │
34│ └─────────────────────────────────────────────────────────┘ │
35└───────────────────────────────────────────────────────────────┘
36 │
37 ▼
38┌───────────────────────────────────────────────────────────────┐
39│ WEB-AGENCY │
40│ (Routage métier) │
41│ │
42│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
43│ │ project │ │direction│ │lead-dev │ │ web-dev │ │
44│ │-manage- │ │-techni- │ │ │ │-process │ │
45│ │ ment │ │ que │ │ │ │ │ │
46│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
47│ │
48│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
49│ │testing- │ │frontend │ │ backend │ │ devops │ │
50│ │process │ │-dev │ │-dev │ │ │ │
51│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
52│ │
53│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
54│ │wordpress│ │ react │ │ nextjs │ │ design- │ │marketing│ │
55│ │-gutenb. │ │ -expert │ │ -expert │ │ system │ │ │ │
56│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
57│ │
58│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
59│ │ ux-ui │ │ legal │ │ support │ │commerc- │ │ finance │ │
60│ │ -design │ │-compli- │ │ -client │ │ial-crm │ │-analyt. │ │
61│ │ │ │ ance │ │ │ │ │ │ │ │
62│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
63└───────────────────────────────────────────────────────────────┘
64 │
65 ▼
66 HUMAIN (supervision)
67```
68
69## Skills Disponibles
70
71### Niveau 0 : Entrée
72
73| Skill | Rôle | Agents | Statut |
74|-------|------|--------|--------|
75| `client-intake` | Réception et qualification des demandes | 28 | 🟢 |
76
77### Niveau 1 : Orchestration
78
79| Skill | Rôle | Agents | Statut |
80|-------|------|--------|--------|
81| `task-orchestrator` | Queue, state machine, exécution, tracking | 20 | 🟢 |
82
83### Niveau 2-4 : Métier
84
85| Skill | Rôle | Agents | Statut |
86|-------|------|--------|--------|
87| `project-management` | Gestion projet & client | 29 | 🟢 |
88| `direction-technique` | Décisions techniques stratégiques + stratégie digitale | 59 | 🟢 |
89| `lead-dev` | Coordination technique opérationnelle | 27 | 🟢 |
90| `web-dev-process` | Process de développement | 64 | 🟢 |
91| `testing-process` | Stratégie et méthodologie de tests | 25 | 🟢 |
92| `frontend-developer` | Implémentation frontend | 33 | 🟢 |
93| `backend-developer` | Implémentation backend | 38 | 🟢 |
94| `devops` | CI/CD, containers, K8s, IaC, monitoring | 30 | 🟢 |
95| `wordpress-gutenberg-expert` | Implémentation WordPress | 42 | 🟢 |
96| `react-expert` | Implémentation React | 28 | 🟢 |
97| `nextjs-expert` | Implémentation Next.js | 35 | 🟢 |
98| `design-system-foundations` | Design system Atomic | 21 | 🟢 |
99| `marketing` | Stratégie marketing, campagnes, ligne éditoriale | 117 | 🟢 |
100| `ux-ui-design` | UX Research, Wireframes, Design visuel, Branding, Motion | 27 | 🟢 |
101| `legal-compliance` | RGPD, Mentions légales, Audit conformité, Cookies | 16 | 🟢 |
102| `support-client` | Ticketing, Knowledge base, Escalade, Satisfaction | 16 | 🟢 |
103| `commercial-crm` | Pipeline, Prospection, Négociation, Rétention | 18 | 🟢 |
104| `finance-analytics` | Facturation, KPIs, Reporting, Prévisions | 17 | 🟢 |
105| `content-management` | Gestion éditoriale, rédaction, assets, localisation | 17 | 🟢 |
106
107**Total : 757 agents disponibles** (28 + 20 + 659 métier)
108
109## Routage Rapide
110
111### Niveau 0-1 : Entrée & Orchestration
112
113| Requête concerne... | → Skill |
114|---------------------|---------|
115| Nouvelle demande client (email, form, chat, webhook) | `client-intake` |
116| Qualification, faisabilité, complexité, urgence | `client-intake` |
117| Queue de tâches, priorités, distribution | `task-orchestrator` |
118| État des tâches, tracking, métriques | `task-orchestrator` |
119
120### Niveau 2-4 : Métier
121
122| Requête concerne... | → Skill |
123|---------------------|---------|
124| Client, brief, devis, planning, facture | `project-management` |
125| Choix stack, architecture, décisions stratégiques | `direction-technique` |
126| Benchmark concurrence, stratégie digitale, KPIs business | `direction-technique` |
127| Code review, coordination équipe, mentoring, release | `lead-dev` |
128| Process dev, méthodologie, checklists | `web-dev-process` |
129| Stratégie tests, TDD/BDD, pyramide, coverage, sécurité, accessibilité | `testing-process` |
130| Implémentation frontend, React, CSS, TypeScript | `frontend-developer` |
131| Next.js, App Router, Server Components, SSR | `nextjs-expert` |
132| API, bases de données, Node.js, PHP backend | `backend-developer` |
133| CI/CD, Docker, Kubernetes, Terraform, monitoring | `devops` |
134| WordPress, Gutenberg, blocks, WP-CLI | `wordpress-gutenberg-expert` |
135| Tokens, boutons, formulaires, composants | `design-system-foundations` |
136| Campagnes, SEO, réseaux sociaux, analytics | `marketing` |
137| Ligne éditoriale, arborescence, architecture information | `marketing` |
138| UX research, personas, wireframes, maquettes, prototypes | `ux-ui-design` |
139| Direction artistique, branding, identité visuelle, motion design | `ux-ui-design` |
140| RGPD, CGV, mentions légales, conformité, cookies | `legal-compliance` |
141| Tickets, FAQ, support technique, SLA, satisfaction | `support-client` |
142| Pipeline commercial, leads, propositions, CRM | `commercial-crm` |
143| Factures, paiements, KPIs, reporting, budget, forecast | `finance-analytics` |
144| Contenu éditorial, articles, rédaction, calendrier éditorial | `content-management` |
145| Assets média, images, vidéos, localisation, traduction | `content-management` |
146
147**Règles détaillées** → [orchestration/routing.md](./orchestration/routing.md)
148
149## Hiérarchie Complète
150
151```
152┌─────────────────────────────────────────────────────────────────────┐
153│ NIVEAU 0 : ENTRÉE (client-intake) │
154│ → RÉCEPTION : Emails, formulaires, chats, webhooks │
155│ → QUALIFICATION : Intent, complexité, urgence, faisabilité │
156│ → EXTRACTION : Requirements, stakeholders, contraintes │
157│ → ROUTING : Vers task-orchestrator │
158├─────────────────────────────────────────────────────────────────────┤
159│ NIVEAU 1 : ORCHESTRATION (task-orchestrator) │
160│ → QUEUE : Priorités, capacité, SLA │
161│ → STATE MACHINE : Lifecycle des tâches │
162│ → EXECUTION : Dispatch, parallélisation, collecte │
163│ → TRACKING : Progress, métriques, audit │
164├─────────────────────────────────────────────────────────────────────┤
165│ NIVEAU 2 : STRATÉGIE (direction-technique) │
166│ → POURQUOI : Décisions, politiques, standards │
167├─────────────────────────────────────────────────────────────────────┤
168│ NIVEAU 3 : OPÉRATIONS (PROCESSUS) │
169│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
170│ │ web-dev-process │ │ testing-process │ │ lead-dev │ │
171│ │ │ │ │ │ │ │
172│ │ QUOI: Méthodo │ │ QUOI: Tests │ │ QUI: Coordination│ │
173│ │ • 7 phases │ │ • Stratégie │ │ • Code review │ │
174│ │ • Checklists │ │ • Types tests │ │ • Team coord │ │
175│ │ • Workflows │ │ • Qualité/Perf │ │ • Delivery │ │
176│ └──────────────────┘ └──────────────────┘ └──────────────────┘ │
177├─────────────────────────────────────────────────────────────────────┤
178│ NIVEAU 4 : IMPLÉMENTATION (skills techniques) │
179│ → COMMENT : Code, configuration, patterns │
180│ frontend-dev, backend-dev, devops, react-expert, nextjs-expert, │
181│ wordpress-gutenberg-expert, design-system-foundations, marketing │
182├─────────────────────────────────────────────────────────────────────┤
183│ NIVEAU 4 : FONCTIONS SUPPORT (skills transverses) │
184│ → QUOI : UX, Légal, Support, Commercial, Finance │
185│ ux-ui-design, legal-compliance, support-client, │
186│ commercial-crm, finance-analytics │
187└─────────────────────────────────────────────────────────────────────┘
188```
189
190**Architecture Full-Automatisée** :
191- `client-intake` = **POINT D'ENTRÉE** (multicanal, NLP, qualification automatique)
192- `task-orchestrator` = **MOTEUR** (queue, state machine, distribution)
193
194**Distinction NIVEAU 3** :
195- `web-dev-process` = **QUOI** (méthodologie, process, checklists)
196- `testing-process` = **QUOI** (stratégie tests, types, qualité, sécurité, accessibilité)
197- `lead-dev` = **QUI** (coordination, exécution, qualité quotidienne)
198
199## Documentation
200
201| Document | Description |
202|----------|-------------|
203| [orchestration/routing.md](./orchestration/routing.md) | Règles de routage détaillées |
204| [orchestration/composition.md](./orchestration/composition.md) | Comment combiner les skills |
205| [orchestration/escalation.md](./orchestration/escalation.md) | Points d'escalade humaine |
206
207### Workflows Automatisés (v3.0.0)
208
209| Workflow | Description | SLA |
210|----------|-------------|-----|
211| [workflows/email-to-devis.md](./workflows/email-to-devis.md) | Email client → Devis automatisé | < 24h |
212| [workflows/bug-to-hotfix.md](./workflows/bug-to-hotfix.md) | Bug report → Hotfix déployé | P1: 4h |
213| [workflows/feature-to-sprint.md](./workflows/feature-to-sprint.md) | Feature request → Sprint planning | 3-5 jours |
214
215### Workflows Classiques
216
217| Workflow | Description |
218|----------|-------------|
219| [workflows/nouveau-projet.md](./workflows/nouveau-projet.md) | Workflow nouveau projet complet |
220| [workflows/refonte.md](./workflows/refonte.md) | Workflow refonte site existant |
221
222## ADRs
223
224| ADR | Titre |
225|-----|-------|
226| [001](./docs/adr/001-single-responsibility-agents.md) | Single Responsibility Agents |
227| [002](./docs/adr/002-hierarchical-orchestrators.md) | Orchestrateurs Hiérarchiques |
228| [003](./docs/adr/003-markdown-agent-format.md) | Format Markdown |
229| [004](./docs/adr/004-human-supervision.md) | Supervision Humaine |
230| [005](./docs/adr/005-skill-responsibility-boundaries.md) | Frontières entre Skills |
231| [006](./docs/adr/006-hierarchy-clarification.md) | Clarification Hiérarchie lead-dev/web-dev-process |
232| [007](./docs/adr/007-skill-extraction-pattern.md) | Pattern d'Extraction de Skills |
233
234## Changelog
235
236### v3.2.0
237
238- **Renforcement skills existants** : +39 agents
239 - `ux-ui-design` v2.0.0 (+5 agents) : Nouveau domaine `branding/`
240 - `marketing` v1.4.0 (+2 agents) : Renforcement domaine `content/`
241 - `direction-technique` v3.1.0 (+5 agents) : Nouveau domaine `strategy/`
242 - Autres skills : Mise à jour comptages et enrichissement agents
243- **Workflows avec livrables et critères d'acceptation**
244 - Matrice de positionnement client (Triangle Budget/Qualité/Délai)
245 - Livrables par workflow avec niveaux (Minimal/Standard/Premium)
246 - Critères d'acceptation codifiés (CA-XXX-000)
247- **539 agents enrichis avec références workflows**
248- **Nouveau skill** : `content-management` (17 agents) - Gestion éditoriale complète
249- **Couverture métiers** : Ajout branding, DA, motion design, ligne éditoriale, stratégie digitale, content management
250- **Total agents** : 707 (vs 651 en v3.1.0)
251
252### v3.1.0
253
254- **Nouveaux skills** : Ajout de 5 skills fonctions support (88 agents)
255 - `ux-ui-design` (22 agents) : UX Research, Wireframes, Design visuel, Prototypage, Tests utilisateurs
256 - Domaines : research, wireframe, visual, prototype, testing
257 - `legal-compliance` (16 agents) : RGPD, Documents légaux, Audit conformité, Cookies
258 - Domaines : rgpd, documents, audit, cookies
259 - `support-client` (16 agents) : Ticketing, Knowledge base, Escalade, Satisfaction
260 - Domaines : ticketing, knowledge, escalation, satisfaction
261 - `commercial-crm` (17 agents) : Pipeline, Prospection, Négociation, Rétention
262 - Domaines : pipeline, prospection, negotiation, retention
263 - `finance-analytics` (17 agents) : Facturation, KPIs, Reporting, Prévisions
264 - Domaines : billing, kpis, reporting, forecasting
265- **Architecture** : Ajout niveau "Fonctions Support" pour skills transverses
266- **Total agents** : 651 (vs 563 en v3.0.1, +88 agents)
267
268### v3.0.1
269
270- **Workflows** : Ajout de 3 workflows automatisés end-to-end
271 - `email-to-devis.md` : Email client → Devis en < 24h (94% automatisé)
272 - `bug-to-hotfix.md` : Bug report → Hotfix déployé (SLA P1: 4h)
273 - `feature-to-sprint.md` : Feature request → Sprint planning (3-5 jours)
274- **Documentation** : Restructuration section workflows (automatisés vs classiques)
275
276### v3.0.0
277
278- **MAJOR** : Transformation en Agence Web IA Full-Automatisée
279- **Nouveau skill** : `client-intake` (23 agents) - Point d'entrée automatisé
280 - Domaines : reception, qualification, extraction, response, routing
281 - Multicanal : email, formulaires, chat, webhooks
282 - NLP : classification d'intent, détection d'urgence, estimation budget
283 - Position : NIVEAU 0 ENTRÉE
284- **Nouveau skill** : `task-orchestrator` (16 agents) - Moteur d'orchestration
285 - Domaines : queue, state-machine, execution, tracking
286 - Queue management : priorités dynamiques, capacité, SLA
287 - State machine : lifecycle complet des tâches
288 - Position : NIVEAU 1 ORCHESTRATION
289- **Architecture** : Nouveau modèle 5 niveaux (0: Entrée → 1: Orchestration → 2: Stratégie → 3: Opérations → 4: Implémentation)
290- **Total agents** : 563 (vs 409 en v2.9.0, +154 agents)
291- **Intégration** : Ajout du skill `marketing` (115 agents) dans le routage
292
293### v2.9.0
294
295- **Nettoyage** : Suppression des 4 skills vides non implémentés
296 - `strategy/`, `design/`, `content/`, `marketing/` supprimés
297 - Retrait de la note de routage obsolète
298- **Nettoyage** : Suppression du doublon `backend-developer/agents/devops/`
299 - Le domaine DevOps est maintenant exclusivement dans le skill `devops` autonome
300- **Documentation** : Ajout de ADR-007 (Pattern d'Extraction de Skills)
301- **Documentation** : Ajout du graphe de dépendances (`orchestration/dependency-graph.md`)
302- **Documentation** : Mise à jour de `orchestration/composition.md` v2.0.0
303
304### v2.8.0
305
306- **Nouveau skill** : Ajout de `testing-process` (25 agents) comme skill autonome
307 - Consolidation des 34 agents testing dispersés dans 6 skills
308 - Domaines : strategy, types, quality, performance, security, accessibility
309 - Position : NIVEAU 2 PROCESSUS (peer de web-dev-process et lead-dev)
310 - Distinction claire : PROCESS (quoi/quand tester) vs IMPLEMENTATION (comment coder les tests)
311- **Total agents** : 409 (vs 384 en v2.7.0)
312
313### v2.7.0
314
315- **Nouveau skill** : Ajout de `devops` (30 agents) comme skill autonome
316 - CI/CD, containers, Kubernetes, Infrastructure as Code, monitoring, deployment
317 - Extraction depuis backend-developer/devops
318 - Position : NIVEAU 3 IMPLÉMENTATION
319- **backend-developer** : v1.1.0 - Domaine DevOps redirigé vers skill `devops`
320- **Total agents** : 384 (vs 360 en v2.6.0)
321
322### v2.6.0
323
324- **Clarification hiérarchie** : lead-dev et web-dev-process sont au même niveau (NIVEAU 2: OPÉRATIONS)
325- **Distinction claire** : web-dev-process = QUOI (process), lead-dev = QUI (coordination)
326- **ADR-006** : Documentation de la décision d'architecture
327
328### v2.5.0
329
330- **Clarification** : Skills planifiés (strategy, design, content, marketing) clairement marqués comme non disponibles
331- **Amélioration** : Matrice de désambiguïsation ajoutée dans `orchestration/routing.md`
332- **Amélioration** : Règles de priorité RACI pour les mots-clés ambigus
333- **Documentation** : Règle de décision en 4 étapes pour le routage
334
335### v2.4.0
336
337- **Nouveau** : Ajout du skill `nextjs-expert` (35 agents)
338 - Implémentation Next.js 14+ avec App Router
339 - Domaines : app-router, server-components, data, rendering, optimization, deployment, testing
340 - Position : NIVEAU 3 COMMENT (implémentation)
341- **Total agents** : 360 (vs 325 en v2.3.0)
342
343### v2.3.0
344
345- **Nouveau** : Ajout du skill `lead-dev` (27 agents)
346 - Coordination technique opérationnelle
347 - Domaines : code-review, team-coordination, technical-decisions, mentoring, delivery
348 - Position : entre direction-technique (stratégique) et développeurs (implémentation)
349- **Mise à jour** : Hiérarchie des skills avec niveau COORDINATION
350- **Total agents** : 325 (vs 199 en v2.2.0)
351
352### v2.2.0
353
354> **📖 [Guide de Migration](./docs/analysis/MIGRATION.md)** - Consultez ce guide avant de mettre à jour
355
356- **Breaking** : Intègre `direction-technique` v3.0.0
357 - Tous les agents POURQUOI-level sans code d'implémentation
358 - Le code a été déplacé vers les skills COMMENT-level
359- **Version Relationship** : web-agency 2.x → direction-technique 3.x (voir ADR-005)
360
361### v2.1.0
362- **Refactoring SRP** : Séparation routage/composition/escalade
363- Création dossier `orchestration/` avec agents spécialisés
364- Création dossier `workflows/` avec scénarios
365- Allègement du SKILL.md (responsabilité unique : routage)
366- Ajout ADR-005 (frontières entre skills)
367
368### v2.0.1
369- Renommage `technical` → `direction-technique`
370
371### v2.0.0
372- Refactoring en méta-orchestrateur
373- Skills métiers extraits en skills autonomes
374
375### v1.0.0
376- Création initiale