Nomenclature et bibliothèque du projet

Source : project/conventions/nomenclature-blocs-pedagogiques.md
Identifiant : [DOC-CHR-004]
Version : 0.7
Dernière modification : 2026-06-12
Statut : convention de travail initiale

Cette convention définit comment identifier les éléments importants du projet Coder avec l’IA.

Elle couvre deux grandes familles :

les contenus pédagogiques : domaines, thèmes, notions, compétences, micro-modules, paliers, blocs, ressources;
les documents de projet : brainstorms, chartes, décisions, catalogues, glossaires, parcours, specs, prompts, archives.

Vue d’ensemble de la bibliothèque

Bibliothèque du projet
  → Contenus pédagogiques
      → Domaines
      → Thèmes
      → Notions
      → Compétences
      → Micro-modules
      → Paliers
      → Blocs pédagogiques
      → Ressources
  → Documents de projet
      → Brainstorms
      → Chartes
      → Décisions
      → Catalogues
      → Glossaire
      → Parcours
      → Spécifications
      → Backlog
      → Prompts
      → Archives
      → Configurations

Hiérarchie de connaissance

Domaine
  → Thème
    → Notion
      → Micro-module
        → Palier I / II / III
          → Bloc pédagogique
            → Ressource

Les compétences forment une couche transversale :

Compétence
  → liée à un ou plusieurs micro-modules
  → observée par un ou plusieurs exercices, checklists ou évaluations

Structure de diffusion

Parcours
  → Module
    → Séance ou rencontre
      → Segment
        → Références vers des micro-modules, paliers ou blocs existants

Une séance ou une rencontre ne possède pas les contenus : elle les référence.

Exemple concret — les trois rencontres pilotes

Couche	Rencontre 1	Rencontre 2	Rencontre 3
Affichage dans le parcours	Rencontre 1 - Contexte utile	Rencontre 2 - Cartographier un codebase	Rencontre 3 - Vérifier une réponse IA
Page publique	`/cours/contexte-utile`	`/cours/cartographier-codebase`	`/cours/verifier-reponse-ia`
Contenu stable	`MIC-CTX-001`	`MIC-MAP-001`	`MIC-EVA-001`
Titre stable	Contexte utile	Cartographier un codebase	Vérifier une réponse IA
Domaine	`CTX`	`MAP`	`EVA`
Compétence centrale	`CMP-CTX-001`	`CMP-MAP-001`	`CMP-EVA-001`
Source de conception	`project/current/cours-ia-avance/modules/MIC-CTX-001-donner-contexte-utile.md`	`project/current/cours-ia-avance/modules/MIC-MAP-001-cartographier-codebase.md`	`project/current/cours-ia-avance/modules/MIC-EVA-001-verifier-reponse-plausible.md`
Suivi Admin	`/admin/modules-pilotes`	`/admin/modules-pilotes`	`/admin/modules-pilotes`

Lecture recommandée :

Rencontre = ordre de présentation dans un parcours donné
MIC = contenu pédagogique stable
CMP = compétence observable liée au contenu
Page publique = version lisible par l’étudiant
Source projet = fichier de conception et de maintenance
Admin = vue de suivi et de documentation

Donc Rencontre 1 - Contexte utile n’est pas l’identité du contenu. C’est la position actuelle du contenu MIC-CTX-001 dans le parcours public.

Métadonnées minimales obligatoires

Tout élément important de la bibliothèque doit exposer au minimum :

id
version
last_modified
status
title

Ces champs s’appliquent aux documents de projet, aux compétences, aux micro-modules, aux paliers, aux blocs pédagogiques et aux ressources.

Identifiants pédagogiques

Format général :

[TYPE-DOMAINE-NNN]

Exemples :

[CMP-CTX-001]
[MIC-MAP-001]
[PAL-MAP-001]
[THE-CON-001]
[EX-CON-002]
[VIS-MAP-001]

Types pédagogiques principaux :

FOR = Formation ou parcours complet
MOD = Module conceptuel
SEA = Séance livrée ou planifiée
SEG = Segment de séance
THM = Thème
NOT = Notion
CMP = Compétence observable
MIC = Micro-module pédagogique de 20 à 30 minutes
PAL = Palier progressif I, II ou III

Identifiants des documents de projet

Format général :

[DOC-TYPE-NNN]

Types de documents de projet :

BRN = Brainstorm ou espace d’idées libres
CHR = Charte, convention ou règle de travail
ADR = Décision structurante
CAT = Catalogue ou inventaire
GLO = Glossaire de projet
PAR = Parcours, plan de cours ou structure de formation
SPC = Spécification
BKL = Backlog
PRM = Prompt de travail ou gabarit de prompt
ARC = Archive
RDM = README ou document d’accueil
CFG = Configuration ou instruction d’agent
IDX = Index ou page de navigation

Catalogues associés

Règles de stabilité

Un identifiant ne contient jamais de nom de produit.
Un identifiant ne contient jamais de numéro de séance temporaire.
Un identifiant ne contient jamais de position dans une table des matières.
Un identifiant ne change pas quand un bloc ou un document est déplacé.
Les produits, outils, plateformes et chemins sont indiqués dans les métadonnées.
Les séances, rencontres, modules et parcours référencent des blocs; ils ne les possèdent pas.
Les compétences sont liées aux modules et aux activités, mais ne sont pas possédées par un module unique.
Le brainstorm peut contenir des idées non classées, mais les contenus stabilisés doivent ensuite être déplacés vers les catalogues appropriés.
Un identifiant supprimé ne doit pas être réutilisé pour autre chose.
Un bloc ou document remplacé doit être marqué deprecated plutôt que renommé silencieusement.
Tout élément important doit avoir une version et une date de dernière modification.

Vue d’ensemble de la bibliothèque​

Hiérarchie de connaissance​

Structure de diffusion​

Exemple concret — les trois rencontres pilotes​

Métadonnées minimales obligatoires​

Identifiants pédagogiques​

Identifiants des documents de projet​

Catalogues associés​

Règles de stabilité​