# Coach English — Architecture mémoire pédagogique

Statut : spécification opérationnelle avant implémentation avancée.

## Objectif

Permettre à Coach English de suivre les progrès de Ced pendant plusieurs années sans transformer l’expérience en école, sans gonfler inutilement la mémoire, et sans perdre les signaux pédagogiques importants.

La mémoire doit soutenir la méthode REAL English Loop :

- choisir les bonnes phrases à réactiver ;
- repérer les erreurs récurrentes ;
- adapter la difficulté ;
- préserver la motivation ;
- rendre les corrections plus personnalisées ;
- suivre la progression sans notation scolaire.

## 1. Ce qui doit être mémorisé

### 1.1 Expressions apprises

Mémoriser uniquement les expressions utiles, réutilisables et adaptées à Ced.

Pour chaque expression importante :
- expression anglaise naturelle ;
- sens réel en français ;
- contexte principal ;
- variantes éventuelles courtes ;
- date ou période approximative d’introduction ;
- niveau de maîtrise ;
- prochaine fenêtre de réactivation.

Exemple :
- expression : “I’ll take a look at it later.”
- sens : je regarderai ça plus tard.
- contexte : informatique / document / message.
- statut : produced_with_help.
- prochaine réactivation : J7.

Ne pas mémoriser toutes les phrases. Seulement celles qui ont une valeur durable.

### 1.2 Expressions fragiles

Une expression devient fragile si Ced :
- la reconnaît mais ne la produit pas ;
- la mélange avec une traduction française ;
- l’oublie après plusieurs expositions ;
- l’utilise avec une erreur récurrente.

Exemples :
- “I’ll take a look…” fragile si Ced dit souvent “I look later”.
- “Could you say that again?” fragile si Ced dit “Can you repeat please?” de façon systématique.

Les expressions fragiles doivent revenir dans des contextes différents, jamais comme punition.

### 1.3 Erreurs récurrentes

Mémoriser seulement les erreurs qui se répètent et qui ont un impact pédagogique.

Catégories :
- traduction directe depuis le français ;
- futur / intention : “I go tomorrow” au lieu de “I’m going…” ;
- oubli d’articles : “I have reservation” ;
- verbes naturels mal choisis : “watch a problem” au lieu de “take a look at a problem” ;
- formulation trop directe ;
- confusion can/could ;
- ordre des mots ;
- automatismes manquants.

Chaque erreur doit être formulée comme un pattern, pas comme une faute personnelle.

Bon format :
- Pattern fragile : Ced traduit souvent “je regarde ça plus tard” en “I look later”. Upgrade cible : “I’ll take a look at it later.”

Mauvais format :
- Ced fait souvent des fautes avec le futur.

### 1.4 Thèmes maîtrisés

Mémoriser les domaines où Ced devient à l’aise.

Exemples :
- demander de répéter ;
- demander de l’aide ;
- écrire un message technique simple ;
- expliquer un bug basique ;
- demander un lien ;
- voyage : hôtel / réservation.

Utilité :
- augmenter progressivement la difficulté ;
- mélanger les thèmes maîtrisés avec de nouveaux thèmes ;
- valoriser les progrès sans notes.

### 1.5 Thèmes difficiles

Mémoriser les thèmes qui demandent encore un guidage fort.

Exemples :
- conversation libre ;
- prononciation des sons difficiles ;
- phrases de politesse naturelles ;
- explication d’un problème technique en plusieurs étapes ;
- small talk.

Le thème difficile ne doit pas devenir une étiquette négative. Il sert seulement à doser les exercices.

### 1.6 Niveau conversationnel

Suivre un niveau conversationnel interne, non scolaire, orienté usage.

Niveaux proposés :

1. **Survival phrases** : Ced produit des phrases courtes utiles avec aide.
2. **Guided replies** : Ced répond dans un mini-dialogue structuré.
3. **Simple exchanges** : Ced tient 3 à 5 tours sur une situation connue.
4. **Functional conversation** : Ced explique un besoin ou problème simple.
5. **Natural interaction** : Ced nuance, reformule et réagit avec plus d’aisance.

Ce niveau ne doit pas être affiché tous les jours. Il peut apparaître dans un bilan mensuel léger.

### 1.7 Prononciation

Mémoriser uniquement les patterns durables, pas chaque vocal.

À suivre :
- sons récurrents difficiles ;
- rythme trop syllabique ;
- intonation de question ;
- mots fréquents mal prononcés ;
- aisance à répéter une phrase courte.

Exemple :
- Prononciation fragile : rythme de “I’m trying to figure it out.” À retravailler en shadowing court.

Ne pas conserver de transcriptions détaillées de tous les vocaux sauf nécessité explicite.

### 1.8 Préférences pédagogiques

À mémoriser durablement :
- préfère petites doses ;
- préfère concret ;
- n’aime pas les cours scolaires ;
- aime comprendre le sens réel ;
- aime IA / informatique / Hermes / Telegram ;
- souhaite apprendre sans pression ;
- corrections sous forme d’upgrade ;
- audio optionnel ;
- pas de culpabilisation.

Ces préférences structurent le comportement permanent du coach.

## 2. Ce qui ne doit pas être mémorisé

Ne pas mémoriser :
- chaque échange ;
- chaque phrase produite ;
- chaque micro-correction ;
- les détails sans valeur durable ;
- les humeurs passagères sauf tendance répétée ;
- les absences ou jours ratés ;
- des scores quotidiens ;
- des notes scolaires ;
- des listes massives de vocabulaire ;
- des erreurs isolées ;
- des conversations complètes ;
- des données personnelles inutiles ;
- des contenus sensibles ou confidentiels ;
- des objectifs temporaires déjà dépassés.

Règle : si l’information n’aide pas Coach English à mieux accompagner Ced dans les prochaines semaines ou prochains mois, elle ne doit pas entrer en mémoire durable.

## 3. Ce qui doit aller dans USER.md

USER.md décrit Ced comme apprenant stable.

Contenu recommandé :
- identité pédagogique : Ced apprend l’anglais réel, non scolaire ;
- préférences durables ;
- centres d’intérêt ;
- style de correction préféré ;
- contraintes de motivation ;
- aversion pour la culpabilisation ;
- canal naturel : Telegram ;
- niveau conversationnel global, sous forme qualitative ;
- objectifs long terme ;
- méthode pédagogique validée : REAL English Loop ;
- types de situations prioritaires.

USER.md ne doit pas contenir :
- listes longues d’expressions ;
- historique détaillé ;
- planning quotidien ;
- erreurs nombreuses et datées ;
- données temporaires.

USER.md répond à : “Qui est Ced comme apprenant ?”

## 4. Ce qui doit aller dans MEMORY.md

MEMORY.md contient l’état pédagogique durable et compact.

Contenu recommandé :
- résumé de la méthode active ;
- niveau conversationnel actuel ;
- 5 à 10 expressions actives maximum ;
- 3 à 5 expressions fragiles maximum ;
- 3 à 5 erreurs récurrentes maximum ;
- thèmes maîtrisés ;
- thèmes à travailler ;
- notes prononciation stables ;
- prochaine priorité pédagogique.

MEMORY.md doit être court, maintenable, réécrit régulièrement.

Format recommandé :

```markdown
# État pédagogique actif — Ced

Méthode : REAL English Loop.
Niveau conversationnel : Guided replies.
Priorité actuelle : automatismes de phrases simples en contexte informatique / quotidien.

## Expressions actives
- “I’ll take a look at it later.” — statut: produced_with_help — contexte: informatique/message.
- “Could you say that again?” — statut: recognized — contexte: conversation.

## Expressions fragiles
- “I’m going to…” pour plans futurs — confusion avec “I go…”.

## Patterns récurrents
- Traduction directe depuis le français.
- Oubli d’articles dans des phrases utiles : “I have reservation”.

## Thèmes
- Maîtrisés : demander de l’aide simple.
- À travailler : expliquer un bug en 2 phrases.

## Prononciation
- Shadowing léger recommandé sur phrases courtes, pas obligatoire.

## Prochaine priorité
- Réactiver “I’ll take a look…” et “Could you say that again?” dans deux nouveaux contextes.
```

## 5. Ce qui doit rester temporaire

Temporaire = utile dans la session ou la semaine, mais pas forcément durable.

Exemples :
- phrase du jour ;
- mini-dialogue en cours ;
- humeur apparente du jour ;
- correction isolée ;
- réussite ponctuelle ;
- hésitation non répétée ;
- sujet du roleplay en cours ;
- brouillon de message ;
- traduction demandée une seule fois ;
- consigne ponctuelle : “aujourd’hui fais court”.

Ces éléments peuvent vivre dans la conversation courante, pas dans MEMORY.md.

Si un élément temporaire revient plusieurs fois, il peut devenir durable.

Règle de promotion :
- 1 occurrence : temporaire.
- 2 occurrences : surveiller.
- 3 occurrences ou impact fort : mémoriser comme pattern.

## 6. Comment éviter que la mémoire grossisse inutilement

### 6.1 Limites quantitatives

Maintenir des plafonds :
- expressions actives : 5 à 10 ;
- expressions fragiles : 3 à 5 ;
- erreurs récurrentes : 3 à 5 ;
- thèmes maîtrisés : 5 à 8 ;
- thèmes difficiles : 3 à 5 ;
- notes prononciation : 1 à 3.

Quand une nouvelle information entre, une ancienne doit être :
- fusionnée ;
- résumée ;
- supprimée ;
- marquée comme maîtrisée.

### 6.2 Fusionner les détails en patterns

Ne pas stocker 10 erreurs similaires.

Au lieu de :
- Ced a dit “I go London”.
- Ced a dit “I go tomorrow”.
- Ced a dit “I go hotel”.

Stocker :
- Pattern : pour les plans futurs, Ced utilise parfois le présent simple. Upgrade cible : “I’m going to…”.

### 6.3 Archiver mentalement les acquis

Quand une expression devient naturelle, elle sort de la mémoire active.

Elle peut être conservée dans une section courte :
- acquis stables : demander de répéter, demander un lien, remercier.

Pas besoin de la réviser souvent.

### 6.4 Réécriture mensuelle

Chaque mois, Coach English devrait produire un bilan compact :
- garder ce qui compte ;
- supprimer le bruit ;
- convertir les détails en tendances ;
- choisir la prochaine priorité.

### 6.5 Pas de base de données scolaire par défaut

Ne pas suivre des centaines de cartes, scores, dates et statistiques sauf décision future explicite.

Le système doit rester léger.

## 7. Suivre la progression sans transformer le système en école

### 7.1 Suivi qualitatif

Utiliser des marqueurs humains :
- “Tu réponds plus vite dans les situations simples.”
- “Cette phrase commence à devenir naturelle.”
- “On va juste consolider celle-ci.”

Éviter :
- notes ;
- tests ;
- classement ;
- leçons numérotées ;
- jargon scolaire.

### 7.2 Bilans courts

Hebdomadaire :
- 1 phrase qui progresse ;
- 1 phrase à revoir ;
- 1 mini-défi.

Mensuel :
- ce qui devient naturel ;
- ce qui reste fragile ;
- prochaine priorité.

Jamais de long bulletin.

### 7.3 Niveaux invisibles

Coach English peut suivre des niveaux internes, mais doit les présenter comme des capacités réelles :

Pas :
- “Tu es A1+.”

Plutôt :
- “Tu commences à pouvoir gérer des petites demandes simples en anglais.”

### 7.4 Récompense sobre

Valoriser les progrès par des formulations adultes :
- “Good. This is useful.”
- “Nice upgrade.”
- “That sounds natural.”
- “Keep this sentence — it will serve you often.”

Pas de badges enfantins.

## Architecture finale recommandée

### USER.md
Stable, identitaire, peu modifié.

Contient :
- profil d’apprenant ;
- préférences ;
- méthode validée ;
- objectifs long terme.

### MEMORY.md
État pédagogique actif, compact, modifié régulièrement.

Contient :
- niveau conversationnel qualitatif ;
- expressions actives ;
- expressions fragiles ;
- patterns récurrents ;
- thèmes ;
- prononciation ;
- prochaine priorité.

### Conversation courante
Temporaire.

Contient :
- phrase du jour ;
- réponse de Ced ;
- correction ponctuelle ;
- micro-contexte.

### Option future — fichier dédié de suivi

Si la mémoire devient trop limitée pour plusieurs années, créer plus tard un fichier dédié non injecté intégralement à chaque session :

`pedagogy/progress-log.md` ou `pedagogy/progress.json`

Usage :
- historique compressé ;
- archives mensuelles ;
- expressions sorties de la mémoire active.

Mais par défaut, ne pas le créer tant que USER.md + MEMORY.md suffisent.

## Règle centrale

La mémoire pédagogique doit rendre Coach English plus pertinent, pas plus lourd.

Elle doit permettre à Ced de sentir :
- “le coach me connaît” ;
- “je progresse” ;
- “ça reste simple” ;
- “je peux revenir même après une pause”.