Explorer
ACT-ALW-007

Solution Factory — décider la stack et l'infra avant d'écrire du code

Domaine
all
Type
principle
Priorité
P0

Solution Factory — décider avant de coder

Règle

Toute demande de type « crée-moi une app / un site / un outil / un dashboard / une API » DOIT d'abord passer par la boucle Solution Factory avant toute génération de code, de composant ou de fichier source.

Pourquoi

L'IA a tendance à coder immédiatement avec la stack par défaut de son contexte d'entraînement. Résultat : stack inadaptée, déploiement non pensé, dette dès le premier jour. Solution Factory force une décision explicite, justifiée par des données, et alignée avec le projet.

Boucle obligatoire (P0)

COMPRENDRE → DECIDER → DOCUMENTER → VALIDER → CODER

1. Comprendre (2 min)

Reformuler l'objectif réel, le périmètre, les utilisateurs finaux et les contraintes.

Questions obligatoires :

  • Quel type de produit ? (site vitrine, SaaS, app mobile, desktop tool, API, marketplace, etc.)
  • Qui sont les utilisateurs ? (B2B, B2C, interne, public)
  • Quelles sont les contraintes ? (budget, offline, temps réel, échelle, sécurité, intégrations)
  • Quel est le délai de mise en ligne ? (POC 1h, MVP 1 semaine, prod 1 mois)

2. Décider (3 min)

Utiliser KNOW-PAT-197 (Stack Chooser 2026) pour sélectionner :

  • Langage / runtime
  • Framework frontend / backend
  • Base de données
  • Authentification
  • Hébergement / déploiement

Utiliser KNOW-PAT-198 (Deployment & Infra 2026) pour valider les choix d'infra.

3. Documenter (2 min)

Créer ou mettre à jour DESIGN.md (PAT-144) ou PRODUCT.md avec :

  • Objectif
  • Stack choisie et justifications
  • Architecture (schéma texte ou Mermaid)
  • Dépendances et versions
  • Plan de déploiement

4. Valider (1 min)

  • Vérifier que les choix ne contredisent pas un ACT-ALW ou KNOW-PAT P0 existant.
  • Si le projet est web, s'assurer que ACT-ALW-005 (bootstrap J0) est satisfait.
  • Si le projet est UI, appliquer KNOW-PAT-193 (workflow design unifié).

5. Coder

Seulement après les 4 étapes précédentes. Le code produit doit refléter les décisions documentées.

Anti-pattern associé

KNOW-ANT-020 — Coder avant de décider.

Agent

  • Refuser de générer du code si le document de décision (DESIGN.md ou PRODUCT.md) n'est pas en place.
  • Citer ACT-ALW-007, KNOW-PAT-197, KNOW-PAT-198 et KNOW-REF-001 dans le raisonnement.
  • Ne pas proposer de stack par habitude (ex: Next.js partout) sans justification au regard du contexte.

Exceptions

  • Spikes < 1h avec label WIP-SPIKE et code jetable.
  • Script one-shot non destiné à être déployé.

Références

  • [[KNOW-PAT-197]] — Stack Chooser 2026
  • [[KNOW-PAT-198]] — Deployment & Infra 2026
  • [[KNOW-REF-001]] — Références externes 2025
  • [[KNOW-ANT-020]] — Coder avant de décider
  • [[KNOW-PAT-193]] — Workflow design unifié
  • [[ACT-ALW-005]] — Bootstrap J0