quarterly-review

Exécuter l'examen commercial trimestriel. Récupérer les données financières, commerciales et clients du trimestre, les synthétiser en un récit, et produire un document prêt pour la présentation.

Analyser les arguments :

• --quarter (défaut : trimestre calendaire précédent) — format YYYY-QN (ex. 2026-Q1)
• --save-to (défaut : files) — files (Google Drive / OneDrive), desktop, ou both

Step 1 — Financial performance

En utilisant la skill business-pulse en mode deep :

1. Récupérer le compte de résultat QuickBooks du trimestre : chiffre d'affaires, COGS, marge brute, dépenses d'exploitation, marge nette.
2. Comparer au trimestre précédent et au même trimestre l'année précédente (si disponible).
3. Récupérer les règlements PayPal pour la même période afin de valider le chiffre d'affaires QB.
4. Calculer : croissance du chiffre d'affaires en %, variation de marge en points, top 3 des catégories de chiffre d'affaires.

Step 2 — Customer health

1. Récupérer les données de deal HubSpot : nouveaux clients gagnés, clients partis, taille moyenne de deal, pipeline entrant au trimestre suivant.
2. Calculer le coût d'acquisition client (si données disponibles) et le chiffre d'affaires par client.
3. Signaler tout client représentant >20 % du chiffre d'affaires (risque de concentration).

Step 3 — Top opportunities

Identifier 3 opportunités spécifiques pour le trimestre suivant en fonction des données :

• Potentiel de chiffre d'affaires (catégorie, segment client ou canal à miser davantage)
• Potentiel de marge (coût à réduire ou prix à augmenter)
• Potentiel client (segment à cibler ou churn à réduire)

Step 4 — Top risks

Identifier 3 risques spécifiques pour le trimestre suivant :

• Risque de chiffre d'affaires (concentration, tendance, saisonnalité)
• Risque de marge (coût croissant, pression tarifaire)
• Risque opérationnel (gap pipeline, dépendance fournisseur)

Step 5 — QBR narrative

Rédiger un récit de 500–800 mots en anglais commercial clair avec cette structure :

1. Titre du trimestre (une phrase)
2. Histoire du chiffre d'affaires (tendance + raison)
3. Histoire de la marge (tendance + raison)
4. Histoire client (santé + pipeline)
5. Trois opportunités
6. Trois risques
7. Un paragraphe d'appel à l'action pour le trimestre suivant

Step 6 — Export

Générer :

1. qbr-{YYYY-QN}.pdf — récit formaté + graphiques clés (sous forme de tableaux ASCII si aucun outil de graphique disponible)
2. Enregistrer à l'emplacement --save-to

Connector failures

Si QuickBooks est inaccessible, arrêter — le QBR nécessite les données financières QB comme fondation. Si PayPal est manquant, ignorer la validation croisée et noter « PayPal not connected — revenue validated from QB only. » Si HubSpot est manquant, ignorer la santé client (Step 2) et noter « HubSpot not connected — customer health section skipped. »

Approval gates

• Ne jamais publier ou envoyer par email le QBR automatiquement. Toujours l'afficher d'abord pour examen du propriétaire.
• Signaler si une source de données retourne des données incomplètes — noter les lacunes dans le récit.

Output

Présenter le récit en ligne, puis confirmer l'export. Terminer par un résumé d'un paragraphe « ce sur quoi se concentrer le trimestre suivant ».