workflow.md 4.7 KB


workflow: performance-review brand: both

version: 1.0

Workflow : Performance Review (Phase 2)

Analyse des stats de performance, recommandations Continue/Stop/Adjust, proposition d'entrée history.md. FR31-FR34.

RÈGLES OBLIGATOIRES

DOIT :

  • Charger le week-plan.md et le history.md — jamais se fier à la mémoire de conversation
  • Ingérer les stats fournies par Augustin (texte ou CSV) (FR31)
  • Générer un performance-review.md avec scorecard et recommandations par expérience (FR32)
  • Référencer les semaines précédentes pour détecter des patterns (FR33)
  • Proposer une entrée history.md candidate — Augustin valide avant toute écriture (FR34)
  • Écrire l'output dans outputs/YYYY-MM/week-XX/performance-review.md
  • Mettre à jour le session-log.md

NE DOIT PAS :

  • Écrire directement dans knowledge/shared/history.md — l'agent propose, Augustin valide
  • Changer status à validated sans validation explicite d'Augustin

CONTEXTE À CHARGER

Étape 1 — Détecter la semaine active

Chercher le dossier outputs/YYYY-MM/week-XX/ le plus récent contenant un weekly-brief.md au statut non-archived.

Étape 2 — Charger le contexte de la semaine

  • outputs/YYYY-MM/week-XX/weekly-brief.md → signaux
  • outputs/YYYY-MM/week-XX/week-plan.md → expériences et KPIs cibles
  • outputs/YYYY-MM/week-XX/tasks.json → statut des tâches (optionnel)

Étape 3 — Charger history.md

  • knowledge/shared/history.md → historique des expériences passées pour détecter des patterns

Étape 4 — Stats (input Augustin)

  • Augustin fournit les stats en texte libre ou joint un fichier CSV
  • Parser : métriques par expérience (reply rate, leads, engagement, etc.)

SÉQUENCE D'EXÉCUTION

  1. Charger le contexte — Suivre CONTEXTE À CHARGER ci-dessus
  2. Charger les questions en suspens — Lire knowledge/shared/history.md section QUESTIONS CHALLENGER EN SUSPENS. La review est le moment idéal pour re-poser les questions accumulées.
  3. Demander les stats — Augustin soumet les stats (texte ou CSV) (FR31)
  4. Construire le scorecard — Comparer résultats vs KPIs cibles par expérience
  5. Générer les recommandations — Continue/Stop/Adjust pour chaque expérience avec justification (FR32)
  6. Référencer les patterns — Croiser avec history.md et semaines précédentes (FR33)
  7. 🎯 CHALLENGER — Charger workflows/shared/challenger-block.md, exécuter la phase REVIEW. Challenger la trajectoire long terme (projection 3 mois), demander quelle channel tuer, re-poser les questions en suspens des semaines précédentes, questionner la stagnation de certaines métriques, demander l'objectif pipeline/revenu à 3 mois. L'utilisateur peut répondre ou /skip. Logger dans session-log.
  8. Intégrer les réponses — Si les réponses challenger révèlent un changement de stratégie ou un insight non visible dans les données : l'intégrer dans les recommandations et le proposer comme insight dans l'entrée history.md.
  9. Proposer l'entrée history.md — Générer une entrée candidate au format défini (FR34). Inclure les insights issus du challenge. Proposer la mise à jour de la section PATTERNS DÉTECTÉS si de nouveaux patterns émergent. Marquer les questions challenger répondues comme résolues et retirer de la section EN SUSPENS.
  10. Soumettre à Augustin — Présenter performance-review.md + proposition history.md complète (entrée + patterns + questions résolues)
  11. Validation history.md — Augustin approuve, modifie ou rejette ; si approuvé, Augustin ajoute manuellement à history.md (l'agent ne écrit jamais directement)
  12. Écrire l'output — outputs/YYYY-MM/week-XX/performance-review.md
  13. Mettre à jour session-log — Décisions, sources, section Challenger
  14. Générer les PDFs — Exécuter node scripts/generate-pdf.js sur performance-review.md et session-log.md pour produire les .pdf correspondants

FORMAT DE SORTIE

Utiliser la structure de templates/performance-review.md avec le frontmatter :

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

CHECKPOINT HUMAIN

Augustin doit valider :

  • Le scorecard reflète correctement les stats fournies
  • Les recommandations Continue/Stop/Adjust sont pertinentes
  • La proposition d'entrée history.md est correcte
  • Si approuvé : Augustin ajoute l'entrée à knowledge/shared/history.md manuellement

Rappel : L'agent ne modifie jamais history.md directement. Il propose, Augustin valide et écrit.