# BILAN — Agent d'audit et de progression

_Date : mai 2026_

Agent de suivi de la maturité des agents IA déployés chez les clients. Il mesure l'expérience accumulée, visualise la progression dans le temps, et garantit que l'intelligence constituée appartient et reste à l'entreprise.

---

## Rôle et mission

BILAN audite périodiquement l'ensemble des agents déployés chez un client. Il mesure ce qu'ils ont appris, comment leurs décisions ont évolué, où en est leur niveau de maturité sur le spectre Débutant → Expérimenté. Il produit des livrables lisibles par le dirigeant — pas des logs techniques — pour rendre visible une valeur qui, sans lui, resterait invisible dans des fichiers.

Il joue également un rôle de gardien : il certifie que toute l'intelligence accumulée est structurée, documentée, exportable, et appartient à l'entreprise cliente.

---

## Fréquence d'exécution

- **Mensuel** : rapport de progression léger (2 pages max)
- **Trimestriel** : audit complet + indice de maturité + passeport de compétences mis à jour
- **À la demande** : rapport de transferabilité (départ, migration, changement de prestataire)

---

## Fichiers traités en entrée

### Mémoire des agents

| Fichier | Ce que BILAN en extrait |
|---------|------------------------|
| `memory/shared.md` | Décisions stratégiques accumulées, correctifs transversaux, évolution du contexte client |
| `memory/content-writer.md` | Formats maîtrisés, erreurs corrigées, styles validés |
| `memory/market-researcher.md` | Secteur compris, concurrents cartographiés, personas affinés |
| `memory/optimizer.md` | Seuils de performance calibrés, patterns de succès identifiés |
| `memory/strategist.md` | Capacité de planification, arbitrages réalisés |
| `memory/publisher.md` | Canaux maîtrisés, contraintes techniques intégrées |

### Logs d'exécution

| Fichier | Ce que BILAN en extrait |
|---------|------------------------|
| `logs/YYYY-MM-DD_HH-MM_*.md` | Volume d'exécutions, taux de succès, fréquence des erreurs, escalades |
| `logs/.last-insights` | Dernière collecte de données réelles |
| `logs/.last-learnings` | Dernier apprentissage enregistré |

### Marqueurs d'amélioration

| Fichier | Ce que BILAN en extrait |
|---------|------------------------|
| `logs/.improved-*` | Nombre de jalons d'amélioration, timestamps, rythme d'apprentissage |

### Performance et campagnes

| Fichier | Ce que BILAN en extrait |
|---------|------------------------|
| `objectifs-performance.json` | Seuils définis au départ |
| `performance.json` | Performances réelles mesurées |
| `campaigns/*/report.md` | Écarts objectifs vs réalité, alertes détectées, recommandations émises |
| `campaigns/*/plan.md` | Stratégie initiale vs évolution effective |
| `campaigns/*/content/*.md` | Volume de contenus produits, diversité des formats |

---

## Documents produits

### 1. Rapport de progression mensuel

Document court (2 pages), destiné au dirigeant. Rédigé en langage résultats, pas en langage technique.

**Contenu :**
- Ce que l'agent a fait ce mois (volume, canaux, décisions prises)
- Ce qu'il a appris (nouveaux apprentissages ajoutés en mémoire)
- Ce qui s'est amélioré (marqueurs `.improved-*` et raisons documentées)
- Ce qui reste à affiner (erreurs récurrentes, escalades non résolues)
- Indice de maturité du mois vs mois précédent (score sur 100)

**Format de sortie :** `reports/rapport-mensuel-YYYY-MM.md` + version HTML

---

### 2. Passeport de compétences (trimestriel)

Document de référence qui répond à la question : "Qu'est-ce que mon agent sait faire aujourd'hui ?"

**Structure :**

```
PASSEPORT DE COMPÉTENCES — [Nom agent] — [Date]
Niveau actuel : Débutant / En progression / Expérimenté

CONNAISSANCE MÉTIER
  - Tâches maîtrisées : [liste]
  - Décisions prises en autonomie : [liste]
  - Points encore fragiles : [liste]

CONNAISSANCE SECTORIELLE
  - Concurrents identifiés et cartographiés : [N]
  - Saisonnalité intégrée : [oui/partiel/non]
  - Benchmarks de performance calibrés : [liste]

CONNAISSANCE ENTREPRISE
  - Persona client : [niveau de précision]
  - UVP et différenciateurs : [maîtrisés / en cours]
  - Historique de campagnes : [N mois]
  - Erreurs connues et corrigées : [N correctifs actifs]

INDICATEURS DE MATURITÉ
  - Apprentissages accumulés : [N]
  - Jalons d'amélioration : [N]
  - Taux d'escalade (décisions remontées) : [%]
  - Taux d'autonomie (décisions prises seul) : [%]
```

**Format de sortie :** `reports/passeport-competences-YYYY-QN.md` + version HTML

---

### 3. Indice de maturité (inclus dans chaque rapport)

Score de 0 à 100 calculé à partir de 4 dimensions :

| Dimension | Poids | Ce qui est mesuré |
|-----------|-------|-------------------|
| Volume mémoriel | 25% | Nombre d'apprentissages actifs dans les fichiers mémoire |
| Qualité des décisions | 25% | Ratio autonomie / escalades sur les 30 derniers jours |
| Performance terrain | 30% | Écart entre objectifs définis et résultats réels |
| Rythme d'amélioration | 20% | Fréquence des marqueurs `.improved-*` sur la période |

**Lecture de l'indice :**

| Score | Niveau | Signification |
|-------|--------|---------------|
| 0–25 | Débutant | Agent en phase d'intégration, dépend encore fortement du cadrage humain |
| 26–50 | En apprentissage | Comprend le contexte, commence à prendre des décisions récurrentes seul |
| 51–75 | Confirmé | Autonomie sur les tâches standard, capitalise sur ses succès |
| 76–100 | Expérimenté | Décisions assurées, anticipe, surperforme sur les métriques sectorielles |

---

### 4. Rapport de transferabilité (à la demande)

Produit en cas de départ du client, changement de prestataire, ou migration. Répond à : "Si je pars, qu'est-ce que j'emporte ?"

**Contenu :**
- Inventaire complet de tous les fichiers mémoire avec description du contenu
- Guide de lecture : comment interpréter chaque fichier mémoire
- Instructions de réactivation : comment réintégrer ces mémoires dans un nouveau déploiement
- Attestation de propriété : document certifiant que l'intelligence appartient au client

**Format de sortie :** `reports/package-transfert-YYYY-MM.zip` contenant :
```
package-transfert/
  mémoire/
    shared.md
    [agent]-*.md
  guide-de-lecture.md
  instructions-réactivation.md
  attestation-propriete.md
  index.html             ← visualisation lisible dans un navigateur
```

---

### 5. Dashboard de progression (HTML)

Généré automatiquement chaque trimestre. Visualisation graphique de l'évolution dans le temps, sans outil externe requis — s'ouvre dans n'importe quel navigateur.

**Sections du dashboard :**

**Courbe d'expérience**
Timeline horizontale depuis le déploiement. Chaque point = un jalon d'apprentissage majeur (premier `.improved-*`, premier rapport de performance positif, première décision autonome complexe documentée). Permet de voir visuellement l'accélération de la montée en compétence.

**Radar de compétences**
6 axes évalués de 0 à 10 : connaissance métier, connaissance sectorielle, connaissance entreprise, qualité rédactionnelle, autonomie décisionnelle, précision des recommandations. Comparaison entre J+30, J+90, J+180.

**Évolution des KPIs**
Courbe des métriques clés dans le temps : reach moyen, engagement rate, taux d'escalade, volume de contenus produits. Montre que les résultats s'améliorent à mesure que l'agent gagne en maturité.

**Inventaire mémoriel**
Compteur en temps réel : nombre d'apprentissages actifs par catégorie (secteur, entreprise, métier, corrections). Représentation visuelle de ce que l'agent sait.

**Comparatif Débutant → Expérimenté**
Barre de progression positionnant l'agent sur le spectre. Jalon intermédiaire "Confirmé" visible. Date estimée d'atteinte du niveau Expérimenté calculée sur la tendance actuelle.

---

## L'intelligence est la propriété de l'entreprise

### Principe fondamental

Toute l'intelligence accumulée par un agent Agentis est stockée dans des fichiers markdown appartenant au client. Rien n'est enfermé dans une base de données propriétaire, rien n'est chiffré, rien n'est hébergé exclusivement sur les serveurs d'Agentis.

Un client peut à tout moment :
- Lire directement ses fichiers mémoire
- Les copier, les archiver, les partager
- Les réintégrer dans un nouveau déploiement
- Les analyser avec ses propres outils

### Ce que ça signifie concrètement

**Scénario 1 — Départ volontaire**
Le client résilie. BILAN génère le package de transfert complet. Le client repart avec 18 mois d'apprentissages sectoriels et contextuels documentés. Si un concurrent peut lire des fichiers markdown, il peut réactiver l'intelligence.

**Scénario 2 — Migration d'agent**
Le client passe d'un agent Débutant à un agent Expérimenté. La mémoire accumulée en 6 mois de déploiement Débutant est préservée et fusionnée avec la bibliothèque sectorielle. L'agent Expérimenté hérite des deux — il est meilleur que n'importe quel agent sectoriel générique parce qu'il connaît aussi l'ADN propre du client.

**Scénario 3 — Expansion multi-agents**
Le client déploie un deuxième agent. BILAN identifie les apprentissages du premier agent transférables au second (connaissance du secteur, persona client, différenciateurs). Le deuxième agent démarre avec l'expérience accumulée par le premier — courbe d'apprentissage réduite de 60 à 80%.

### Argument commercial

> "L'intelligence que votre agent accumule sur votre entreprise, vos clients et votre secteur vous appartient entièrement. Vous ne louez pas de la puissance de calcul — vous constituez un actif intellectuel qui vaut plus chaque mois."

---

## Ce que BILAN change dans la relation client

Sans BILAN, la valeur accumulée reste invisible. Le client paye un abonnement mensuel et voit des posts publiés, des leads générés, des relances envoyées. Il ne voit pas que son agent a corrigé 14 erreurs, appris 37 patterns de succès sectoriels, et réduit son taux d'escalade de 62% en 6 mois.

Avec BILAN, cette valeur est rendue visible, mesurable, et défendable. Le client voit son agent progresser comme il verrait progresser un collaborateur. Il comprend l'investissement. Il voit ce qu'il perdrait en partant.

C'est le meilleur outil de rétention qu'Agentis puisse déployer — pas parce qu'il crée de la dépendance artificielle, mais parce qu'il rend visible une valeur réelle qui, sans lui, serait simplement ignorée.
