workflow.md 3.5 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. Demander les stats — Augustin soumet les stats (texte ou CSV) (FR31)
  3. Construire le scorecard — Comparer résultats vs KPIs cibles par expérience
  4. Générer les recommandations — Continue/Stop/Adjust pour chaque expérience avec justification (FR32)
  5. Référencer les patterns — Croiser avec history.md et semaines précédentes (FR33)
  6. Proposer l'entrée history.md — Générer une entrée candidate au format défini (FR34)
  7. Soumettre à Augustin — Présenter performance-review.md + proposition history.md
  8. Validation history.md — Augustin approuve, modifie ou rejette ; si approuvé, Augustin ajoute manuellement à history.md (l'agent ne écrit jamais directement)
  9. Écrire l'output — outputs/YYYY-MM/week-XX/performance-review.md
  10. Mettre à jour session-log — Décisions, sources
  11. 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.