role-os 2.7.1 → 2.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +20 -0
- package/README.es.md +7 -0
- package/README.fr.md +124 -117
- package/README.hi.md +119 -112
- package/README.it.md +7 -0
- package/README.ja.md +7 -0
- package/README.md +7 -0
- package/README.pt-BR.md +7 -0
- package/README.zh.md +130 -123
- package/package.json +1 -1
- package/src/hooks.mjs +125 -14
- package/src/specialist/capability-gate.mjs +124 -0
- package/src/specialist/conformance-consult.mjs +322 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,25 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.8.0
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
- **Capability gate — deterministic least-privilege on irreversible tool calls.**
|
|
7
|
+
`src/specialist/capability-gate.mjs`: a gated set of irreversible / world-touching actions
|
|
8
|
+
(npm/PyPI publish, `gh release` / `pr` / `repo edit`, `git push`, Pages deploy), a director-authored
|
|
9
|
+
`.claude/role-os/capabilities.json` grant manifest, and `capabilityGate()`. Opt-in
|
|
10
|
+
(`ROLEOS_CAPABILITY_GATE`, default OFF → pure no-op), **fail-closed** for the gated set, deterministic
|
|
11
|
+
(no model). Wired into `onPreToolUse` (deny path) + the generated PreToolUse hook (exit 2), alongside
|
|
12
|
+
the advisory / fail-open conformance floor. Bounds what a wrong verdict — an honest mistake or an
|
|
13
|
+
injected one — can DO; the preventive complement to the named-compensator rule (POLA / CaMeL).
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
- **Wedge #1 conformance — live tool-contracts catalog rollout.** The deterministic schema + computable-
|
|
17
|
+
contract floor runs at the live `onPreToolUse` seam against `.claude/role-os/tool-contracts.json`
|
|
18
|
+
(advisory, fail-open), and generated hook scripts emit the current Claude Code wire protocol
|
|
19
|
+
(`hookSpecificOutput.additionalContext` + exit 0).
|
|
20
|
+
|
|
21
|
+
(Full suite 1400 tests green.)
|
|
22
|
+
|
|
3
23
|
## 2.7.1
|
|
4
24
|
|
|
5
25
|
### Docs
|
package/README.es.md
CHANGED
|
@@ -89,6 +89,13 @@ Las ejecuciones se guardan en el disco (`.claude/runs/`), por lo que las sesione
|
|
|
89
89
|
|
|
90
90
|
Role OS puede consultar a un **analista de presupuesto de tokens** local en cada paso de la distribución y adjuntar una previsión de gasto orientativa al manifiesto: opcional (`ROLEOS_BUDGET_CONSULT`), orientativa (nunca bloquea una distribución) y con un mecanismo de seguridad que vuelve a una línea de base determinista. Desactivado por defecto; la previsión es local y gratuita. Consulte el [manual](https://mcp-tool-shop-org.github.io/role-os/handbook/specialist-budget/).
|
|
91
91
|
|
|
92
|
+
## Supervisión de las llamadas a herramientas
|
|
93
|
+
|
|
94
|
+
El sistema operativo (OS) del rol verifica y controla las llamadas a herramientas en el punto `PreToolUse` de forma determinista, sin utilizar ningún modelo en la ruta principal:
|
|
95
|
+
|
|
96
|
+
- **Monitor de conformidad** (asesoramiento, falla abierta): un esquema determinista + una verificación del contrato computable comprueba una llamada propuesta con su contrato de herramienta catalogado y adjunta un veredicto asesor sobre una llamada *comprobada* como no conforme; nunca bloquea. Un límite opcional para el modelo lingüístico grande (LLM) (`ROLEOS_CONFORMANCE_CONSULT`) gestiona los residuos genuinamente semánticos.
|
|
97
|
+
- **Control de capacidad** (falla cerrada, opcional `ROLEOS_CAPABILITY_GATE`, desactivado por defecto): control determinista del privilegio mínimo en las acciones *irreversibles* (publicación en npm/PyPI, `gh release`, `git push`, edición de repositorios, despliegue de Páginas). Una acción controlada se deniega a menos que el administrador haya concedido su capacidad en `.claude/role-os/capabilities.json`, por lo que un paso incorrecto (un error honesto o uno inyectado) no puede desencadenar una acción irreversible no autorizada. El complemento preventivo de la regla del compensador con nombre. Consulte el [manual](https://mcp-tool-shop-org.github.io/role-os/handbook/).
|
|
98
|
+
|
|
92
99
|
## Estado de la implementación a nivel de organización
|
|
93
100
|
|
|
94
101
|
El estado de la implementación a nivel de organización (cola, decisiones, registros de auditoría, paquetes de bloqueo por repositorio) se encuentra en un repositorio privado independiente: [`role-os-rollout`](https://github.com/mcp-tool-shop-org/role-os-rollout). Este repositorio es el producto; ese repositorio es el estado operativo.
|
package/README.fr.md
CHANGED
|
@@ -13,16 +13,16 @@
|
|
|
13
13
|
<a href="https://mcp-tool-shop-org.github.io/role-os/"><img src="https://img.shields.io/badge/Landing_Page-live-brightgreen" alt="Landing Page"></a>
|
|
14
14
|
</p>
|
|
15
15
|
|
|
16
|
-
Un système d’exploitation multi-Claude qui affecte du personnel,
|
|
16
|
+
Un système d’exploitation multi-Claude qui affecte du personnel, répartit les tâches, valide et exécute le travail à travers 61 contrats de rôles spécialisés. Il crée des ensembles de tâches, assemble l’équipe appropriée en fonction de critères définis, détecte les problèmes avant l’exécution, redirige automatiquement vers une solution lorsque le travail est bloqué ou rejeté, et exige des preuves structurées pour chaque décision. Il comprend une répartition dynamique pour les missions à grande échelle — un dépôt de 10 composants devient automatiquement 28 étapes d’audit, au lieu de 6.
|
|
17
17
|
|
|
18
18
|
## Ce qu’il fait
|
|
19
19
|
|
|
20
|
-
Role OS est la méthode professionnelle pour utiliser multi-Claude. Il prévient les défaillances spécifiques que les flux de travail d’IA génériques
|
|
20
|
+
Role OS est la méthode professionnelle pour utiliser multi-Claude. Il prévient les défaillances spécifiques que produisent les flux de travail d’IA génériques :
|
|
21
21
|
|
|
22
|
-
- **Dérive** — les rôles restent dans leur domaine d’
|
|
23
|
-
- **Achèvement incorrect** — la définition de
|
|
22
|
+
- **Dérive** — les rôles restent dans leur domaine d’expertise. Le produit ne se redéfinit pas. L’interface utilisateur ne redéfinit pas la portée. La partie serveur n’invente pas l’orientation du produit.
|
|
23
|
+
- **Achèvement incorrect** — la définition de ce qui est terminé est précise. Le travail qui dissimule des lacunes, omet des vérifications ou résout un problème différent est rejeté.
|
|
24
24
|
- **Contamination** — les projets dérivés ou hérités conservent des éléments d’identité. Role OS détecte et rejette la dérive inter-projets en termes de terminologie, d’éléments visuels et de modèles mentaux.
|
|
25
|
-
- **Progrès basé sur
|
|
25
|
+
- **Progrès basé sur le ressenti** — chaque transfert est structuré. Chaque décision est liée à des preuves. « Ça a l’air terminé » n’est pas un état valide.
|
|
26
26
|
|
|
27
27
|
## Comment il fonctionne
|
|
28
28
|
|
|
@@ -45,10 +45,10 @@ roleos start "something completely novel"
|
|
|
45
45
|
**L’échelle de repli :**
|
|
46
46
|
|
|
47
47
|
1. **Mission** — lorsque la tâche correspond à un flux de travail récurrent et éprouvé (correction de bug, traitement, lancement de fonctionnalité, documentation, sécurité, recherche, brainstorming, audit approfondi, test en conditions réelles). Chaîne de rôles connue, flux d’artefacts, branches d’escalade et définitions honnêtes et partielles.
|
|
48
|
-
2. **
|
|
49
|
-
3. **
|
|
48
|
+
2. **Ensemble** — lorsque la tâche appartient à une famille connue mais ne correspond pas entièrement à un modèle de mission. 10 ensembles d’équipes calibrées avec sélection automatique et protections contre les incompatibilités.
|
|
49
|
+
3. **Répartition libre** — lorsque la tâche est nouvelle, mixte ou incertaine. Évalue tous les 61 rôles par rapport au contenu de l’ensemble et assemble une chaîne dynamique.
|
|
50
50
|
|
|
51
|
-
Le système ne force jamais
|
|
51
|
+
Le système ne force jamais le travail à travers une abstraction incorrecte. Il explique pourquoi il a choisi chaque niveau et propose des alternatives.
|
|
52
52
|
|
|
53
53
|
**Une seule commande pour lancer l’exécution :**
|
|
54
54
|
|
|
@@ -77,52 +77,59 @@ roleos block 2 "waiting for API spec"
|
|
|
77
77
|
roleos reopen 0 "found issue in review"
|
|
78
78
|
```
|
|
79
79
|
|
|
80
|
-
Les exécutions sont conservées sur le disque (`.claude/runs/`), de sorte que les sessions interrompues reprennent
|
|
80
|
+
Les exécutions sont conservées sur le disque (`.claude/runs/`), de sorte que les sessions interrompues reprennent sans problème. Chaque étape comprend des instructions pour l’opérateur : ce qui doit être produit, les sections requises et les conditions d’arrêt.
|
|
81
81
|
|
|
82
|
-
**Une fois la tâche
|
|
82
|
+
**Une fois la tâche répartie :**
|
|
83
83
|
|
|
84
84
|
1. **Chaque rôle produit un transfert** — une sortie structurée avec des éléments de preuve qui réduisent l’ambiguïté pour le rôle suivant.
|
|
85
|
-
2. **Un critique examine par rapport au contrat** — accepte, rejette ou bloque en fonction de preuves structurées, et non d’une
|
|
86
|
-
3. **
|
|
85
|
+
2. **Un critique examine par rapport au contrat** — accepte, rejette ou bloque en fonction de preuves structurées, et non d’une impression.
|
|
86
|
+
3. **La reprise se fait automatiquement** — le travail bloqué ou rejeté est redirigé vers la personne responsable avec une explication, un type de reprise et l’artefact requis.
|
|
87
87
|
|
|
88
88
|
## Répartition tenant compte du budget
|
|
89
89
|
|
|
90
|
-
Role OS peut consulter un **analyste de budget de jetons** local pour chaque étape de répartition et joindre une prévision de dépenses indicative au manifeste — optionnel (`ROLEOS_BUDGET_CONSULT`),
|
|
90
|
+
Role OS peut consulter un **analyste de budget de jetons** local pour chaque étape de répartition et joindre une prévision de dépenses indicative au manifeste — optionnel (`ROLEOS_BUDGET_CONSULT`), indicatif (il ne bloque jamais une répartition) et en cas d’échec, il revient à une base de référence déterministe. Désactivé par défaut ; la prévision est locale et gratuite. Voir le [manuel](https://mcp-tool-shop-org.github.io/role-os/handbook/specialist-budget/).
|
|
91
91
|
|
|
92
|
-
##
|
|
92
|
+
## Supervision des appels d’outils
|
|
93
93
|
|
|
94
|
-
|
|
94
|
+
Role OS vérifie et contrôle les appels d’outils au niveau de `PreToolUse` — de manière déterministe, sans modèle sur le chemin critique :
|
|
95
|
+
|
|
96
|
+
- **Surveillance de la conformité** (indicatif, en cas d’échec, il revient à une base de référence) — un schéma déterministe + des seuils de contrat calculables vérifient un appel proposé par rapport à son contrat d’outil catalogué et joignent une évaluation indicative sur un appel *manifestement* non conforme ; il ne bloque jamais. Un plafond LLM optionnel (`ROLEOS_CONFORMANCE_CONSULT`) gère les éléments sémantiques restants.
|
|
97
|
+
- **Contrôle des capacités** (en cas d’échec, optionnel `ROLEOS_CAPABILITY_GATE`, désactivé par défaut) — privilèges minimums déterministes sur les actions *irréversibles* (publication npm/PyPI, `gh release`, `git push`, modifications du dépôt, déploiement de Pages). Une action contrôlée est refusée à moins que le responsable n’ait accordé sa capacité dans `.claude/role-os/capabilities.json`, de sorte qu’une étape incorrecte — une erreur honnête ou une injection malveillante — ne puisse pas déclencher une action irréversible non autorisée. Le complément préventif à la règle du compensateur nommé. Voir le [manuel](https://mcp-tool-shop-org.github.io/role-os/handbook/).
|
|
98
|
+
|
|
99
|
+
## État de déploiement au niveau de l’organisation
|
|
100
|
+
|
|
101
|
+
L’état de déploiement à l’échelle de l’organisation (file d’attente, décisions, enregistrements d’audit, ensembles de verrouillage par dépôt) est stocké dans un dépôt privé distinct : [`role-os-rollout`](https://github.com/mcp-tool-shop-org/role-os-rollout). Ce dépôt est le produit ; ce dépôt est l’état opérationnel.
|
|
95
102
|
|
|
96
103
|
## Mémoire et continuité
|
|
97
104
|
|
|
98
|
-
Role OS ne possède ni ne duplique la couche de mémoire. Là où la mémoire du projet Claude existe, c’est le système de continuité canonique — les faits du dépôt, les décisions, les points en suspens et l’historique
|
|
105
|
+
Role OS ne possède ni ne duplique la couche de mémoire. Là où la mémoire du projet Claude existe, c’est le système de continuité canonique — les faits du dépôt, les décisions, les points en suspens et l’historique des traitements s’y trouvent.
|
|
99
106
|
|
|
100
107
|
Role OS s’intègre à la mémoire du projet Claude. Il ne la remplace pas.
|
|
101
108
|
|
|
102
|
-
## Traitement complet et vérification
|
|
109
|
+
## Traitement complet et vérification finale
|
|
103
110
|
|
|
104
|
-
Le traitement complet est un protocole canonique en 7 phases défini dans la mémoire du projet Claude (`memory/full-treatment.md`). Role OS
|
|
111
|
+
Le traitement complet est un protocole canonique en 7 phases défini dans la mémoire du projet Claude (`memory/full-treatment.md`). Role OS répartit et examine les traitements à l’aide de contrats de rôles, de transferts et de contrôles critiques — il ne redéfinit pas le protocole.
|
|
105
112
|
|
|
106
|
-
La **vérification
|
|
113
|
+
La **vérification finale** est la grille de qualité en 31 éléments qui s’exécute avant le traitement complet. Les étapes A à D doivent être franchies avant que tout traitement ne commence. Référence canonique : `memory/shipcheck.md`.
|
|
107
114
|
|
|
108
|
-
Ordre : vérification
|
|
115
|
+
Ordre : vérification finale d’abord, puis traitement complet. Pas de version 1.0.0 sans avoir réussi les étapes obligatoires.
|
|
109
116
|
|
|
110
|
-
## 61
|
|
117
|
+
## 61 rôles répartis en 10 ensembles
|
|
111
118
|
|
|
112
|
-
|
|
|
119
|
+
| Ensemble | Rôles |
|
|
113
120
|
|------|-------|
|
|
114
121
|
| **Core** (3) | Orchestrateur, stratège produit, critique |
|
|
115
|
-
| **Engineering** (7) | Développeur frontend, ingénieur backend, ingénieur de test, ingénieur de
|
|
122
|
+
| **Engineering** (7) | Développeur frontend, ingénieur backend, ingénieur de test, ingénieur de refactoring, ingénieur de performance, auditeur des dépendances, examinateur de sécurité |
|
|
116
123
|
| **Design** (2) | Concepteur d’interface utilisateur, gardien de la marque |
|
|
117
|
-
| **Marketing** (1) | Rédacteur
|
|
118
|
-
| **Treatment** (7) | Chercheur
|
|
124
|
+
| **Marketing** (1) | Rédacteur pour les lancements |
|
|
125
|
+
| **Treatment** (7) | Chercheur sur les dépôts, traducteur pour les dépôts, architecte de la documentation, conservateur des métadonnées, auditeur de la couverture, vérificateur du déploiement, ingénieur en charge des versions |
|
|
119
126
|
| **Product** (3) | Synthétiseur de commentaires, priorisateur de feuille de route, rédacteur de spécifications |
|
|
120
|
-
| **Research** (4) | Chercheur UX, analyste concurrentiel, chercheur
|
|
121
|
-
| **Growth** (4) | Stratège
|
|
122
|
-
| **Deep Audit** (4) | Auditeur
|
|
123
|
-
| **Swarm** (7) | Coordinateur de l
|
|
127
|
+
| **Research** (4) | Chercheur UX, analyste concurrentiel, chercheur sur les tendances, synthétiseur d’entretiens avec les utilisateurs |
|
|
128
|
+
| **Growth** (4) | Stratège pour les lancements, stratège en matière de contenu, responsable de la communauté, responsable du tri des demandes d’assistance |
|
|
129
|
+
| **Deep Audit** (4) | Auditeur des composants, auditeur de la véracité des tests, auditeur des interfaces, synthétiseur d’audits |
|
|
130
|
+
| **Swarm** (7) | Coordinateur de l’essaim, agent backend de l’essaim, agent de pont de l’essaim, agent de test de l’essaim, agent d’infrastructure de l’essaim, agent frontend de l’essaim, synthétiseur de l’essaim |
|
|
124
131
|
|
|
125
|
-
Chaque rôle
|
|
132
|
+
Chaque rôle est associé à un contrat complet : mission, cas d’utilisation, moments où il ne doit pas être utilisé, entrées attendues, sorties requises, niveau de qualité et déclencheurs d’escalade. Chaque rôle peut être affecté — `roleos route` peut en recommander n’importe lequel en fonction du contenu du paquet.
|
|
126
133
|
|
|
127
134
|
## Démarrage rapide
|
|
128
135
|
|
|
@@ -165,52 +172,52 @@ roleos packs list
|
|
|
165
172
|
|
|
166
173
|
## Quand ne pas utiliser Role OS
|
|
167
174
|
|
|
168
|
-
- Corrections
|
|
175
|
+
- Corrections sur une seule ligne, fautes de frappe ou bogues évidents
|
|
169
176
|
- Recherche exploratoire sans résultat défini
|
|
170
|
-
- Travail qui
|
|
171
|
-
-
|
|
172
|
-
- Projets où la rapidité
|
|
177
|
+
- Travail qui peut être réalisé par une personne en 5 minutes
|
|
178
|
+
- Correctifs d’urgence qui doivent être déployés avant la fin du processus d’examen
|
|
179
|
+
- Projets où vous privilégiez la rapidité à la structure
|
|
173
180
|
|
|
174
181
|
## Preuves
|
|
175
182
|
|
|
176
|
-
Role OS a été testé avec trois
|
|
183
|
+
Role OS a été testé avec trois types de projets différents dans deux dépôts structurellement différents :
|
|
177
184
|
|
|
178
|
-
**
|
|
185
|
+
**Projet 001 — Travail sur une fonctionnalité** (écran Crew, Star Freight)
|
|
179
186
|
- Chaîne de 7 rôles, 45 scénarios de test, 0 conflits de rôles
|
|
180
|
-
-
|
|
187
|
+
- A empêché la contamination provenant d’un ancêtre du fork, a détecté une invention en ligne et a mis en évidence les blocages réels
|
|
181
188
|
|
|
182
|
-
**
|
|
183
|
-
- Chaîne de 5 rôles,
|
|
184
|
-
- Les tests anti-contournement
|
|
189
|
+
**Projet 002 — Travail d’intégration** (liaison CampaignState, Star Freight)
|
|
190
|
+
- Chaîne de 5 rôles, a résolu un problème architectural sans recourir à des solutions de contournement
|
|
191
|
+
- Les tests anti-contournement ont prouvé que le chemin actif est réel et non un simple espace réservé
|
|
185
192
|
|
|
186
|
-
**
|
|
187
|
-
- Chaîne de 6 rôles, 51 scénarios de test, y compris une défense durable contre la contamination dans
|
|
188
|
-
-
|
|
193
|
+
**Projet 003 — Travail sur l’identité** (suppression de la contamination, Star Freight)
|
|
194
|
+
- Chaîne de 6 rôles, 51 scénarios de test, y compris une défense durable contre la contamination dans le CI
|
|
195
|
+
- A corrigé les incohérences héritées sans entraîner une refonte importante
|
|
189
196
|
|
|
190
|
-
**Test de portabilité** (cohérence
|
|
191
|
-
- Même structure
|
|
192
|
-
-
|
|
197
|
+
**Test de portabilité** (cohérence des personas, humour sensoriel)
|
|
198
|
+
- Même structure, langue/domaine/pile différents
|
|
199
|
+
- Adopté avec seulement des modifications contextuelles — aucune modification du contrat principal
|
|
193
200
|
|
|
194
201
|
**Traitement complet FT-001** (portlight-desktop)
|
|
195
|
-
- Traitement en 7 phases avec les rôles du
|
|
196
|
-
- La validation
|
|
202
|
+
- Traitement en 7 phases avec les rôles du pack de traitement
|
|
203
|
+
- La validation avant le déploiement a été prouvée, aucun conflit de rôle
|
|
197
204
|
|
|
198
205
|
**Traitement complet FT-002** (studioflow)
|
|
199
|
-
- Même
|
|
200
|
-
- Le
|
|
206
|
+
- Même pack de traitement, dépôt structurellement différent (espace de travail créatif par rapport à un jeu)
|
|
207
|
+
- Le pack de traitement est portable — aucune modification du contrat n’est nécessaire
|
|
201
208
|
|
|
202
|
-
**Session de brainstorming réussie** (sujet du marché MCP)
|
|
203
|
-
- Chaîne de 9 rôles, 4 analystes en parallèle, examen croisé + réfutation du graphique des
|
|
204
|
-
- 4 défis lancés, 3 revendications affinées, 1 non
|
|
209
|
+
**Session de brainstorming réussie** (sujet du marché MCP server)
|
|
210
|
+
- Chaîne de 9 rôles, 4 analystes en parallèle, examen croisé + réfutation du graphique des désaccords
|
|
211
|
+
- 4 défis lancés, 3 revendications affinées, 1 non résolu — une pression saine, pas d’impasse
|
|
205
212
|
- Plus de 16 liens de traçabilité à partir des artefacts rendus vers les atomes de la couche de vérité
|
|
206
|
-
- Chaîne de traçabilité
|
|
213
|
+
- Chaîne complète de traçabilité prouvée : vérité → atomes → désaccord → synthèse → expansion → jugement → rendu → traçabilité
|
|
207
214
|
|
|
208
|
-
## Propriétés
|
|
215
|
+
## Propriétés principales
|
|
209
216
|
|
|
210
217
|
Elles sont non négociables. Si une modification affaiblit l’une d’entre elles, rejetez-la.
|
|
211
218
|
|
|
212
219
|
- Les limites des rôles sont respectées
|
|
213
|
-
-
|
|
220
|
+
- L’examen est rigoureux
|
|
214
221
|
- L’escalade reste honnête
|
|
215
222
|
- Les paquets restent testables
|
|
216
223
|
- La portabilité nécessite une adaptation contextuelle, et non une chirurgie du cœur
|
|
@@ -255,54 +262,54 @@ role-os/
|
|
|
255
262
|
|
|
256
263
|
## Sécurité
|
|
257
264
|
|
|
258
|
-
Role OS fonctionne **uniquement en local**. Il copie les modèles Markdown et écrit les fichiers de paquets/décisions dans le répertoire `.claude/` de votre
|
|
265
|
+
Role OS fonctionne **uniquement en local**. Il copie les modèles Markdown et écrit les fichiers de paquets/décisions dans le répertoire `.claude/` de votre dépôt. Il n’accède pas au réseau, ne gère pas les secrets et ne collecte pas de données de télémétrie. Aucune opération dangereuse — par défaut, toutes les écritures de fichiers utilisent l’option « ignorer si existant ». Consultez le fichier [SECURITY.md](SECURITY.md) pour connaître la politique complète.
|
|
259
266
|
|
|
260
267
|
## Le système d’exploitation
|
|
261
268
|
|
|
262
269
|
| Couche | Ce qu’il fait | Statut |
|
|
263
270
|
|-------|-------------|--------|
|
|
264
|
-
| **Routing** | Attribue un score à chacun des 61 rôles en fonction du contenu du paquet, explique les recommandations et évalue la confiance | ✓ Déployé |
|
|
265
|
-
| **Chain builder** | Assemble des chaînes ordonnées par phase à partir des rôles notés,
|
|
266
|
-
| **Conflict detection** | Validation en 4
|
|
267
|
-
| **Escalation** |
|
|
268
|
-
| **Evidence** | Preuves structurées
|
|
271
|
+
| **Routing** | Attribue un score à chacun des 61 rôles en fonction du contenu du paquet, explique les recommandations et évalue la confiance. | ✓ Déployé |
|
|
272
|
+
| **Chain builder** | Assemble des chaînes ordonnées par phase à partir des rôles notés, avec une préférence pour le type de paquet plutôt que pour un modèle prédéfini. | ✓ Déployé |
|
|
273
|
+
| **Conflict detection** | Validation en 4 étapes : conflits importants, séquence, redondance, lacunes de couverture. Suggestions de correction. | ✓ Déployé |
|
|
274
|
+
| **Escalation** | Achemine automatiquement les travaux bloqués/rejetés/divisés vers le bon résolveur avec une explication et l’artefact requis. | ✓ Déployé |
|
|
275
|
+
| **Evidence** | Preuves structurées tenant compte du rôle dans les décisions. Vérifications de suffisance. 12 types de preuves. | ✓ Déployé |
|
|
269
276
|
| **Dispatch** | Génère des manifestes d’exécution pour multi-claude. Profils d’outils par rôle, invites système, budgets. | ✓ Déployé |
|
|
270
|
-
| **Trials** | Ensemble complet prouvé : 30
|
|
271
|
-
| **Team Packs** | 10
|
|
272
|
-
| **Outcome calibration** | Enregistre les résultats
|
|
273
|
-
| **Mixed-task decomposition** | Détecte le travail composite,
|
|
274
|
-
| **Composite execution** | Exécute les paquets enfants dans l’ordre des dépendances
|
|
277
|
+
| **Trials** | Ensemble complet prouvé : 30/30 tâches réussies + 5/5 essais négatifs. 7 essais de pack terminés. | ✓ Terminé |
|
|
278
|
+
| **Team Packs** | 10 packs calibrés avec sélection automatique, protections contre les incompatibilités et repli en cas de routage libre. | ✓ Déployé |
|
|
279
|
+
| **Outcome calibration** | Enregistre les résultats des exécutions, ajuste les pondérations des packs/rôles à partir des résultats et modifie les seuils de confiance. | ✓ Déployé |
|
|
280
|
+
| **Mixed-task decomposition** | Détecte le travail composite, divise en paquets enfants, assigne des packs et conserve les dépendances. | ✓ Déployé |
|
|
281
|
+
| **Composite execution** | Exécute les paquets enfants dans l’ordre des dépendances avec transfert d’artefacts, récupération de branche et synthèse. | ✓ Déployé |
|
|
275
282
|
| **Adaptive replanning** | Les modifications de portée, les découvertes ou les nouvelles exigences en cours d’exécution mettent à jour le plan sans redémarrer. | ✓ Déployé |
|
|
276
283
|
| **Session spine** | `roleos init claude` crée les fichiers CLAUDE.md, /roleos-route, /roleos-review, /roleos-status. `roleos doctor` vérifie la configuration. Les cartes de routage prouvent l’engagement. | ✓ Déployé |
|
|
277
|
-
| **Hook spine** | 5 hooks
|
|
278
|
-
| **Artifact spine** | Contrats d’artefacts par rôle. Contrats de transfert de
|
|
279
|
-
| **Mission library** | 9
|
|
280
|
-
| **Mission runner** |
|
|
281
|
-
| **Unified entry** | `roleos start`
|
|
282
|
-
| **Persistent runs** | `roleos run` crée des exécutions stockées sur disque. `resume
|
|
283
|
-
| **Brainstorm** | Architecture à deux
|
|
284
|
-
| **Deep Audit** | Audit
|
|
285
|
-
| **Dogfood Swarm** | Convergence en plusieurs étapes : trois
|
|
286
|
-
|
|
287
|
-
## 9
|
|
288
|
-
|
|
289
|
-
| Mission |
|
|
284
|
+
| **Hook spine** | 5 hooks du cycle de vie (SessionStart, PromptSubmit, PreToolUse, SubagentStart, Stop). Application consultative : rappels sur les cartes de routage, validation avant l’utilisation des outils, injection du rôle d’un sous-agent, audit de la complétion. | ✓ Déployé |
|
|
285
|
+
| **Artifact spine** | Contrats d’artefacts par rôle. Contrats de transfert de pack. Validation structurelle. Vérifications de l’exhaustivité de la chaîne. Les rôles en aval ne devinent jamais ce qu’ils ont reçu. | ✓ Déployé |
|
|
286
|
+
| **Mission library** | 9 missions nommées (fonctionnalité principale, correction de bugs, traitement, publication de la documentation, renforcement de la sécurité, lancement d’une recherche, séance de brainstorming, audit approfondi, phase de test interne). Chacune définit le groupe, la chaîne de rôles, le flux des éléments, les branches d’escalade et une définition partielle mais précise. | ✓ Déployé |
|
|
287
|
+
| **Mission runner** | Exécutez des tests, parcourez les étapes en suivant l’état, terminez ou échouez avec un compte rendu précis. Propagation d’étape bloquée, avertissements de dépassement du nombre maximal d’étapes, réouverture de la dernière étape. | ✓ Déployé |
|
|
288
|
+
| **Unified entry** | La commande `roleos start` détermine automatiquement le mode de routage à utiliser : mission, ensemble ou libre. En cas d’échec, elle utilise une série d’options de repli avec des niveaux de confiance, des itinéraires alternatifs et une détection combinée. | ✓ Déployé |
|
|
289
|
+
| **Persistent runs** | « `roleos run` » crée des exécutions dont les données sont stockées sur disque. « `resume` », « `next` », « `explain` », « `complete` », « `fail` ». Interventions possibles : redirection, escalade, nouvelle tentative, blocage, réouverture. Instructions spécifiques à chaque étape. Mesure des frottements. | ✓ Déployé |
|
|
290
|
+
| **Brainstorm** | Architecture à deux niveaux : vérité (schémas natifs liés aux rôles, éléments de provenance, graphe des arguments contradictoires) + rendu (5 voix distinctes, interdictions lexicales, transcription du débat). Les liens de traçabilité prouvent que chaque affirmation rendue correspond à un élément de vérité. Test réussi et validé. | ✓ Déployé |
|
|
291
|
+
| **Deep Audit** | Audit du dépôt basé sur le manifeste : décomposer le dépôt en composants, affecter N auditeurs, M auditeurs chargés de vérifier la conformité et K auditeurs chargés d’examiner les interfaces à partir du graphe des dépendances, synthétiser les résultats pour obtenir un classement et un plan d’action. L’affectation dynamique s’adapte à la taille du dépôt (formule : 2N + K + 3). Exécution native avec validation des artefacts à chaque étape. | ✓ Déployé |
|
|
292
|
+
| **Dogfood Swarm** | Convergence en plusieurs étapes : trois phases de développement (correction des bugs/sécurité → approche proactive → amélioration de l’expérience utilisateur), puis phase d’ajout de fonctionnalités. Propriété exclusive des fichiers, validation à chaque étape du processus, points de contrôle pour les utilisateurs. Détection automatique du domaine qui génère les manifestes. Liaison vers les environnements de test internes (dogfood-labs). | ✓ Déployé |
|
|
293
|
+
|
|
294
|
+
## 9 missions
|
|
295
|
+
|
|
296
|
+
| Mission | Ensemble | Rôles | Quand l’utiliser ? |
|
|
290
297
|
|---------|------|-------|-------------|
|
|
291
|
-
| `feature-ship` |
|
|
292
|
-
| `bugfix` |
|
|
293
|
-
| `treatment` |
|
|
294
|
-
| `docs-release` |
|
|
295
|
-
| `security-hardening` |
|
|
296
|
-
| `research-launch` |
|
|
297
|
-
| `brainstorm` |
|
|
298
|
-
| `deep-audit` |
|
|
299
|
-
| `dogfood-swarm` |
|
|
298
|
+
| `feature-ship` | fonctionnalité ; mettre en avant ; figurer dans | 5 | Déploiement complet des fonctionnalités : définition du périmètre → spécifications → mise en œuvre → tests → évaluation |
|
|
299
|
+
| `bugfix` | correction de bug | 4 | Identifier la cause profonde, corriger, tester, vérifier. |
|
|
300
|
+
| `treatment` | traitement | 4 | Vérification du code source + correction + documentation + vérification par l’intégration continue + relecture |
|
|
301
|
+
| `docs-release` | documents | 2 | Rédiger et mettre à jour la documentation, les notes de version. |
|
|
302
|
+
| `security-hardening` | sécurité | 4 | Analyse des risques, audit, correction des vulnérabilités, nouvel audit, vérification. |
|
|
303
|
+
| `research-launch` | recherche | 4 | Définir la problématique, mener des recherches, consigner les résultats, prendre une décision. |
|
|
304
|
+
| `brainstorm` | session de brainstorming / séance de remue-méninges | 9 | Enquête structurée et multidimensionnelle, permettant de suivre les désaccords et d’aboutir à une conclusion. |
|
|
305
|
+
| `deep-audit` | audit approfondi | 5 (gammes) | Audit de dépôt pris en charge par Manifest : le nombre d’utilisateurs participant à l’audit s’adapte à la taille du graphe du dépôt grâce à une répartition dynamique des tâches. |
|
|
306
|
+
| `dogfood-swarm` | essaim | 8 (gammes) | Convergence en plusieurs étapes : état de santé A → état de santé B → état de santé C → caractéristique → synthèse finale. |
|
|
300
307
|
|
|
301
|
-
Chaque
|
|
308
|
+
Chaque tâche comprend une description précise et honnête de l’état d’avancement : lorsque la progression est interrompue, le système enregistre ce qui a été réalisé et ce qui reste à faire, au lieu de prétendre que la tâche est terminée.
|
|
302
309
|
|
|
303
|
-
###
|
|
310
|
+
### Session de brainstorming sur la mission
|
|
304
311
|
|
|
305
|
-
Pas de «
|
|
312
|
+
Pas de « séances de remue-méninges sur l’IA ». La mission de la séance de remue-méninges consiste à définir des **rôles spécialisés encadrés par la loi, avec un processus clair permettant d’identifier les désaccords et aboutissant à une décision définitive.**
|
|
306
313
|
|
|
307
314
|
```bash
|
|
308
315
|
roleos run "explore product directions for a developer tool discovery platform"
|
|
@@ -310,19 +317,19 @@ roleos run "explore product directions for a developer tool discovery platform"
|
|
|
310
317
|
# Chain: 4 Analysts (parallel) → Normalize → Cross-Examine → Rebut → Synthesize → Expand → Judge
|
|
311
318
|
```
|
|
312
319
|
|
|
313
|
-
**
|
|
320
|
+
**Qu’est-ce qui le distingue ?**
|
|
314
321
|
|
|
315
|
-
- **Niveau
|
|
322
|
+
- **Niveau 1 (vérité) :** Quatre analystes émettent des schémas spécifiques à leur rôle (ContextMap, UserValueMap, MechanicsMap, PositioningMap), et non un texte partagé. Chaque rôle est soumis à des contraintes visant à éviter les angles morts : expressions interdites, types d’affirmations interdits, partitions d’entrée filtrées. Les éléments de données contiennent des informations sur leur origine. Un graphique d’interrogation croisée dirigée permet de formuler des questions ciblées. Les analystes initiaux défendent leurs positions, les affinent ou s’en désistent sous la pression.
|
|
316
323
|
|
|
317
|
-
- **
|
|
324
|
+
- **Couche 2 (rendu) :** Cinq voix humaines distinctes (Note de service, Observations sur le terrain, Schéma du système, Exposé des faits, Transcription d’un contre-interrogatoire), avec des restrictions lexicales empêchant la convergence des voix. La synthèse déforme la vérité, sans jamais produire un texte cohérent. Les deux couches sont toujours accessibles.
|
|
318
325
|
|
|
319
|
-
- **Chaîne de traçabilité :** Chaque phrase
|
|
326
|
+
- **Chaîne de traçabilité :** Chaque phrase générée peut être retracée jusqu’à un élément fondamental de la couche de vérité. Les instructions de synthèse font référence à ces éléments. Les interrogatoires visent des identifiants de revendications réels. Le graphique des litiges est le résultat, et non le texte lui-même.
|
|
320
327
|
|
|
321
|
-
**
|
|
328
|
+
**Validé :** version 0.4, exécution de référence – l’intégrité de la chaîne de traçabilité a été vérifiée. Consultez le fichier [`examples/golden-run.md`](examples/golden-run.md) pour obtenir la liste complète des éléments constitutifs.
|
|
322
329
|
|
|
323
|
-
### Mission d’audit
|
|
330
|
+
### Mission d’audit approfondie
|
|
324
331
|
|
|
325
|
-
|
|
332
|
+
Il ne s’agit pas d’une simple analyse superficielle. La mission d’audit approfondi décompose le dépôt en composants distincts et affecte des auditeurs spécialisés, en fonction de l’échelle déterminée par le graphe de dépendances du dépôt.
|
|
326
333
|
|
|
327
334
|
```bash
|
|
328
335
|
roleos run "deep audit this repo" --manifest=audit-manifest.json
|
|
@@ -330,19 +337,19 @@ roleos run "deep audit this repo" --manifest=audit-manifest.json
|
|
|
330
337
|
# Steps: Component Auditor ×6 + Test Truth Auditor ×6 + Seam Auditor ×8 + Synthesizer + Action Plan + Critic = 23 steps
|
|
331
338
|
```
|
|
332
339
|
|
|
333
|
-
**
|
|
340
|
+
**Qu’est-ce qui le distingue ?**
|
|
334
341
|
|
|
335
|
-
- **
|
|
336
|
-
- **
|
|
337
|
-
- **Quatre archétypes de rôles
|
|
338
|
-
- **Validation des artefacts à chaque étape
|
|
339
|
-
- **
|
|
342
|
+
- **Répartition dynamique** : le nombre d’agents n’est pas fixe. Un dépôt de 10 composants avec 5 groupes de limites produit 28 étapes (2 × 10 + 5 + 3). Un dépôt de 3 composants en produit 12. La formule de mise à l’échelle est « 2N + K + 3 », où N = nombre de composants, K = nombre de limites.
|
|
343
|
+
- **Ensembles de données basés sur un manifeste** : un fichier `audit-manifest.json` définit les composants (avec les chemins d’accès aux fichiers, le nombre de lignes et les descriptions) et les limites (de/vers, avec des descriptions des interfaces). Chaque auditeur ne reçoit que son ensemble de données.
|
|
344
|
+
- **Quatre archétypes de rôles** : Auditeur de composants (vérification du code par module), Auditeur de la validité des tests (tests qui prouvent par rapport aux tests existants), Auditeur des points d’intégration (limites d’intégration à partir du graphe de dépendances), Synthétiseur d’audit (résultat classé + plan d’action à partir de tous les ensembles de données).
|
|
345
|
+
- **Validation des artefacts à chaque étape** : la fonction `validateArtifact()` est exécutée à la fin de chaque étape dans les deux chemins d’exécution. Les résultats sont associés aux objets d’étape. Le système sait si chaque artefact a respecté son contrat.
|
|
346
|
+
- **Résultats partiels honnêtes** : lorsque le budget ou la portée empêche l’achèvement, les résultats par composant sont valides individuellement. Le système synthétise à partir de ce qui a été achevé et ne prétend jamais avoir couvert tous les aspects.
|
|
340
347
|
|
|
341
|
-
**
|
|
348
|
+
**Résultats confirmés :** Exécution d’un test de validation effectué par un utilisateur natif – 18 tests réalisés sur des exemples réels, vérification complète du cycle de vie, y compris la réouverture en cas d’escalade et la gestion des échecs partiels. La formule de mise à l’échelle a été validée pour les exemples comportant 3, 6, 10 ou 15 composants.
|
|
342
349
|
|
|
343
|
-
### Mission
|
|
350
|
+
### Mission consistant à déployer un essaim de drones
|
|
344
351
|
|
|
345
|
-
|
|
352
|
+
Il ne s’agit pas d’un outil d’analyse statique en une seule passe. La mission « dogfood swarm » exécute un protocole de convergence multipasse qui fait passer un dépôt de l’état « fonctionnel » à l’état « prêt pour la production », en trois étapes et grâce à des livraisons itératives de fonctionnalités.
|
|
346
353
|
|
|
347
354
|
```bash
|
|
348
355
|
roleos swarm
|
|
@@ -351,20 +358,20 @@ roleos swarm
|
|
|
351
358
|
# Domain agents: 3-5 parallel per wave (exclusive file ownership)
|
|
352
359
|
```
|
|
353
360
|
|
|
354
|
-
**
|
|
361
|
+
**Qu’est-ce qui le distingue ?**
|
|
355
362
|
|
|
356
|
-
-
|
|
357
|
-
- **Propriété exclusive des fichiers**
|
|
358
|
-
- **Contrôles
|
|
359
|
-
- **Points de contrôle utilisateur**
|
|
360
|
-
- **Convergence itérative**
|
|
361
|
-
- **Détection automatique du domaine**
|
|
363
|
+
- **Étape d’évaluation en trois phases** : la phase A corrige les bogues et les problèmes de sécurité (boucle jusqu’à ce qu’il n’y ait plus 0 CRITICAL + 0 HIGH). La phase B applique un renforcement proactif (les utilisateurs examinent les résultats). La phase C améliore le code en le rendant plus convivial : messages d’erreur qui aident les utilisateurs, commentaires sur la reconnexion, états de chargement, accessibilité. Chaque étape est une approche distincte, et non la même analyse répétée.
|
|
364
|
+
- **Propriété exclusive des fichiers** : chaque agent de domaine possède des fichiers spécifiques via `swarm-manifest.json`. Aucun agent n’édite le même fichier. Pas de conflits de fusion. Pas de surcharge de coordination.
|
|
365
|
+
- **Contrôles avant la compilation** : l’analyse statique + la vérification du type + les tests doivent être réussis après chaque vague. Le système détecte automatiquement le système de compilation (Node, Rust, Python, Go) et exécute les commandes appropriées.
|
|
366
|
+
- **Points de contrôle utilisateur** : la phase d’évaluation Health-B et la phase de livraison des fonctionnalités nécessitent l’approbation explicite de l’utilisateur avant l’exécution. Le système présente les résultats, et l’utilisateur décide ce qui doit être compilé.
|
|
367
|
+
- **Convergence itérative** : les étapes sont répétées en boucle avec les vagues jusqu’à ce que les conditions de sortie soient remplies ou qu’un nombre maximal d’itérations soit atteint. Chaque vague effectue une nouvelle vérification à partir de zéro afin de détecter les régressions introduites par les corrections précédentes.
|
|
368
|
+
- **Détection automatique du domaine** : `roleos swarm manifest --generate` détecte le type de dépôt (CLI, web, bureau, MCP, monorepo) et génère des affectations de domaine non superposées.
|
|
362
369
|
|
|
363
|
-
**Résultats prouvés
|
|
370
|
+
**Résultats prouvés** : claude-collaborate (2026-03-28) — 35 → 129 tests, 106 problèmes d’évaluation corrigés, v1.1.0 publié. Protocole v2.0 avec 9 phases.
|
|
364
371
|
|
|
365
372
|
## Statut
|
|
366
373
|
|
|
367
|
-
Stable et prêt à être déployé. Consultez le fichier [CHANGELOG](CHANGELOG.md) pour obtenir l’historique complet des versions et les modifications apportées
|
|
374
|
+
Stable et prêt à être déployé. Consultez le fichier [CHANGELOG](CHANGELOG.md) pour obtenir l’historique complet des versions et les modifications apportées dans chaque version.
|
|
368
375
|
|
|
369
376
|
## Licence
|
|
370
377
|
|