Нет описания

augustin.podvin 2cadd9e59a améliorations 8 месяцев назад
.cursor 2cadd9e59a améliorations 8 месяцев назад
_bmad 2cadd9e59a améliorations 8 месяцев назад
docs d65ab45f92 Initial commit - Agent Marketing project setup 8 месяцев назад
knowledge 2cadd9e59a améliorations 8 месяцев назад
outputs 2cadd9e59a améliorations 8 месяцев назад
scripts 2cadd9e59a améliorations 8 месяцев назад
templates 2cadd9e59a améliorations 8 месяцев назад
workflows 2cadd9e59a améliorations 8 месяцев назад
.gitignore d65ab45f92 Initial commit - Agent Marketing project setup 8 месяцев назад
README.md 2cadd9e59a améliorations 8 месяцев назад

README.md

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) :

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 :

.\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.