Aller au contenu

ADR 0005 — LIVING/COLD comme invariant central

Contexte

Les équipes qui utilisent des agents IA pour construire un produit rencontrent trois pathologies récurrentes :

  1. Projet sans mémoire : chaque session redéfait la précédente, aucune décision ne tient.
  2. Projet rigide : tout est figé trop tôt, le moindre pivot devient un drame.
  3. Projet en dérive : personne ne sait à un moment donné ce qui est acté et ce qui ne l'est pas.

Il manque un concept qui distingue clairement en cours de négociation et décidé, sans être binaire au point de rigidifier, ni flou au point de laisser dériver.

Options envisagées

  1. Statut WIP/DONE classique — trop binaire, pas de notion de « je peux rouvrir si nécessaire mais avec cérémonie ».
  2. Git branches + merge — technique, pas universel (sponsors ne lisent pas git).
  3. Draft/Published comme dans un CMS — inapproprié : ce n'est pas une question de publication.
  4. Distinction LIVING/COLD explicite — mutable vs gelé, badge visible sur chaque objet.

Décision

Retenu : LIVING / COLD comme concept central.

Chaque artefact porte un badge de chaleur (LIVING, LIVING-GELÉ, COLD) dérivé de son méta-état. La bascule LIVING → COLD se produit uniquement au franchissement d'une porte, avec un acte de gel explicite (freeze dans la transition).

Conséquences

Positives :

  • Vocabulaire partagé : sponsors et équipes techniques disent la même chose quand ils disent « LIVING ».
  • Visibilité immédiate : la CLI affiche le badge, le site aussi. Personne ne devine.
  • Mécanisme anti-dérive : un artefact COLD modifié sans passage de porte produit un événement anormal (commit hors-CLI) facilement détectable.
  • Licence à pivoter : LIVING légitime l'exploration — on peut défaire ce qui est encore LIVING sans demander pardon.

Négatives :

  • Le mot « LIVING » est anglais dans un kit majoritairement français. Assumé : aucun équivalent français (« vivant ») ne porte la même charge technique.
  • La nuance LIVING-GELÉ (pour BLOCKED) est subtile. Expliquée dans la page LIVING / COLD.

Neutres :

  • Le concept est emprunté implicitement à des pratiques existantes (distinction document de travail / document signé, brouillon / publié, proposition / décision). Le kit le nomme, le code, le visualise.

Règle dérivée

Aucune modification d'un artefact COLD sans processus explicite de réouverture. Une modification silencieuse est un bug — à traiter comme tel (reverter, puis repasser par une porte).

Références