Aller au contenu principal
REALIZED.DEV
Réserver un atelier

Référence · Architecture

Guide d'architecture

Une référence unique sur la structure de l'usine logicielle, ce que fait et ne fait pas chaque couche, et la correspondance avec un engagement.

Mis à jour le 12 octobre 2026

Définitions

Usine logicielle
Des agents qui écrivent spécifications, tests et code dans vos dépôts, selon des règles qui exigent une revue humaine avant toute fusion.
Spec is Law
La spécification acceptée, pas le modèle, détient l'autonomie. Aucune implémentation sans spécification acceptée et test en échec.
Le harness
Le harness Realized : commandes, règles, sous-agents, hooks qui vérifient les actions des agents et scripts de bootstrap pour Cursor. Une publication du harness est à l'étude.
Engagement
Notre travail commercial par phases : Atelier de découverte, Pilote borné, Engagement de réalisation.

Les quatre couches

CoucheCe qu'elle faitCe qu'elle ne fait pas
L1 Substrat de gouvernanceVérifications de politique et liaison d'identité. Les agents ouvrent des pull requests en brouillon ; une personne approuve chaque fusion.Le retour arrière consiste à annuler la fusion.
L2 Actuation bornéeAppels d'outils typés et autorisés vers les systèmes de référence.Conçue pour éviter les écritures libres.
L3 Maillage d'orchestrationCoordonne les sous-agents sur la boucle. Les exécutions locales sont configurées pour lancer au maximum 8 sous-agents à la fois.Ce réglage concerne uniquement les sous-agents locaux, pas les agents cloud.
L4 ModèlesLes modèles que vous apportez, depuis votre configuration Cursor.Nous ne livrons ni modèle ni runtime et ne gardons aucun identifiant dans le dépôt.

Couche, boucle et phase

Chaque étape appartient à une couche. L'Atelier de découverte cadre la boucle, le Pilote borné l'exécute de bout en bout pour un workflow dans un environnement, et l'Engagement de réalisation l'étend à d'autres workflows.

ÉtapeCoucheCe qui se passePremière exécution
SpécificationL1 Substrat de gouvernanceUne personne écrit ou approuve le ticket et ses critères d'acceptation.Atelier de découverte (cadrage)
Tests d'abordL2 Actuation bornéeL'agent écrit des tests en échec à partir de ces critères.Pilote borné
Exécution de l'agentL2 Actuation bornéeUn agent cloud ouvre une pull request en brouillon, puis y enregistre son travail.Pilote borné
Vérifications automatiséesL3 Maillage d'orchestrationL'agent exécute les tests avant de pousser, et une vérification de revue de code est effectuée sur le changement ; les constats sont consignés sur la pull request.Pilote borné
QAL3 Maillage d'orchestrationUn agent QA vérifie la prévisualisation et consigne un verdict prêt ou à signaler sur la pull request.Pilote borné
Approbation humaineL1 Substrat de gouvernanceUne personne relit et approuve chaque fusion.Pilote borné

Workflow du harness

Spécifications, tâches et constats vivent dans docs/ de votre dépôt Git. Chaque critère d'acceptation passe par Red → Green → Refactor dans des sous-agents séparés : le test est écrit avant le code qu'il vérifie.

Les sous-agents locaux tournent par vagues de 8 au maximum. Les agents ouvrent des pull requests en brouillon. Ils ne peuvent pas fusionner : une personne relit et fusionne chaque changement, rien ne fusionne automatiquement, et le retour arrière consiste à annuler la fusion.

Où le travail s'exécute

Dans vos propres dépôts et votre chaîne d'outils, avec Cursor. Realized.dev n'héberge ni runtime ni modèle. La piste d'audit est votre historique Git.

Modèle de coûts

Vous apportez vos propres modèles. L'usage est facturé directement par votre fournisseur de modèles ; nous n'ajoutons aucune marge sur les tokens. Nos honoraires figurent sur la page Tarifs.

D'où viennent les chiffres

ChiffreTypeSource
4 couchesConceptionL'architecture décrite sur cette page.
8 sous-agents à la foisRéglage configuréLes exécutions locales sont configurées pour lancer au maximum 8 sous-agents à la fois. Ne concerne pas les agents cloud.
90 minutesFormat fixeDurée de l'Atelier de découverte.

Questions

Les agents peuvent-ils fusionner du code ?
Non. Ils ouvrent des pull requests en brouillon. Une personne relit et fusionne chaque changement ; rien ne fusionne automatiquement.
Comment annuler un changement ?
En annulant la fusion dans Git.
Realized.dev héberge-t-il un modèle ou un runtime ?
Non. Le travail s'exécute dans vos dépôts avec Cursor et vos modèles.
Combien de sous-agents en parallèle ?
Les exécutions locales sont configurées pour lancer au maximum 8 sous-agents à la fois. Cela ne concerne pas les agents cloud.
Qui paie l'usage des modèles ?
Vous, directement auprès de votre fournisseur. Aucune marge de notre part sur les tokens.
Le harness est-il open source ?
Une publication du harness est à l'étude.
Où vivent les spécifications ?
Dans docs/ de votre dépôt Git, avec les tâches et les constats.