Aller au contenu

ADR-049 : Repositionnement : framework de production auditable

Statut

Accepté, bêta publique 1.0 (1.0.0-beta.x).

Date

2026-06-24

Contexte

Jusqu'ici, l'identité publique de Forge se résumait par le mot « pédagogique »
(CLAUDE.md § 1 : « explicite, pédagogique, testable et durable » ; vitrine et
README parlant de « démonstrateurs pédagogiques » et de « prototypes »).

Le but du projet a été explicité : faire de Forge un produit adopté, c'est à
dire un framework sur lequel des tiers bâtissent des applications en
production, et non seulement un support d'apprentissage.

Or le cadrage « pédagogique / prototype » disqualifie Forge auprès de ce
public : un ingénieur qui évalue un framework pour la production lit
« pédagogique » et conclut « pas pour moi ». Le positionnement contredisait donc
l'objectif. Les propriétés techniques de Forge (explicite, sans magie, SQL
visible, sécurisé par défaut, runtime minimal) ne changent pas ; ce sont des
vertus de production (auditabilité, absence de surprise, faible surface
d'attaque et de maintenance) autant que d'enseignement.

Décision

L'identité publique de Forge devient : « le framework web Python que l'on peut
lire en entier », pour des applications de production dont on comprend et audite
chaque ligne.

  • Le caractère pédagogique n'est plus l'identité : il devient une
    conséquence de la lisibilité (un code que l'on peut lire en entier est, de
    fait, enseignable). Le parcours d'accueil et les starters restent une rampe
    d'apprentissage assumée, c'est à dire une fonctionnalité, pas la promesse
    centrale.
  • La cible affichée devient : outils internes, applications métier durables,
    sites publics avec administration, et tout contexte (sécurité, conformité) où
    la « magie » d'un gros framework est un risque plutôt qu'un confort.
  • Aucune propriété technique ni aucun principe de la charte n'est retiré : ce
    repositionnement réinterprète les mêmes principes (explicite, refus de la
    magie cachée, SQL visible, sécurisé par défaut, noyau minimal) comme des
    atouts de production.

Conséquences

  • Vitrine et README repositionnés (accroche « lire en entier », cible
    production auditable, retrait de « pédagogique / prototype » comme identité).
  • CLAUDE.md § 1 porte encore « pédagogique » dans la phrase d'identité.
    Ce fichier est protégé et refondu aux tags majeurs (§ 10) : la mise à jour de
    la phrase d'identité (« explicite, auditable, testable et durable », le
    pédagogique devenant dérivé) est à intégrer à la prochaine refonte, pas en
    écriture directe.
  • Un balayage de la documentation reste à faire pour distinguer les emplois
    légitimes de « pédagogique » (parcours d'accueil, starters, exemples) des
    emplois où il tenait lieu d'identité.
  • Ce repositionnement va de pair avec la promesse de confiance sur la
    licence (bascule MIT datée et critère vérifiable, LEGAL-LICENSE-ROADMAP-001):
    un produit visé pour la production exige clarté du « pourquoi » et garantie
    de durée.

Relation avec la charte (ADR-007)

La charte v2 et ses onze principes restent inchangés et non négociables.
Le présent ADR ne modifie aucun principe : il fixe le positionnement et la
communication du projet, qui se situent au-dessus des principes et s'appuient
sur eux. En particulier, « refuser la magie cachée », « garder SQL visible » et
« sécuriser par défaut » sont les fondements directs de l'argument
d'auditabilité en production.

Alternatives écartées

  • Conserver l'identité « pédagogique » : cohérente avec l'histoire du projet,
    mais incompatible avec l'objectif d'adoption en production (écartée pour cette
    raison).
  • Abandonner toute dimension pédagogique : la rampe d'apprentissage (parcours
    d'accueil, starters) est un différenciateur réel et un atout d'adoption ;
    écartée. Le pédagogique est conservé comme conséquence et fonctionnalité, pas
    comme promesse centrale.

Liens