Aller au contenu

Decisions

Cette page resume les ADR legeres qui expliquent les decisions difficiles a inverser du handbook. Les fichiers ADR complets vivent dans le repo public sous docs/adr/.

ADRDecisionPourquoi c’est important
0001Utiliser Starlight pour le Fenod Stack HandbookStarlight est Markdown-first, bilingue, searchable, compatible Cloudflare, et facile a modifier par agents via diffs normaux.
0002Utiliser ce repo public comme source de stack.fenod.frLe repo public rend le handbook transparent et lisible par IA, mais impose de garder les notes operationnelles privees ailleurs.
0003Maintenir deux couches de documentation, humaine et agentLes humains ont besoin de rationale et d’exemples; les agents ont besoin de contrats concis, defaults, pieges et commandes de verification.

Creer des ADRs avec parcimonie. Une decision merite une ADR seulement si elle est difficile a inverser, surprenante sans contexte, et issue d’un vrai trade-off.