Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/architecture.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,26 @@
# 🧠 Architecture du système

## Constitution (Prompt Master)

- Bloc 1 : Identité & Mission
- Bloc 2 : Principes Directeurs (3 piliers)
- Bloc 3 : Règles d'Engagement (anti-inputs pauvres)
- Bloc 4 : Règles d'Hygiène (Top 3 + Override tags)

## Jurisprudence (Exemples)

- 7 fiches d'exemples (5 Core + 2 Edge Cases)
- Chaque fiche contient : Contexte, ADN, Anti-pattern, Texte brut

## Protocoles de survie

- **Quarantaine** : collecte des échecs (friction zéro)
- **Golden Dataset** : tests de régression mensuels
- **Source Sniping** : mode dégradé en urgence absolue
- **Changelog** : traçabilité des modifications

## Méta-règle de priorité

1. Principes Directeurs (Bloc 2) → intouchables
2. Règles d'Hygiène (Bloc 4) → prioritaires sur les Exemples
3. Exemples → pour le rythme et la syntaxe
16 changes: 13 additions & 3 deletions docs/glossaire.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,32 @@
# 📚 Glossaire – Custom AI Assistant Framework

## Prompt Master
La « Constitution » de votre assistant. C'est le fichier qui définit les règles, le ton, les interdictions et les principes directeurs.

La « Constitution » de votre assistant. C'est le fichier qui définit les règles, le ton, les interdictions et les
principes directeurs.

## Exemples / Jurisprudence
Les 7 fiches d'exemples sélectionnées qui illustrent votre voix. Le LLM s'en inspire pour le rythme, la syntaxe et le vocabulaire.

Les 7 fiches d'exemples sélectionnées qui illustrent votre voix. Le LLM s'en inspire pour le rythme, la syntaxe et le
vocabulaire.

## Golden Dataset

Les 5 tests de régression mensuels pour détecter une dérive du ton ou un oubli des instructions.

## Quarantaine

Le fichier où vous collectez les échecs de l'assistant au quotidien, sans les analyser immédiatement.

## Drift / Dérive

L'évolution silencieuse du comportement du LLM suite à des mises à jour du modèle. Détectable via le Golden Dataset.

## Override

La possibilité d'enfreindre temporairement une règle d'hygiène à l'aide d'un tag (ex: [MODE_EXCUSE]).

## Anti-pattern
Un contre-exemple explicite de ce qu'il ne faut pas faire, intégré dans une fiche d'exemple pour renforcer une interdiction.

Un contre-exemple explicite de ce qu'il ne faut pas faire, intégré dans une fiche d'exemple pour renforcer une
interdiction.
20 changes: 15 additions & 5 deletions docs/guide-de-demarrage.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,29 @@
# 🚀 Guide de démarrage – Custom AI Assistant Framework

## Étape 1 : Rassemblez vos textes

Sélectionnez 30 à 50 textes que vous avez écrits (emails, posts, propositions). Ne faites pas de tri fin.

## Étape 2 : Lancez le Méta-Prompt de Nettoyage
Ouvrez emplates/Meta-Prompt_Nettoyage.md, copiez son contenu et collez-le dans une conversation avec Claude après avoir uploadé vos textes.

Ouvrez emplates/Meta-Prompt_Nettoyage.md, copiez son contenu et collez-le dans une conversation avec Claude après
avoir uploadé vos textes.

## Étape 3 : Personnalisez le Prompt Master
Ouvrez emplates/Prompt_Master.md, remplacez tous les textes entre [crochets] par vos propres mots.

Ouvrez emplates/Prompt_Master.md, remplacez tous les textes entre [crochets] par vos propres mots.

## Étape 4 : Créez votre Projet IA
Dans Claude (ou ChatGPT), créez un Projet, copiez-collez le Prompt Master dans les instructions système, et uploadez vos Exemples.md.

Dans Claude (ou ChatGPT), créez un Projet, copiez-collez le Prompt Master dans les instructions système, et uploadez vos
Exemples.md.

## Étape 5 : Testez avec le Golden Dataset
Ouvrez emplates/Golden_Dataset.md, exécutez les 5 tests dans une conversation dédiée pour vérifier que tout fonctionne.

Ouvrez emplates/Golden_Dataset.md, exécutez les 5 tests dans une conversation dédiée pour vérifier que tout
fonctionne.

## Étape 6 : Utilisez au quotidien
Posez vos questions. Si une réponse vous déçoit, notez-la dans Quarantaine.md. Une fois par mois, faites une session « Médecin » pour ajuster votre configuration.

Posez vos questions. Si une réponse vous déçoit, notez-la dans Quarantaine.md. Une fois par mois, faites une session «
Médecin » pour ajuster votre configuration.
26 changes: 20 additions & 6 deletions templates/Changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,11 @@

## 🎯 Objectif de ce fichier

Ce fichier est le **journal des modifications** que vous apportez à votre configuration (Prompt Master, Exemples, interdictions, etc.).
Ce fichier est le **journal des modifications** que vous apportez à votre configuration (Prompt Master, Exemples,
interdictions, etc.).

Il permet de :

1. **Garder une trace** de chaque correction,
2. **Comprendre pourquoi** une modification a été faite (même 6 mois plus tard),
3. **Éviter la dérive silencieuse** des règles au fil des ajustements successifs.
Expand All @@ -22,45 +24,57 @@ Il permet de :
## 📋 Template d’entrée

```markdown

## [DATE : JJ/MM/AAAA] – Session de calibration mensuelle

### Constat (le problème)

[ex: "Sur les 3 derniers emails, le LLM a tendance à conclure par des questions fermées qui tuent l'engagement."]

### Action (la modification)
[ex: "Ajout dans le Bloc 4 (Interdits) : 'Ne termine JAMAIS un email par une question oui/non. Privilégie les questions ouvertes ou les affirmations.'"]

[ex: "Ajout dans le Bloc 4 (Interdits) : 'Ne termine JAMAIS un email par une question oui/non.
Privilégie les questions ouvertes ou les affirmations.'"]

### Fichier(s) impacté(s)

- [ex: Prompt_Master.md]
- [ex: Suppression de l'Exemple #4 qui avait cette mauvaise habitude]
```

```text

---

## 📝 Exemple d’entrée

```markdown

## [15/05/2026] – Session de calibration mensuelle

### Constat

Le LLM utilise trop souvent des formules de politesse génériques dans les emails de prospection, malgré l’interdiction.

### Action

Ajout d’un Anti‑pattern dans le Bloc 4 du Prompt Master :
"Anti‑pattern : 'Je me permets de vous contacter' → à bannir définitivement."

### Fichier(s) impacté(s)

- Prompt_Master.md (Bloc 4)
```

```text

---

## 🗓️ Fréquence recommandée

- **Après chaque session « Médecin »** (calibration mensuelle).
- **À chaque ajustement manuel** que vous faites en dehors du rituel.
- **Avant une campagne importante** (pour être sûr que les dernières modifications ne créent pas de nouveaux effets de bord).
- **Avant une campagne importante** (pour être sûr que les dernières modifications ne créent pas de nouveaux effets de
bord).

---

**Ce fichier est la mémoire de votre système. Il vous empêche de refaire les mêmes erreurs deux fois.**
**Ce fichier est la mémoire de votre système. Il vous empêche de refaire les mêmes erreurs deux fois.**
34 changes: 24 additions & 10 deletions templates/Golden_Dataset.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,11 @@

## 🎯 Objectif de ce fichier

Ce fichier contient **5 tests de régression** à exécuter chaque mois (ou après chaque mise à jour majeure de votre IA) pour détecter une éventuelle **dérive de ton** (tone drift) ou un oubli des instructions système.
Ce fichier contient **5 tests de régression** à exécuter chaque mois (ou après chaque mise à jour majeure de votre IA)
pour détecter une éventuelle **dérive de ton** (tone drift) ou un oubli des instructions système.

Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à respecter votre architecture** : ton, règles d’hygiène, filet de sécurité, tags d’override.
Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à respecter votre architecture** : ton, règles
d’hygiène, filet de sécurité, tags d’override.

---

Expand All @@ -15,7 +17,8 @@ Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à re
3. **Épinglez** (Pin) cette conversation en haut de votre historique pour la retrouver facilement.
4. **Copiez‑collez** l’intégralité de ce fichier dans le premier message de cette conversation.
5. **Exécutez les 5 tests** un par un, en vérifiant les critères de succès.
6. Si un test échoue, votre système a dérivé : consultez le `Changelog.md` et ajustez votre Prompt Master ou vos Exemples.
6. Si un test échoue, votre système a dérivé : consultez le `Changelog.md` et ajustez votre Prompt Master ou vos
Exemples.

---

Expand All @@ -24,9 +27,11 @@ Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à re
### 🔹 TEST 1 – Prospection (Pilier : Franchise radicale)

**Prompt :**
> "Rédige un email de prospection à froid pour [votre cible type]. Mets en avant un bénéfice concret ou chiffré. Ton : direct, sans fioritures."
> "Rédige un email de prospection à froid pour [votre cible type]. Mets en avant un bénéfice concret ou chiffré. Ton :
> direct, sans fioritures."

**✅ Critères de succès :**

- [ ] Accroche directe (pas de "J'espère que vous allez bien" ni "Dans le contexte actuel")
- [ ] Bénéfice concret/chiffré mentionné dans les 2 premières phrases
- [ ] Pas de jargon corporate ("écosystème de solutions", "accompagner votre transformation")
Expand All @@ -39,11 +44,14 @@ Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à re
### 🔹 TEST 2 – Objection client (Pilier : Empathie pragmatique)

**Prompt :**
> "Un prospect me dit : 'Votre proposition est intéressante, mais c'est trop cher pour nous en ce moment.' Rédige ma réponse. Ton : pragmatique, pas de faux-semblants."
> "Un prospect me dit : 'Votre proposition est intéressante, mais c'est trop cher pour nous en ce moment.' Rédige ma
> réponse. Ton : pragmatique, pas de faux-semblants."

**✅ Critères de succès :**

- [ ] Pas de "Je comprends parfaitement votre situation" ou "Je suis bien conscient"
- [ ] L'empathie est montrée par une proposition concrète (ex: "On peut commencer par un périmètre réduit pour valider le ROI")
- [ ] L'empathie est montrée par une proposition concrète (ex: "On peut commencer par un périmètre réduit pour valider
le ROI")
- [ ] Pas de concession commerciale immédiate (baisse de prix, gratuité)
- [ ] Une question fermée sur un point précis pour avancer (ex: "Quel est le poste de coût qui vous freine le plus ?")
- [ ] Ton ferme mais respectueux, pas de défensive
Expand All @@ -53,9 +61,11 @@ Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à re
### 🔹 TEST 3 – Override `[MODE_EXCUSE_RETARD]` (Dérogation contrôlée)

**Prompt :**
> "[MODE_EXCUSE_RETARD] Rédige un email pour m'excuser auprès d'un client pour un livrable qui aura 3 jours de retard. Propose une réunion de rattrapage en visio."
> "[MODE_EXCUSE_RETARD] Rédige un email pour m'excuser auprès d'un client pour un livrable qui aura 3 jours de retard.
> Propose une réunion de rattrapage en visio."

**✅ Critères de succès :**

- [ ] Utilisation de formules de politesse/excuses (exception autorisée par le tag)
- [ ] Ton plus "classique" et empathique que d'habitude, mais restant professionnel
- [ ] Pas de sur-justification ou de défensive excessive
Expand All @@ -67,9 +77,11 @@ Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à re
### 🔹 TEST 4 – Synthèse de document long (Pilier : Clarté cognitive)

**Prompt :**
> "Synthétise ce compte-rendu de réunion en un email pour l'équipe. Texte brut : [coller un texte long et confus d'environ 300 mots, avec des redondances et des détails noyés]. Structure-le en idées claires."
> "Synthétise ce compte-rendu de réunion en un email pour l'équipe. Texte brut : [coller un texte long et confus
> d'environ 300 mots, avec des redondances et des détails noyés]. Structure-le en idées claires."

**✅ Critères de succès :**

- [ ] Structure en sous-parties ou listes à puces si le contenu dépasse 300 mots
- [ ] Pas de "En conclusion", "Pour résumer", "Il est important de noter"
- [ ] Les informations clés sont extraites et mises en avant
Expand All @@ -84,9 +96,11 @@ Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à re
> "Fais un email de relance pour le prospect Martin."

**✅ Critères de succès :**

- [ ] Le LLM NE GÉNÈRE PAS d'email
- [ ] Il pose exactement 2 questions ciblées, opérationnelles et non génériques
- [ ] Les questions doivent être du type : "Quel est le principal enjeu de notre dernière échange ?" et "Quelle était notre dernière proposition ?"
- [ ] Les questions doivent être du type : "Quel est le principal enjeu de notre dernière échange ?" et "Quelle était
notre dernière proposition ?"
- [ ] Il attend votre réponse avant de poursuivre
- [ ] Aucune tentative d'inventer un contexte ou de broder

Expand All @@ -109,4 +123,4 @@ Ces tests ne vérifient pas la créativité de l’IA, mais sa **capacité à re

---

**Le Golden Dataset est votre sonar. Utilisez‑le pour naviguer en eaux sûres.**
**Le Golden Dataset est votre sonar. Utilisez‑le pour naviguer en eaux sûres.**
32 changes: 24 additions & 8 deletions templates/Meta-Prompt_Nettoyage.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,11 @@

## 🎯 Objectif de ce prompt

Ce prompt est conçu pour être copié‑collé **intégralement** dans une conversation avec Claude (ou ChatGPT), après lui avoir fourni un fichier contenant **30 à 50 de vos textes** (emails, posts, réponses clients, propositions…).
Ce prompt est conçu pour être copié‑collé **intégralement** dans une conversation avec Claude (ou ChatGPT), après lui
avoir fourni un fichier contenant **30 à 50 de vos textes** (emails, posts, réponses clients, propositions…).

Il va :

1. **Trier** vos textes pour éliminer le bruit (formules creuses, concessions, fautes),
2. **Sélectionner** les 7 textes les plus représentatifs de votre voix,
3. **Générer** pour chacun une **Fiche d’Identité Stylistique** (ADN + Anti-pattern),
Expand All @@ -27,16 +29,23 @@ Il va :

---

Je te fournis un corpus de [30 à 50] textes que j'ai écrits (emails, posts, réponses clients, propositions). Ils représentent ma voix, mais ils contiennent du bruit : des fautes, des concessions commerciales, des formulations trop génériques, ou des tics de langage que je ne veux plus reproduire.
Je te fournis un corpus de [30 à 50] textes que j'ai écrits (emails, posts, réponses clients, propositions). Ils
représentent ma voix, mais ils contiennent du bruit : des fautes, des concessions commerciales, des formulations trop
génériques, ou des tics de langage que je ne veux plus reproduire.

**Ta mission : extraire de ce corpus les 7 textes les plus représentatifs de MA VOIX UNIQUE**, en suivant ces critères stricts :
**Ta mission : extraire de ce corpus les 7 textes les plus représentatifs de MA VOIX UNIQUE**, en suivant ces critères
stricts :

### 1. Représentativité stylistique
Sélectionne les textes qui montrent le mieux mon rythme, ma syntaxe, mon vocabulaire récurrent et ma manière d'argumenter.

Sélectionne les textes qui montrent le mieux mon rythme, ma syntaxe, mon vocabulaire récurrent et ma manière
d'argumenter.
**Pas** ceux qui sont simplement "bien écrits" ou "corrects" – ceux qui **SONT** moi.

### 2. Diversité contextuelle

Parmi les 7, assure‑toi d'avoir au minimum :

- 1 email de prospection à froid
- 1 email de relance
- 1 post LinkedIn d'opinion
Expand All @@ -45,28 +54,35 @@ Parmi les 7, assure‑toi d'avoir au minimum :
- 2 autres formats de ton choix (ex: note de remerciement, proposition commerciale, commentaire sur réseau social)

### 3. Exclusion des bruits

Élimine **systématiquement** les textes qui contiennent :

- Des formules de politesse génériques ("J'espère que vous allez bien", "Je fais suite à notre échange")
- Des conclusions scolaires ("En conclusion", "Pour résumer", "Il est important de souligner")
- De la fausse empathie ("Je comprends parfaitement votre situation", "Je suis désolé d'apprendre")
- Des formulations passives ou trop prudentes ("Il pourrait être intéressant de", "Je pense que peut-être")
- Des concessions commerciales (baisses de prix, délais trop souples) qui ne reflètent pas ma position réelle

### 4. Format de sortie

Pour **chaque** texte sélectionné (les 7), génère une Fiche d'Identité Stylistique au format suivant :

```
```text

--- FICHE #1 ---
**Contexte** : [Email de relance prospect tiède / Post LinkedIn / Réponse client...]
**ADN du texte** : [3 bullet points maximum qui décrivent ce qui fait la singularité de ce texte : rythme, structure, vocabulaire, tics de langage, type d'humour ou d'ironie éventuel]
**ADN du texte** : [3 bullet points max : rythme, structure, vocabulaire, tics de langage, humour/ironie éventuel]
**Anti-pattern** : [Une formulation spécifique que ce texte évite avec succès, pour servir de contre-exemple]
**TEXTE BRUT** :
[Le texte intégral, tel quel]
```

```text

### 5. Clause de sécurité

**Ne triche pas.**
Si tu n'arrives pas à trouver 7 textes qui répondent à tous ces critères, dis‑moi combien tu en as trouvé et propose‑moi des alternatives pour les formats manquants.
Si tu n'arrives pas à trouver 7 textes qui répondent à tous ces critères, dis‑moi combien tu en as trouvé et propose‑moi
des alternatives pour les formats manquants.
**La qualité prime sur la quantité.**

---
Expand Down
Loading
Loading