Un agent code vite. Maedow Flow décide de l'ordre des choses.

Ce qui se décide avant de coder, ce qui se prouve avant de fusionner, et ce qui ne se fait jamais. Pour des applications web, mobiles ou desktop qui tiennent en production.

Une séance avec ton agentMaedow Flow actif
  1. Ajoute le panier, puis pousse.

  2. IA
    git commit -m "Ajoute le panier"

    Je commite sur main.

  3. Refusé (MF-003)

    Refusé : pas de commit sur main. Crée une branche, puis ouvre une pull request.

  4. IA

    Branche feat/panier créée, commit fait. Le panier est fini, les tests passent.

  5. Refusé (MF-010)

    Pas encore : fini veut dire constaté sur l'application. Lance la vérification.

  6. IA
    /check verify panier

    3 critères d'acceptation sur 3 constatés. J'ouvre la pull request vers develop.

  7. Accepté (MF-010)

    Porte franchie.

Le kit s'installe avec
  • Claude Code
  • Cursor
  • Codex
  • tout agent avec un terminal
Le problème

Un agent livré à lui-même dérive

Un agent IA écrit du code plus vite que n'importe qui. Sans garde-fou, le résultat tient en démonstration et casse en production.

  • Décisions inventées

    Un agent livré à lui-même invente les décisions qu'on ne lui a pas données.

  • Périmètre qui s'élargit

    Il élargit le périmètre au passage, et déclare fini ce qu'il n'a pas vérifié.

  • Mémoire perdue

    Il oublie d'une session à l'autre ce qui avait été tranché, et le résultat casse en production.

La réponse

Cinq phases, cinq portes

Chaque phase se termine par une porte : une condition vérifiable, sans laquelle on ne passe pas à la suite. Voici ce que chacune produit, sur un projet réel.

Phase 0

Cadrer

/scope pose les questions que toi seul peux trancher, découpe l'idée en features, les ordonne et fixe leur palier d'exigence. Il ne choisit aucun outil : ce n'est pas son travail.

Porte : Chaque feature tient en une intention et une ligne « Fini quand ».

docs/scope/scope.md

  • 1Cataloguedone
  • 2Panierin-progress
  • 3Paiementneeds a decision
  • 4Espace clientplanned

Phase 1

Fonder

La stack est décidée par écrit, le projet échafaudé, le kit installé : garde-fous de l'agent, hooks git, CI et protection des branches, avant la première ligne de code métier.

Porte : Un projet vide passe verify, en local et en CI.

CI, pull request #1

  • verify34 s
  • secrets9 s
  • origine3 s

main protégéedevelop protégée

Phase 2

Construire

Une feature à la fois, sur sa branche. Des tests verts ne suffisent pas : /check verify fait tourner l'application et constate chaque critère avant que la pull request parte.

Porte : Chaque critère d'acceptation est constaté sur l'application qui tourne.

/check verify panier

  • Ajouter un produit au panier
  • Changer la quantité
  • Refuser une quantité au-delà du stock

3 critères sur 3 constatés sur l'application

Phase 3

Livrer

Revue d'ensemble sur un regard neuf, revue de sécurité, parcours complets constatés sur l'aperçu. Puis develop rejoint main, par pull request, et c'est toi qui fusionnes.

Porte : Les parcours critiques sont vérifiés, aucun constat critique n'est ouvert.

Pull request #12

Mise en production : panier et paiement

develop → main

  • verify
  • secrets
  • origine
  • parcours client constaté
Fusionner

Phase 4

Exploiter

Erreurs, journaux et analytique dès le premier jour. Un cache, une file ou une réplique n'entrent qu'avec la mesure qui les justifie, citée dans leur spec.

Porte : On mesure avant d'ajouter la moindre brique.

p95, liste des commandes

280 ms

seuil fixé : 300 ms

Sous le seuil : aucune brique à ajouter (MF-014).

règles codées, chacune avec ce qui la fait respecter
17règles codées, chacune avec ce qui la fait respecter
phases, chacune fermée par une porte vérifiable
5phases, chacune fermée par une porte vérifiable
paliers d'exigence, du prototype à la production
4paliers d'exigence, du prototype à la production
fichiers dans le kit, installés sans rien écraser
11fichiers dans le kit, installés sans rien écraser
Installer

Une commande, dans n'importe quel agent

Avec Claude Code

Une fois par machine
/plugin marketplace add maedow-arch/maedow-flow#main/plugin install maedow-flow@maedow-flownpx skills add JavaScript-Mastery-Pro/skills

Le skill /flow installe le kit, /flow controler vérifie qu'un projet le respecte encore.

Avec un autre agent

Dans le dossier du projet
curl -fsSL https://maedow-flow.vercel.app/flow.mjs -o flow.mjsnode flow.mjs installerrm flow.mjs

Le même kit, sans plugin. Rien n'est écrasé : ce qui existe reste en place.

FAQ

Ce que Maedow Flow n'est pas

Les questions qui reviennent, répondues sans détour.

Une autre question ?

Le corpus y répond, page par page.

Lire la documentation
Maedow Flow choisit-il la stack à ma place ?

Non. Ce n'est pas un générateur d'application : il fournit des défauts éprouvés que /architect discute projet par projet.

Remplace-t-il les skills de Claude Code ?

Non. Les skills de JavaScript-Mastery-Pro sont le moteur ; Maedow Flow les ordonne et comble ce qu'ils ne couvrent pas : les règles non négociables, les garde-fous mécaniques, les défauts de plateforme.

Les règles sont-elles figées ?

Non. Une règle qui résiste à la réalité se corrige, et la correction prend une ligne au CHANGELOG.md qui dit pourquoi.

Qui décide, l'agent ou moi ?

Toi. Le product owner (l'humain) décide du produit, valide le scope et les specs, et fusionne les pull requests ; l'agent cadre ou construit, mais ne tranche pas à ta place.

Le site peut-il se périmer par rapport au corpus ?

Non. Tout ce qu'il affiche est dérivé de corpus/*.md par site/scripts/sync.mjs à chaque publication ; rien n'est recopié à la main.

Commencer

Prêt à cadrer ton prochain projet ?

Le premier message à donner à ton agent, dans un dossier vide ou un projet existant : Claude Code, Cursor, Codex ou tout agent qui dispose d'un terminal.

Prompt d'amorçage
Ce projet suit Maedow Flow. Avant toute action, lis le corpus en texte brut :curl -fsSL https://maedow-flow.vercel.app/llms-full.txtApplique ensuite la procédure de la page Démarrer qui correspond à ce dossier(nouveau projet ou projet existant). N'écris aucun code applicatif tant que jen'ai pas validé le scope et la stack.L'idée : <pour qui, quel problème, et ce qui prouvera que ça marche>