Genesis — l’origine des patterns

Chaque pattern de SKRAFT a une histoire. Genesis est le processus discipliné qui garantit qu’un pattern ne naît pas d’une intuition, mais d’un problème identifié, d’une solution validée et d’une référence qui la justifie.

Pourquoi genesis ?

Un pipeline agentique est aussi fort que ses patterns. Un pattern mal conçu introduit une contrainte arbitraire que personne ne comprend — et que tout le monde contourne dès que le contexte change.

Genesis impose une question avant toute chose : quel problème ce pattern résout-il, et comment le savons-nous ?

La réponse doit s’appuyer sur :

  1. Une observation concrète du problème (pas une intuition),
  2. Une solution qui a fonctionné dans au moins un contexte réel (estimé : plusieurs itérations de validation),
  3. Une référence publiée (livre, article, conférence) qui défend la même approche.

Sans ces trois éléments, le pattern n’est pas prêt.

Comment un pattern entre dans SKRAFT

Étape 1 — Identifier le problème

Décrivez le problème en une phrase, depuis le point de vue de quelqu’un qui en souffre. Pas : “on devrait mieux structurer les tests”. Oui : “les tests d’acceptation échouent pour des raisons d’infrastructure — la logique métier n’est pas isolée.”

Étape 2 — Formuler la solution candidate

Décrivez la solution en termes de comportement observable : ce qu’elle change dans le pipeline, dans les artefacts, dans le code produit. Soyez précis sur ce que la solution ne change pas.

Étape 3 — Trouver la référence

Toute solution défendue dans SKRAFT doit être ancrée dans une référence publiée. La référence n’est pas là pour paraître sérieux — elle permet à quiconque de vérifier les hypothèses derrière la solution, et de comprendre ses limites.

Exemples de références valides : Evans (DDD, 2003), Freeman & Pryce (GOOS, 2009), Martin (Clean Architecture, 2017), Forsgren et al. (Accelerate, 2018).

Étape 4 — Ouvrir une Pull Request

Votre PR doit contenir :

Incluez dans la description de PR : le problème identifié, la solution proposée, et la ou les références qui la justifient.

Ce que genesis interdit

Contribuer à la documentation

Pour corriger ou améliorer une page existante :

  1. Forkez le dépôt et créez une branche depuis main.
  2. Modifiez les pages dans docs/site/fr/ et docs/site/en/ (les deux langues sont requises).
  3. Vérifiez les citations :
node scripts/check-citations.mjs --citations docs/site/_data/citations.yml --pages "docs/site/**/*.md"
  1. Ouvrez une Pull Request avec une description claire du changement.

Sources

Voir aussi