workflow.md 4.0 KB


workflow: weekly-brief brand: both

version: 1.0

Workflow : Weekly Brief

Ingestion des signaux hebdomadaires, détection de marque, validation avant plan. FR1-FR5.

RÈGLES OBLIGATOIRES

DOIT :

  • Utiliser le template templates/weekly-brief.md comme structure de sortie
  • Extraire et parser les signaux clés du brief (offre ciblée, résultats semaine précédente, objections, contraintes)
  • Identifier la marque ciblée (livinweb | livinia) depuis le brief — FR4
  • Proposer une correction ou complément si le brief est incomplet — FR5
  • Écrire l'output dans outputs/YYYY-MM/week-XX/weekly-brief.md avec le frontmatter obligatoire
  • Générer un session-log.md dans le même dossier (NFR14)

NE DOIT PAS :

  • Changer status de draft à validated sans validation explicite d'Augustin
  • Charger la KB marque avant que le brand soit identifié
  • Inventer des signaux non présents dans le brief

CONTEXTE À CHARGER

Étape 1 — Détecter ou créer la semaine active

  • Déterminer YYYY-MM (mois en cours) et week-XX (numéro de semaine ISO)
  • Si le dossier outputs/YYYY-MM/week-XX/ n'existe pas, le créer
  • Ce dossier sera la cible d'écriture du weekly-brief.md

Étape 2 — Charger le contexte de la semaine (si existant)

  • Si un weekly-interview.md existe dans ce dossier (workflow 0 exécuté au préalable) : le charger comme source de signaux terrain. Le pré-brief validé remplace ou complète le brief texte libre d'Augustin.
  • Si un weekly-brief.md existe déjà dans ce dossier et n'est pas archived : le charger pour édition/correction
  • Sinon : Augustin fournit un nouveau brief (template ou texte libre)

Étape 3 — Charger la KB core (après identification du brand)

  • knowledge/shared/tone-of-voice.md
  • knowledge/shared/guardrails.md
  • knowledge/shared/personas.md

Étape 4 — Charger la KB marque (selon brand extrait du brief)

  • knowledge/{brand}/offers.md
  • knowledge/{brand}/positioning.md

Note : Charger la KB marque uniquement après avoir identifié ou validé le brand avec Augustin.

SÉQUENCE D'EXÉCUTION

  1. Demander le brief — Augustin fournit le contenu (texte libre ou en suivant le template) et les fichiers optionnels (FR1, FR2)
  2. Extraire les signaux — Parser : offre ciblée, résultats précédents, objections, contraintes (FR3)
  3. Identifier la marque — Détecter livinweb ou livinia depuis le brief (FR4)
  4. 🎯 CHALLENGER — Charger workflows/shared/challenger-block.md, exécuter la phase BRIEF. Poser 3-5 questions pointues sur la complétude des signaux, les seuils non définis, la qualité des leads, les données manquantes. L'utilisateur peut répondre ou /skip. Logger les questions et réponses dans le session-log. Alimenter les questions non adressées dans knowledge/shared/history.md section QUESTIONS CHALLENGER EN SUSPENS.
  5. Intégrer les réponses — Si l'utilisateur a répondu à des questions challenger : ajuster la synthèse si nécessaire. Si /skip : poursuivre sans modification.
  6. Valider avec Augustin — Présenter la synthèse extraite, proposer corrections/compléments (FR5)
  7. Écrire l'output — Remplir outputs/YYYY-MM/week-XX/weekly-brief.md avec frontmatter complet
  8. Générer session-log — Créer outputs/YYYY-MM/week-XX/session-log.md avec décisions, sources, audit trail, section Challenger
  9. Générer les PDFs — Exécuter node scripts/generate-pdf.js sur les deux fichiers .md pour produire les .pdf correspondants

FORMAT DE SORTIE

Utiliser la structure de templates/weekly-brief.md avec le frontmatter :

---
week: "YYYY-MM/week-XX"
brand: "livinweb | livinia"
generated_date: "YYYY-MM-DD"
workflow: "weekly-brief"
status: "draft"
brief_source: ""
---

CHECKPOINT HUMAIN

Augustin doit valider :

  • La synthèse des signaux extraits est correcte
  • La marque identifiée (livinweb | livinia) est correcte
  • Les corrections ou compléments proposés sont acceptés
  • Le brief est prêt pour le workflow 2 (Weekly Plan)