Guides d’apprentissage (Guías de Aprendizaje)
Ce que c’est. Le document qui accompagne la personne qui apprend tout au long de l’apprentissage : il lui dit où elle en est, ce qu’elle poursuit, ce qu’elle va faire, comment elle saura qu’elle y est parvenue et quelles décisions lui appartiennent. Son lecteur est le sujet d’apprentissage (Sujeto de Aprendizaje) — la personne participante, l’apprenant·e, celle qui apprend — et le guide est écrit pour elle, à la deuxième personne. Il existe à trois altitudes : celle du programme d’apprentissage, celle de l’expérience d’apprentissage et celle de l’unité d’apprentissage (Programa, Experiencia, Unidad de Aprendizaje). Ce sont trois documents distincts, non trois versions du même.
Pourquoi il existe. Smoother déclare bien plus que ce qu’une personne peut lire : huit composantes de l’objet d’apprentissage (Objeto de Aprendizaje), huit structures d’unité, six types de tâche (Tipos de Tarea), une rubrique ancrée à l’objet d’apprentissage, seize Préférences Personnelles, une couche d’expérience (Capa de Experiencia), une Définition Générale de l’Apprentissage. Tout cela est déclaré du côté de la conception. Le guide d’apprentissage est la traduction de cette structure déclarée dans la perspective de la personne qui va la vivre — et c’est pourquoi c’est un artefact dérivable : presque tout ce qu’elle contient existe déjà ailleurs dans le modèle.
Ce qu’elle n’est PAS
Ce n’est pas le contenu — elle n’explique pas le sujet ; si le guide enseigne, quelque chose a été écrit au mauvais endroit. Ce n’est pas le programme des matières — ce n’est pas une liste de sujets avec des dates, mais une orientation sur la manière de les parcourir. Ce n’est ni une note ni un dossier — elle montre la rubrique comme un miroir, ce que l’on verra quand chaque composante sera atteinte, jamais comme un score cumulé. Et ce n’est pas le guide du·de la facilitateur·rice : ce dont le·la facilitateur·rice d’apprentissage (Orientador de Aprendizaje) a besoin vit dans le guide d’orientation (Guía de Orientación), document frère qui emploie le même squelette.
Les trois altitudes, et l’héritage
| Altitude | La question à laquelle elle répond | Quand on la lit |
|---|---|---|
| Du programme d’apprentissage | Dans quoi suis-je en train de m’engager, en quoi cela me concerne-t-il, et comment est-ce que je le navigue ? | À l’entrée ; on y revient pour se réorienter. |
| De l’expérience d’apprentissage | Que pourrai-je faire au terme de cette expérience et comment saurai-je que j’y suis parvenu ? | À l’entrée dans chaque expérience. |
| De l’unité d’apprentissage | Que fais-je avant, pendant et après cette unité ? | À côté de l’unité, pendant le travail. |
Rien ne se répète vers le bas. Le guide du dessous hérite de l’orientation de celui du dessus et n’ajoute que ce qui est propre à son altitude. Un pointeur, jamais une copie : quand l’altitude inférieure a besoin de quelque chose de la supérieure, elle y renvoie par un lien — un guide qui reproduit le texte de celui du dessus se désynchronise au premier changement. La seule exception légitime est la contradiction locale : si dans cette expérience ou cette unité quelque chose fonctionne autrement que ne le dit le guide du dessus, cela se dit explicitement et se signale comme une exception. Et malgré l’héritage, chaque guide se lit seul : les pointeurs sont des aides, non des exigences de lecture préalable.
L’origine de chaque section, qui est tout le propos
Chaque section déclare son origine, et l’origine est exactement l’une de trois :
generada(générée) — elle se dérive mécaniquement d’une structure déjà déclarée, et on nomme d’où : une composante de l’objet d’apprentissage, la structure d’unité, les tâches d’apprentissage, la rubrique, les Préférences, la couche d’expérience, la Définition Générale, des champs de la plateforme.autorada(rédigée par une personne) — elle est écrite par une personne, et on dit qui : l’équipe de conception, ou le·la facilitateur·rice d’apprentissage assigné·e.invariante(invariante) — texte fixe de Smoother, identique dans tous les guides de cette altitude, qui ne se réécrit pas selon le programme d’apprentissage.
Cette colonne est ce qui permet à la plateforme de générer le guide au lieu de demander qu’on l’écrive. Le guide du programme a quatorze sections — sept générées, deux rédigées, cinq invariantes — ; celui de l’expérience, dix — sept, une et deux — ; celui de l’unité, onze — neuf, une et une —. La proportion n’est pas fortuite : c’est tout l’argument du document.
Parmi les sections : ce que poursuit le programme, dit depuis les huit composantes de l’objet d’apprentissage ; avec quoi il convient d’arriver ; comment il est organisé en blocs d’apprentissage et quels parcours d’apprentissage existent ; comment tu vas savoir que tu as progressé, avec la rubrique présentée pour ce qu’elle est — lignes = composantes de l’objet d’apprentissage, quatre niveaux (Non atteint · En développement · Atteint · Maîtrisé) et le résultat comme profil par composante, non comme note — ; combien de temps et comment le répartir ; les techniques d’étude propres ; sur qui l’on peut compter ; et ce qui vient avant, pendant et après chaque unité d’apprentissage.
Cinq gardes, et une sixième
Elles valent aux trois altitudes, et elles valent aussi bien pour le guide écrit à la main que pour le guide généré.
- Jamais de prescription par préférence. Les Préférences Personnelles s’offrent comme un menu de variété, jamais comme une affectation. Toute formulation qui suggérerait un appariement — « ton style d’apprentissage est X, donc… » — est interdite.
- Jamais de conversion de la rubrique en note. Elle montre des lignes et des descripteurs, et rend un profil multicomposant. Elle ne fait pas de moyenne, n’accumule pas de points, ne produit ni nombre unique ni classement.
- Jamais de restitution du contenu. Si une section du guide peut s’étudier à la place du matériel, elle est mal écrite.
- Jamais le vocabulaire refusé. Ni « élève », ni « étudiant », ni « stagiaire », ni « cours », ni « module », ni « enseignant » ou « professeur ». On dit participante / aprendiz / Sujeto de Aprendizaje, Unidad de Aprendizaje, Experiencia de Aprendizaje, Programa de Aprendizaje, Orientador de Aprendizaje. L’exception de registre institutionnel de la règle de capacité n’atteint pas ce document : le guide d’apprentissage est exactement ce qu’une personne participante lit, et là l’interdiction est totale.
- Jamais de revendication d’efficacité prouvée. Elle ne dit pas « méthode éprouvée », ni « fondée sur des données probantes », ni « la recherche démontre que ce guide améliore tes résultats ». Elle peut dire quel instrument elle emploie et d’où vient cet instrument.
Et une sixième, mineure mais récurrente : jamais d’invention de ce qui n’est pas déclaré. Si la couche d’expérience ne déclare ni horizon ni choix offert, la section correspondante est omise — on ne fabrique ni un référent ni un choix que la conception n’a pas offert.
Comment il se génère
Chaque altitude a une précondition : sans objet d’apprentissage rempli, le guide du programme ne se génère pas, et cela se signale comme un blocage au lieu d’émettre un guide mutilé ; sans structure déclarée, il n’y a pas de guide d’unité. Les sections générées sont émises complètes, les invariantes sont insérées depuis un gabarit sans traduction ad hoc, et les rédigées sont émises comme des trous — un trou vide n’empêche pas de publier, mais le combler avec un texte généré qui simulerait une écriture humaine est, lui, interdit. La régénération réécrit le généré et l’invariant et préserve intégralement le rédigé : jamais un texte humain n’est perdu par une régénération. Et tout guide émis consigne version et date, pour que la personne qui le lit sache s’il correspond à la conception en vigueur.
Preuves
Niveau : Synthétisé. Ce document n’apporte ni résultats propres ni instrument nouveau : c’est un assemblage de canon déjà existant, réordonné depuis la perspective de la personne qui apprend et fixé comme contrat de génération. Chaque pièce qu’il transporte conserve sa propre étiquette : l’objet d’apprentissage et les structures, original ; les six types de tâche et la rubrique, synthesized ; la posture Pashler, étayée dans sa critique ; la couche d’expérience, original / posture de conception, dont l’auteur est Carlos Miranda Levy ; les techniques de la personne participante, mixtes selon la technique.
Ce qui lui est propre — et donc non étayé — ce sont trois décisions de conception : le squelette de sections partagé avec le guide d’orientation, la taxonomie d’origine generada / autorada / invariante, et la règle d’héritage par pointeur entre altitudes. Ce sont des décisions d’architecture documentaire, non des affirmations sur l’apprentissage. Aucun instrument assemblé ne prête son étiquette à l’assemblage : que la rubrique soit bien fondée ne rend pas ce guide bien fondé.
Formulations permises : « consolide des instruments déjà canonisés » · « dérive de la structure déclarée » · « rend le guide générable » · « posture de conception de Smoother » · « s’aligne avec » · « est cohérent avec ». Formulations interdites : « méthode éprouvée » · « fondée sur des données probantes » · « la recherche démontre que les guides d’apprentissage améliorent les résultats » · « guide personnalisé selon ton style d’apprentissage » · toute formulation qui attribuerait au guide un effet mesuré sur l’apprentissage.
Liens connexes
Guides d’orientation · L’objet d’apprentissage · Unités d’apprentissage · Tâches d’apprentissage · Évaluation · Préférences Personnelles · Découverte · Couche d’expérience · Techniques d’Étude et de Pratique · Blocs d’Apprentissage · Parcours d’Apprentissage · Routage des Tâches
Source
protocol/smoother-guias-de-aprendizaje.md — état au 2026-09-17 (section ouverte du CHANGELOG, postérieure à 0.40.0).