# agentMarketing Système d'orchestration marketing par agent IA — Brief → Plan → Assets → Review. File-based, exécuté via Cursor IDE. --- ## Prérequis : Journey 0 — Setup de la Knowledge Base **Avant d'exécuter les workflows (sprint 1 et suivants), remplir les fichiers KB core.** La Knowledge Base est le cerveau de l'agent. Sans contenu, les outputs seront génériques ou incomplets. ### Fichiers à remplir (ordre recommandé) | Fichier | Priorité | Description | |---------|----------|-------------| | `knowledge/shared/tone-of-voice.md` | 1 | Ton, anti-vocabulary, exemples do/don't | | `knowledge/shared/guardrails.md` | 2 | Claims autorisées/interdites, règles email | | `knowledge/shared/personas.md` | 3 | Profils clients, objections, JTBD | | `knowledge/livinweb/offers.md` | 4 | Offres Livinweb | | `knowledge/livinweb/positioning.md` | 5 | Positionnement Livinweb | | `knowledge/livinia/offers.md` | 6 | Offres Livinia | | `knowledge/livinia/positioning.md` | 7 | Positionnement Livinia | `knowledge/shared/history.md` se remplit automatiquement via le workflow 4 (Performance Review). ### Fichiers optionnels (phase-specific) Chargés à la demande selon le workflow : | Dossier | Fichiers | Chargé par | |---------|----------|------------| | `knowledge/frameworks/` | obviously-awesome, awareness-levels, bullseye-channels, cmo-cadence | Workflow 2 (Weekly Plan) | | `knowledge/swipe-files/` | linkedin-posts, cold-email, ad-copy-b2b | Workflow 3 (Asset Generation) | | `knowledge/benchmarks/` | cold-email, linkedin | Workflow 3 (Asset Generation) | --- ## Rituel hebdomadaire : Brief → Plan → Assets → Review ``` 0. Weekly Interview → 1. Weekly Brief → 2. Weekly Plan → 3. Asset Generation → 4. Performance Review (entretien guidé, (signaux) (1 priorité + 3 (posts, email, (stats, Continue/Stop/ optionnel) expériences) tasks.json) history.md) ↓ ↓ ↓ ↓ ↓ Questions 🎯 CHALLENGER 🎯 CHALLENGER 🎯 CHALLENGER 🎯 CHALLENGER ouvertes + (complétude, (choix stratégie, (qualité créative, (trajectoire long terme, pré-brief seuils, données) hypothèses, alt.) variété, wild card) décisions difficiles) ``` ### Le Challenger — Directeur Marketing Consultant À chaque étape, un **directeur marketing senior** challenge l'output avant validation : - Pose 3-5 questions pointues spécifiques aux données de la semaine - L'utilisateur peut répondre ou taper `/skip` pour passer - Les questions non répondues persistent dans `history.md` et reviennent si pertinentes - Les réponses peuvent déclencher un ajustement de l'output Voir `workflows/shared/challenger-block.md` pour le détail de la mécanique. ### Mémoire stratégique `knowledge/shared/history.md` est le cerveau cumulatif du système : - **Entrées** — Résultats des expériences (Continue/Stop/Adjust) - **Patterns détectés** — Signaux récurrents sur 2+ semaines - **Questions en suspens** — Questions challenger non répondues, re-proposées automatiquement --- ## Cursor Commands Chaque rituel s'invoque via une commande slash. ### `/agentmarketing-benchmark` *(optionnel — avant le Weekly Plan)* **Quand :** En début de semaine, avant ou après le brief — idéalement après avoir lancé les scripts de collecte. **Étape 1 — Lancer la collecte (terminal) :** ```powershell node scripts/benchmark-run.js ``` Ce script : - Appelle la Meta Ad Library API pour les pubs Facebook actives des concurrents - Scrape les sites web des concurrents - Génère un formulaire de collecte manuelle pour LinkedIn **Étape 2 — Analyser et synthétiser (Cursor) :** Lancer `/agentmarketing-benchmark`. L'agent : - Complète les sections d'analyse dans les fichiers de collecte - Guide la collecte LinkedIn manuelle si nécessaire - Produit un rapport de synthèse avec menaces, opportunités, recommandations **Prérequis :** - `knowledge/shared/competitors.json` rempli avec les concurrents à surveiller - `META_AD_LIBRARY_TOKEN` dans `.env` (optionnel — pubs Facebook simulées sans) **Output :** `knowledge/benchmarks/benchmark-report-YYYY-WXX.md` — chargé automatiquement dans le workflow 2 (Weekly Plan) --- ### `/agentmarketing-weekly-interview` *(optionnel — recommandé)* **Quand :** Avant le brief — l'agent mène l'entretien. - L'agent pose des questions en mode conversationnel (une à la fois) - Il alterne signaux terrain (surprises, conversations, frustrations) et cadrage (chiffres, priorités, objectifs) - Il synthétise l'entretien en un pré-brief structuré qu'Augustin valide - Le pré-brief est ensuite transmis au workflow 1 comme source de signaux **Output :** `outputs/YYYY-MM/week-XX/weekly-interview.md` --- ### `/agentmarketing-weekly-brief` **Quand :** Début de semaine — ingestion des signaux. - Soumettre le brief (template structuré) - Joindre des fichiers optionnels (CSV, notes, stats) - L'agent extrait les signaux, détecte la marque (livinweb | livinia), valide avant plan **Output :** `outputs/YYYY-MM/week-XX/weekly-brief.md` --- ### `/agentmarketing-weekly-plan` **Quand :** Après validation du brief — génération du plan. - 1 priorité principale + 3 expériences - Chaque expérience : hypothèse, channel, message, KPI, critères succès/échec - Boucle adversariale interne avant soumission - Augustin valide, rejette ou demande des ajustements **Output :** `outputs/YYYY-MM/week-XX/week-plan.md` --- ### `/agentmarketing-asset-generation` **Quand :** Après validation du plan — génération des assets. - 3 posts LinkedIn alignés à la priorité - Séquence cold email - `tasks.json` (tâches structurées pour Notion/Trello) - Ton de voix et guardrails appliqués **Output :** `outputs/YYYY-MM/week-XX/linkedin-posts.md`, `email-sequence.md`, `tasks.json` --- ### `/agentmarketing-performance-review` **Quand :** Fin de semaine ou début suivante — review des performances (Phase 2). - Soumettre les stats (texte ou CSV) - Recommandations Continue/Stop/Adjust par expérience - Référence aux semaines précédentes pour détecter des patterns - Proposition d'entrée pour `history.md` (Augustin valide avant écriture — l'agent ne modifie jamais history.md directement) **Output :** `outputs/YYYY-MM/week-XX/performance-review.md` --- ## Structure du projet ``` agentMarketing/ ├── knowledge/ ← KB (read-only pour l'agent) │ ├── livinweb/ ← Offres, positioning Livinweb │ ├── livinia/ ← Offres, positioning Livinia │ ├── shared/ ← tone-of-voice, guardrails, personas, history, competitors │ ├── frameworks/ ← Chargés à la demande (Weekly Plan) │ ├── swipe-files/ ← Chargés à la demande (Asset Generation) │ └── benchmarks/ ← Rapports de veille hebdos (générés par scripts + agents) ├── workflows/ ← Step-files des workflows │ ├── 0-weekly-interview/ ← Entretien guidé pré-brief (optionnel) │ ├── 1-weekly-brief/ │ ├── 2-weekly-plan/ │ ├── 3-asset-generation/ │ ├── 4-performance-review/ │ ├── 5-generate-visuals/ │ ├── 6-benchmark/ ← Veille concurrentielle (pub FB + com + rapport) │ └── shared/ ← Blocs réutilisables (challenger-block.md) ├── scripts/ ← Scripts Node.js automatisés │ ├── benchmark-run.js ← Orchestrateur benchmark (lance les 2 scripts) │ ├── benchmark-facebook-ads.js ← Meta Ad Library API │ ├── benchmark-communication.js ← Scraping sites + collecte LinkedIn guidée │ ├── generate-visuals.js │ └── generate-pdf.js ├── templates/ ← Formats des outputs └── outputs/ ← YYYY-MM/week-XX/ (artefacts hebdomadaires) ``` --- ## Validation Pour vérifier que la structure est complète : ```powershell .\scripts\validate-agentmarketing.ps1 ``` ## Conventions et architecture Pour les conventions de nommage, structure des fichiers KB, frontmatter des outputs, pattern de refus guardrail et handoff entre workflows : **voir `_bmad-output/planning-artifacts/architecture.md`**. --- ## Marques Le système gère deux marques strictement séparées : - **livinweb** — Agence web, PME, sites, refonte, maintenance - **livinia** — ESN IA, Data, GenAI, Agents IA, cibles DSI/CTO Chaque brief déclare une marque. La KB chargée correspond exclusivement à cette marque.