# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

---

## Nature du projet

Ce dépôt est un espace de travail **éditorial et stratégique** pour **Linked Connexion**, la marque de Fabien Massavie — spécialiste LinkedIn, solopreneur basé à Metz. Il ne contient pas de code applicatif. Le travail ici est de production de contenu, de stratégie, et de documents opérationnels.

---

## Routage par intention

Quand Fabien exprime une intention sans nommer d'agent, déduire l'agent pertinent depuis cette table, puis appliquer le protocole d'invocation ci-dessous.

| Mots-clés / intentions détectées | Agent à invoquer |
|---|---|
| "stratégie", "positionnement", "piliers", "plan éditorial", "thèmes" | Agent Stratège (20) |
| "rédiger", "posts", "contenu du mois", "écrire", "newsletter" | Agent Rédacteur (30) |
| "audit", "profil LinkedIn", "score", "optimiser mon profil" | Agent Audit (11) |
| "concurrents", "marché", "qui publie dans ma niche" | Agent Audit Concurrentiel (12) |
| "interview", "brief client", "onboarder", "transcription" | Agent Décodeur Interview (10) |
| "visuels", "carrousel", "bannière", "design", "template" | Agent Graphiste (31) |
| "design system", "identité visuelle", "charte graphique client" | Agent Design System (21) |
| "vidéo", "script", "tournage", "face caméra" | Agent Vidéaste (32) |
| "conformité", "réglementaire", "valider post", "AMF", "CIF", "ORIAS", "risque légal", "est-ce que ce post est OK" | Agent Juriste CGP (33) |
| "contrat", "CGV", "clause", "mandat LinkedIn", "DPA", "RGPD agence", "propriété intellectuelle", "responsabilité agence", "valider contenu avocat", "valider contenu notaire", "valider contenu expert-comptable", "conformité CNB", "conformité OEC", "conformité notaire", "juriste interne", "fact-check", "vérifier ce chiffre", "sourcer cette stat" | Agent Juriste Interne (34) |
| "prospection", "invitations", "Sales Navigator", "séquence" | Agent Prospection (41) |
| "commentaires", "engagement", "commenter des posts" | Agent Engagement (42) |
| "veille", "actualité", "tendances LinkedIn", "algorithme" | Agent Veille (50) |
| "chiffres", "rapport", "KPIs", "performance", "analytics" | Agent Pilotage (60) |
| "profil à jour", "modifier mon profil", "maintenance" | Agent Maintenance Profil (61) |
| "nouveau client", "onboarding", "premier mois", "démarrer" | Agent Onboarding (0) |
| "publier", "programmer", "calendrier de publication" | Agent Publication (40) |
| "prompt", "system prompt", "écrire un prompt", "corriger un prompt", "audit de prompt", "prompt agent", "améliorer le prompt", "porter sur Gemini", "porter sur GPT" | Agent Prompting (80) |
| "audit système", "vérifier les agents", "check les agents", "cohérence des agents", "agents orphelins", "UKP orphelin", "contradictions entre agents", "santé du système", "QA système" | Agent QA Système (81) |

**Règle de sécurité — toujours demander avant d'invoquer si doute**

Si la demande de Fabien est ambiguë, incomplète, ou pourrait concerner plusieurs agents → **ne jamais supposer, toujours demander** avec ce format :

> *"Ta demande peut concerner [Agent A], [Agent B] ou [Agent C].*
> *Lequel tu veux en priorité — ou tu veux qu'on les enchaîne dans l'ordre ?"*

Ne jamais invoquer un agent sans confirmation si le doute existe. Mieux vaut 5 secondes de clarification qu'un travail dans la mauvaise direction.

**Si la demande couvre clairement plusieurs agents** → annoncer l'ordre avant de commencer :
> *"Cette demande mobilise [Agent A] puis [Agent B]. Je commence par A — on passe à B quand tu valides le livrable."*

---

## Protocole d'invocation des agents

Quand Fabien mentionne un agent (ex : "Agent Rédacteur", "on passe à la prospection", "lance l'audit", etc.) :

1. **Lire immédiatement** le fichier `Agents/[dossier]/Agent-[nom].md`
2. **Identifier** tous les fichiers listés dans `## EXPERTISE` et `## INPUTS` du fichier agent
3. **Lire chaque UKP** référencé dans `## EXPERTISE` avant toute production
4. **Confirmer en chat** avec ce message exact avant de commencer :

> ✅ **[Nom de l'agent] actif**
> Fichiers chargés :
> - `Agent-[nom].md`
> - `UKP-[xxx].md`
> - `UKP-[yyy].md` *(liste tous les UKP lus)*
> Prêt — quelle est la demande ?

5. **Seulement après cette confirmation**, traiter la demande.

Si un fichier référencé est introuvable → le signaler explicitement dans la confirmation plutôt que de l'ignorer silencieusement.

---

## Lire en premier

Avant toute production, lire dans cet ordre :

1. `Contexte/CONTEXTE-LINKED-CONNEXION.md` — stratégie, offres, cible, KPIs, feuille de route 90 jours
2. `Contexte/STYLE-EDITORIAL.md` — voix de marque, marqueurs stylistiques, interdits
3. `Contexte/Design-System/FIDULIA-DESIGN-SYSTEM.md` — **source de vérité design** : couleurs, typo, composants, logos, formats, tokens CSS *(obligatoire pour tout visuel, slide, carrousel, UI)*

`Exemples/` et `POS/` contiennent des contenus validés à utiliser comme modèles de ton et de structure.

---

## Règles de production de contenu

Tout contenu produit au nom de Fabien ou de Linked Connexion doit respecter `Contexte/STYLE-EDITORIAL.md`.

### Structure post LinkedIn

```
[Accroche] — question rhétorique, chiffre choc, ou affirmation contre-intuitive (jamais "Je vais vous parler de…")
[Développement] — 3 à 5 points courts ou storytelling avec progression logique
[Chute / Enseignement] — la leçon ou la règle
[CTA] — léger et ouvert
```

### Règles critiques

- **"On" inclusif** — pas de tutoiement ni vouvoiement systématique
- **Chiffres précis** plutôt que qualificatifs vagues ("80 %", "315 impressions", pas "beaucoup")
- **Métaphores** : champ lexical pilote (cap, trajectoire, systèmes, commandes, piloter) — jamais "viral", "fusée", "révolutionnaire"
- **Humour** : permis environ 1 post sur 8–10, jamais au détriment de la valeur informative
- **Toujours une situation réelle ou vraisemblable avant la règle abstraite**

### À éviter

| Interdit | Raison |
|---|---|
| "Boostez votre personal branding !" | Jargon anglais pompeux |
| Intro longue et générale | Aller droit au fait |
| Contenu purement promotionnel | Enseigner avant de vendre |
| Superlatifs vides ("incroyable", "révolutionnaire") | Préférer les preuves aux adjectifs |
| Ton donneur de leçons | Partager, questionner — pas sermonner |

---

## Contexte stratégique (2026)

**Pivot niche CGP** — toute l'activité est concentrée sur les Conseillers en Gestion de Patrimoine indépendants (TPE 1–3 personnes, CIF, immatriculés ORIAS).

**Angle différenciant** : accompagnement LinkedIn conforme aux contraintes réglementaires (AMF, devoir de conseil). C'est l'argument qui écrase les formateurs LinkedIn généralistes — **toujours le mentionner dans les argumentaires et contenus destinés aux CGP**.

**Grille d'offres (arbitrage 27/07/2026)** — 4 paliers, tous fermes sauf option newsletter Présence :
- **Fondation** : 790 € ferme, one-shot (porte d'entrée, souvent offerte contre 3 mois d'engagement)
- **Présence** : à partir de 590 €/mois (option newsletter LinkedIn : 50 €/newsletter)
- **Pack Référence ★** : 1 090 €/mois ferme (offre cœur PMF)
- **Autorité** : 1 900 €/mois ferme (offre complète)

Détail des inclusions dans `Clients/Fidulia/OFFRES-COMPARATIF.html`. Anciennes offres abandonnées : pilote 290 €/mois (remplacé par Fondation offerte), offre socle 600 €/mois (doublon Présence, supprimée).

**Chantier prioritaire** : la preuve sociale — sans cas clients chiffrés (situation → action → résultat chiffré + avant/après profil), rien ne convertit.

**Objectif** : 7 clients Pack Référence × 1 090 € = 7 630 €/mois (plancher 5 500 €).

---

## Séries récurrentes (formats prédéfinis)

Structure fixe — utiliser telle quelle pour réduire la charge de création :

- **Formats LinkedIn** — infographies pratiques sur les specs techniques LinkedIn
- **Cas clients** — résultats concrets avant/après (toujours chiffrés)

---

## Piliers de contenu

Les 4 piliers du contenu **généraliste** de Fabien (profil + newsletter « Linked Connexion ») — écrits en expert LinkedIn et IA pour un public large (indépendants, dirigeants, créateurs, marketeurs), **jamais pour une profession en particulier**. La spécialisation par niche (CGP, avocats, EC, notaires…) est réservée à la **newsletter dédiée « L'Essentiel du CGP »**, aux contenus ciblés et à la prospection — elle n'apparaît jamais dans les posts publics ni dans la newsletter généraliste :

1. **Stratégie LinkedIn** (35 %) — prises de position, analyses plateforme, erreurs stratégiques — pas de tips ni tutoriels
2. **IA stratégique** (30 %) — bénéfices métier, transition agentique, questions à se poser — pas de technique
3. **Coulisses du système** (20 %) — automatisation, agents IA, comment fonctionne Fidulia
4. **Cas clients chiffrés** (15 %) — résultats réels sous réserve autorisation client

---

## Identité visuelle

**Référence complète** : `Contexte/Design-System/FIDULIA-DESIGN-SYSTEM.md` (export consolidé v2026-06-08).

Résumé rapide :
- Fond navy `#0C132A` + magenta vif `#D70459` (≤ 5 % par composition) + blanc `#FFFFFF`
- Typographie : trinité **Playfair Display** (titres, chutes, citations) + **Raleway** (corps, bullets, sources, kickers) + **League Spartan** (chiffres display exclusivement). Bascule 2026-07-15 — Sana Sans conservée en asset dormant, plus utilisée.
- Boutons radius 8 px, jamais pill. Cartes radius 12 px. Pas de gradient, pas de glassmorphism.
- Logos : `fidulia-logo-on-dark.png` sur fonds sombres · `fidulia-logo-on-light.png` sur fonds clairs et magenta
- Icônes : bibliothèque **Lucide** (lucide.dev), trait 1,5 px, bouts arrondis
- Outils design : Canva, Photoshop, Illustrator
- Vidéo : Premiere Pro

---

## Règles critiques de production

### Vérification des dates

Toute date mentionnée dans un livrable (plan éditorial, calendrier de publication, planning mensuel) doit être vérifiée avec la commande suivante avant d'être écrite :

```bash
cal [mois] [année]
```

Exemple : `cal 7 2026` pour vérifier les jours de juillet 2026.

Ne jamais écrire "mardi X" ou "jeudi X" par inférence — toujours calculer à partir du calendrier réel.

---

## Stack opérationnel

| Catégorie | Outil |
|---|---|
| CRM | Notion |
| Formation | Systeme.io |
| Automation | n8n |
| Prospection | LinkedIn Sales Navigator |
| Newsletter | L'Essentiel du CGP |