| name | autonomous-learning-os |
| description | Construit à l'utilisateur son propre dashboard d'apprentissage sur mesure — entretien de setup, deep research multi-agents sur son sujet, génération du curriculum, app Next.js au design BizOS, brief Telegram optionnel. À utiliser quand l'utilisateur veut apprendre un sujet sérieusement, se construire un cursus, ou lance ce repo. |
Autonomous Learning OS — skill de setup
Tu conduis l'utilisateur de « je veux apprendre X » à un dashboard d'apprentissage
qui tourne sur sa machine, rempli de sources réelles et vérifiées, en une seule
conversation.
Ta contrainte absolue : à la fin, npm run dev doit afficher une app complète et
fonctionnelle, sans qu'il reste une seule étape manuelle non annoncée. Pas de
placeholder, pas de « à toi de remplir », pas de curriculum d'exemple laissé en
place.
Phase 0 — Repérage (avant de parler)
Fais ça en silence, avant la première question. Ça évite de demander ce que tu
peux voir.
bash scripts/00-detect-stack.sh
Le script écrit .setup/stack.json et affiche un résumé. Il détecte :
- les runtimes :
node, npm, python3
- les CLIs de données :
supabase, railway, psql, neonctl — et si elles sont authentifiées
- les CLIs de déploiement :
vercel, gh
- les CLIs d'IA :
claude, codex
- les variables d'environnement d'API déjà présentes dans le shell
Lis .setup/stack.json avant de poser la question 4 et la question 5. Si
l'utilisateur a déjà supabase connecté, tu proposes Supabase en premier choix,
pas en dernier.
Phase 1 — L'entretien
Six questions. Pose-les une par une, attends la réponse, rebondis. Ce n'est
pas un formulaire : si une réponse est vague, creuse avant de passer à la suite.
Utilise l'outil de question à choix multiples quand les options sont fermées
(questions 4, 5, 6). Laisse la réponse libre pour 1, 2, 3.
Q1 — Qu'est-ce que tu veux apprendre ?
Ouverte. Ce que tu veux en sortir :
- Le sujet exact. « L'IA » est trop large — tu veux savoir si c'est entraîner
des modèles, utiliser des LLM en produit, ou comprendre les fondations
mathématiques. Reformule et fais confirmer.
- Mono-sujet ou cursus ? Un sujet unique donne un curriculum profond. Plusieurs
matières donnent un cursus large. 3 à 5 matières actives est ce qui tient le
mieux dans la durée (cf.
docs/LEARNING-SCIENCE.md) — dis-le, puis
construis ce qu'il demande. Il n'y a pas de plafond : c'est son temps.
- Le format actuel. Demande explicitement : « Tu apprends comment aujourd'hui ?
Vidéos, livres, cours en ligne, projets ? Qu'est-ce qui n'a pas marché ? » Ça
oriente la pondération vidéo / lecture / pratique de la recherche.
Q2 — Où tu en es, et où tu veux aller ?
- Niveau de départ, en concret : ce qu'il sait déjà faire, pas un « intermédiaire ».
- Le résultat visé doit être vérifiable. « Comprendre la finance » ne l'est pas.
« Lire un bilan et repérer trois signaux d'alerte » l'est. Reformule jusqu'à
obtenir un critère observable — il devient l'objectif de sortie du curriculum.
Q3 — Combien de temps par jour, sur combien de semaines ?
- Minutes par session : 15 / 30 / 45 / 60 / 90 / 120 / 180. L'app calibre la
séquence dessus.
- Jours par semaine.
- Horizon en semaines → détermine le nombre de modules à générer
(compte ~1 module par 2 sessions).
Q4 — Comment on branche l'IA ?
Trois modes, décrits dans docs/AI-PROVIDERS.md. Propose-les dans cet ordre :
| Mode | AI_PROVIDER | Ce que ça veut dire |
|---|
| Ton agent (recommandé) | claude-code | Aucune clé. L'app prépare le prompt de correction, tu le colles à ton agent, il corrige. Zéro coût marginal. |
| Ta CLI locale | cli | L'app appelle claude -p ou codex exec sur ta machine. Détecté en phase 0. Zéro clé dans un fichier. |
| Ta clé API | api | Anthropic ou OpenAI, ta clé, ton compte. Elle va dans app/.env.local, qui est git-ignoré. |
Ne propose jamais, et n'accepte jamais, une clé qui ne serait pas celle de
l'utilisateur. Ce repo ne fournit aucune clé.
Si l'utilisateur choisit api, ne lui demande pas de te coller sa clé dans le
chat. Dis-lui de l'écrire lui-même dans app/.env.local, ou fais-le écrire par
une commande shell qu'il lance (le ! prefix dans Claude Code).
Q5 — Où stocker ta progression ?
Regarde .setup/stack.json avant de proposer.
| Option | Quand la proposer | Ce que fait l'agent |
|---|
| Fichier local (défaut) | Toujours disponible | Rien à faire. app/.data/ est créé au premier écrit, git-ignoré. |
| Supabase | Si supabase est installé et authentifié | bash scripts/03-database.sh supabase : crée/lie le projet, applique le schéma, écrit DATABASE_URL. |
| Railway | Si railway est installé et authentifié | bash scripts/03-database.sh railway : provisionne Postgres, récupère l'URL, applique le schéma. |
| Postgres existant | Si l'utilisateur a déjà une URL | bash scripts/03-database.sh url puis colle l'URL. |
Le fichier local suffit pour un usage solo sur une machine. La DB sert dès qu'il
veut la progression sur plusieurs appareils ou un déploiement.
Q6 — Tu veux un brief Telegram ?
Si oui : suis docs/TELEGRAM.md avec lui, pas à sa place. Il doit
créer son bot chez @BotFather (tu ne peux pas le faire), récupérer le token, lui
écrire un message, puis lancer bash scripts/04-telegram.sh qui résout le chat ID
et teste l'envoi.
Le message quotidien est personnalisé sur son sujet : le module du jour, la
source exacte à ouvrir, la durée, et la question de rappel. Le template est dans
docs/TELEGRAM.md — adapte-le à son domaine, ne renvoie pas un texte générique.
Phase 2 — La deep research
C'est ce qui fait la valeur. Ne la saute pas, ne la remplace pas par ce que tu
crois savoir. Un curriculum écrit de mémoire contient des liens morts et des
cours qui n'existent plus.
Lis research/PROMPTS.md en entier, puis lance quatre sous-agents en parallèle
avec le contexte de l'entretien (sujet, niveau, objectif, temps) :
| Sous-agent | Mission | Modèle conseillé |
|---|
ACADEMIC | Cours universitaires ouverts, manuels libres, papiers de référence, syllabi publics. | Sonnet 5 |
VIDEO | Chaînes et playlists, avec segments horodatés et durée réelle. | Sonnet 5 |
PRACTITIONER | Retours de terrain, études de cas, outils — étiquetés comme tels, jamais comme preuve académique. | Sonnet 5 |
SYLLABUS | L'ordre des notions : prérequis, dépendances, progression. Ne cherche pas de liens, structure. | Opus / GPT-5.x |
Chaque sous-agent rend du JSON conforme à research/curriculum.schema.json.
Écris les rendus bruts dans .setup/research/<agent>.json — ils servent de trace
et permettent de relancer une seule branche si elle est faible.
Les règles non négociables sur les sources
Elles sont dans docs/SOURCE-POLICY.md. Les trois qui font échouer une source :
- Elle doit être gratuitement accessible. Pas de certificat payant obligatoire,
pas de paywall. Note l'accès dans
accessNote.
- Elle doit être vérifiée. Tu ouvres le lien. Si tu ne peux pas confirmer qu'il
répond, tu ne le mets pas.
verifiedAt porte la date du jour.
- Elle doit porter une raison.
why explique pourquoi cette source pour
cette notion, à ce niveau. « C'est un bon cours » n'est pas une raison.
Pour une vidéo, segmentStartSeconds et minutes définissent la capsule à
regarder. C'est le cœur du produit : l'utilisateur ne regarde jamais 90 minutes
par défaut, il regarde les 11 minutes qui portent la notion du jour.
Fusion
Tu fusionnes les quatre rendus :
SYLLABUS donne l'ordre des modules.ACADEMIC et VIDEO remplissent les sources de chaque module ; en cas de
doublon, garde la plus institutionnelle et mets l'autre en alternatives.PRACTITIONER alimente les exercices de transfert et les études de cas.- Écris
app/content/curriculum.json.
- Valide :
node scripts/validate-curriculum.mjs. Corrige jusqu'au vert.
Phase 3 — Le montage
bash scripts/01-scaffold.sh
cd app && npm install
Puis, selon les réponses :
bash scripts/02-configure.sh
bash scripts/03-database.sh <mode>
bash scripts/04-telegram.sh
Personnalisation visuelle
L'app porte l'UX BizOS V9 (docs/DESIGN.md) : wallpaper plein écran, panneaux
blancs à trait 1 px et ombre dure 5 px, Inria Serif, monochrome noir/blanc/gris.
Ne le remplace pas, et n'y réintroduis aucune couleur d'accent. Ce qui se
personnalise :
- Le wordmark reste
BizOS × Learning, avec le sujet de l'utilisateur en
sous-titre (NEXT_PUBLIC_LEARNING_SUBJECT).
- Le fond d'écran par défaut :
NEXT_PUBLIC_DEFAULT_WALLPAPER. Les 12 fonds
procéduraux livrés sont dans app/src/lib/wallpapers.ts — choisis-en un qui
colle au domaine (blueprint pour l'ingénierie, ledger pour la finance,
synapse pour les sciences cognitives…).
- Les icônes de matières dans
curriculum.json (icon) — un glyphe simple,
jamais un emoji couleur : la V9 est monochrome.
L'utilisateur peut changer de fond à tout moment depuis Réglages → Apparence,
et déposer les siens dans app/public/wallpapers/.
Phase 4 — La vérification (obligatoire)
Tu ne déclares pas terminé sans avoir fait tourner ça :
bash scripts/05-verify.sh
Il enchaîne : validation du curriculum, npm test, npm run build, démarrage du
serveur, et un GET sur /, /learning, /exercises, /reviews, /settings.
Puis ouvre réellement l'app et regarde-la. Si tu as un outil de navigation,
charge localhost:3000, clique sur les cinq onglets, lance une vidéo, ouvre la
galerie de fonds. Un build qui passe n'est pas une preuve que l'écran est correct.
Enfin :
bash scripts/check-secrets.sh
Aucun secret ne doit être committable. Si le script sort en erreur, corrige avant
toute autre chose.
Phase 5 — La remise
Dis à l'utilisateur, en clair et court :
- Ce qui tourne — l'URL, les cinq écrans, le sujet, le nombre de modules.
- Ce que la recherche a trouvé — combien de sources, de quelles institutions,
et la plus forte selon toi.
- Ce qu'il fait maintenant — sa première session, sa durée, la première source.
- Ce qui reste optionnel — Telegram s'il a dit non, la DB s'il est en fichier,
le déploiement Vercel.
- Comment ça se met à jour — relancer la recherche pour le module suivant, ou
éditer
curriculum.json à la main.
Ne fais pas un rapport de 40 lignes. Il veut apprendre, pas lire ton compte rendu.
Règles de conduite
- Une question à la fois. L'entretien est ce qui rend le curriculum juste.
- Ne devine pas les sources. Cherche, ouvre, vérifie. Un lien mort dans le
livrable, c'est un échec.
- Ne partage aucune clé, ne demande aucune clé qui ne soit pas la sienne.
- Ne laisse pas le curriculum d'exemple. Si la recherche échoue, dis-le
franchement et propose de relancer — ne livre pas l'exemple en prétendant que
c'est sur mesure.
- Le français est la langue par défaut de l'interface et du curriculum, sauf
demande contraire. Les titres de sources restent dans leur langue d'origine.
- Le nombre de matières est SA décision. Tu recommandes 3 à 5 actives, une
fois, avec la raison. S'il en veut huit, tu construis les huit — proprement,
sans y revenir et sans version dégradée. Un backlog est une option que tu
proposes, jamais une limite que tu imposes.
