Votre usine logicielle IA, sur les machines de votre choix
Confiez vos changements à des agents de développement et gardez la main sur les décisions. Susan lance chaque workflow dans son propre conteneur, suit chaque run (une exécution d'un workflow) dans un seul tableau de bord, et s'arrête pour interroger une personne de votre équipe quand un choix se présente. Elle tourne aujourd'hui sur votre ordinateur, et bientôt sur le homelab que partage votre équipe.
Essayer sur votre posteou sur votre homelab
Usine logicielle IA · Open source sous licence Apache 2.0
Un agent dans un terminal ne fait pas une usine
Un agent dans votre terminal
- Il s’arrête dès que vous fermez le terminal ou que votre portable se met en veille.
- Sa question attend dans une fenêtre que personne ne regarde.
- Ensuite, personne ne peut dire ce qu’il a fait ni ce qu’il a coûté en jetons.
Le même travail dans Susan
- Chaque run vit dans son propre conteneur, indépendant de votre terminal.
- Sa question apparaît dans la vue « À traiter par vous », et le run reprend dès que vous répondez.
- Chaque run garde son issue et les jetons consommés, modèle par modèle.
Ce que votre équipe y gagne
Une chaîne de production pour vos changements
Confiez des changes OpenSpec (une proposition, une conception et une liste de tâches écrites). Les workflows factory en appliquent plusieurs en parallèle, un worktree git chacun, écrivent le test avant le code de chaque tâche, puis les fusionnent un par un et lancent votre test de bout en bout.
Tous les runs au même endroit
Le tableau de bord liste les runs de tous vos projets avec leur état : en file, en cours, terminé, en échec, annulé ou perdu.
Les questions arrivent à une personne
Quand un run a besoin d’une décision, il la demande et s’arrête. Votre réponse lance un nouveau run qui repart de là.
Un conteneur par run
Chaque run travaille à part des autres : un conteneur Docker sur un poste, un pod avec du TLS mutuel et une politique réseau sur un cluster.
Comment ça marche
Installer la suite
Une commande télécharge les images et démarre le tableau de bord et l’opérateur sur votre ordinateur.
Confier le travail
Lancez un run depuis le tableau de bord, sur un item (une unité de travail d’un de vos projets).
Décider et relire
Répondez aux questions qui vous attendent. Le run reprend, et vous relisez ce qu’il a produit.
La façon de travailler recommandée : openspec-tdd
openspec-tdd fait suivre à chaque changement un chemin court et contrôlé. Vous l'écrivez avant que quiconque le code, un regard neuf le relit, une personne l'accepte, et le code se construit en commençant par les tests. L'image des runs embarque ses workflows AWF, et ses commandes /flow les pilotent depuis Claude Code.
Explorer l'idée
Mûrissez-la avec le code sous les yeux. Des relecteurs Elephant Goldfish Model (EGM), des agents neufs qui n’ont rien de votre contexte, la mettent à l’épreuve, et la direction retenue devient une note de cadrage.
Proposer le changement
Un agent rédige le change OpenSpec (proposition, conception, spécifications et tâches) dans son propre worktree git. Des contrôles vérifient son périmètre, la validation stricte, les deltas de spécifications et la Definition of Done avant le commit.
Relire avec un regard neuf
Sept relecteurs EGM, chacun en lecture seule, lisent le change. Leurs points bloquants vous reviennent, et vous tranchez chaque remarque avant l’étape suivante.
L'accepter vous-même
Votre acceptation est consignée avec votre nom, la date et une empreinte de la Definition of Done, et le change rejoint main sans être poussé. Aucun agent n’intervient.
Le construire test d'abord
Chaque tranche de code passe par RED (un test qui échoue), GREEN (le code qui le fait passer) et une relecture, dans le worktree du change. Plusieurs changes peuvent avancer en parallèle.
Archiver ce qui est fait
Une fois toutes les tâches cochées, les deltas rejoignent les spécifications principales, la Definition of Done se rejoue, et le change est archivé.
Vous seul pouvez lever un contrôle, avec une raison, pour 30 jours au plus. Voir openspec-tdd sur GitHub
Prêt dès le premier run
L'image des runs embarque deux packs de workflows AWF, pour qu'un premier run applique déjà un change.
openspec-tdd
La façon de travailler décrite plus haut, de la proposition OpenSpec jusqu'au code, avec une relecture EGM de la conception et un test avant chaque morceau de code.
factory
Applique plusieurs changes OpenSpec en parallèle, un worktree git par change, les fusionne un par un et écrit un rapport JSON.
Une suite pour toutes les équipes
Commencez seul sur votre ordinateur, puis partagez un homelab avec votre équipe. Les deux configurations font tourner le même tableau de bord, le même opérateur et les mêmes workflows ; seul change le moteur qui lance chaque run.
Poste unique
Un développeur seul
Pour un développeur seul : suivez tous vos projets et lancez des workflows dans Docker sur votre ordinateur.
Bientôt disponibleHomelab
Une équipe qui partage quelques machines
Pour une équipe qui partage quelques machines : un cluster Kubernetes minimal sur MicroK8s, installé avec Ansible.
Ce qui reste chez vous
- Vos dépôts
- Sur votre forge Git
- Vos secrets et les journaux des runs
- Sur les machines qui font tourner Susan
- Les consignes et les extraits de code que lit un agent
- Envoyés au fournisseur du modèle d'IA que vous configurez, quand c'est un modèle cloud
Questions
De quoi ai-je besoin pour essayer ?
Docker avec Compose v2, curl, et le port 8090 libre sur 127.0.0.1. La forge est facultative : branchez une forge Forgejo ou Gitea pour suivre les pull requests.
Susan fournit-elle un modèle d'IA ?
Non. Les workflows appellent l’agent et le modèle que vous configurez. Avec un modèle cloud, les consignes et les extraits de code que lit l’agent partent chez le fournisseur de ce modèle.
Est-ce que ça marche avec mon langage ?
Les workflows factory lancent les commandes de test que vous écrivez dans .awf/factory.json. Tout langage dont l’outil de test écrit un rapport JUnit convient.
Que se passe-t-il quand mon ordinateur redémarre ?
Docker relance le tableau de bord et l’opérateur. Les runs, la base du tableau de bord et les clés restent dans des volumes Docker. Un run dont le conteneur a disparu passe à lost.
Comment la retirer ?
Dans le dossier .susan de votre dossier personnel, lancez docker compose down -v, puis supprimez le dossier. Les runs encore en cours gardent leurs conteneurs : retirez-les d’abord.
Toute mon équipe peut-elle l'utiliser ?
Sur un poste, le tableau de bord n’écoute que sur 127.0.0.1. La configuration homelab, un cluster MicroK8s partagé par une équipe, arrive bientôt.
Et si notre équipe dépasse un homelab ?
Susan couvre un poste unique et un homelab de quelques machines. Au-delà, une plateforme gérée d’un fournisseur cloud convient mieux.
Le tableau de bord est-il en anglais ?
Pas encore : l’interface du tableau de bord est en français aujourd’hui. Ce site existe en anglais et en français.
Est-ce gratuit ?
Oui. Susan est publiée sous licence Apache 2.0. Elle exécute les workflows avec AWF, un projet distinct publié sous sa propre licence.
Quelqu'un peut-il l'exploiter pour nous ?
Oui, en France. Voyez Exploité pour vous.
Démarrez votre usine logicielle IA aujourd'hui
Gratuit et open source. Commencez sur votre ordinateur, et faites entrer votre équipe quand elle est prête.