role-os 1.9.0 → 2.0.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 +332 -297
- package/README.es.md +250 -160
- package/README.fr.md +250 -160
- package/README.hi.md +250 -160
- package/README.it.md +250 -160
- package/README.ja.md +250 -160
- package/README.md +287 -250
- package/README.pt-BR.md +250 -160
- package/README.zh.md +250 -160
- package/bin/roleos.mjs +205 -145
- package/package.json +51 -51
- package/src/run-cmd.mjs +405 -0
- package/src/run.mjs +949 -0
package/README.it.md
CHANGED
|
@@ -1,160 +1,250 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.md">English</a> | <a href="README.pt-BR.md">Português (BR)</a>
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
# Role OS
|
|
6
|
-
|
|
7
|
-
<p align="center">
|
|
8
|
-
<img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/role-os/readme.png" alt="Role OS" width="400">
|
|
9
|
-
</p>
|
|
10
|
-
|
|
11
|
-
<p align="center">
|
|
12
|
-
<a href="https://github.com/mcp-tool-shop-org/role-os/actions"><img src="https://github.com/mcp-tool-shop-org/role-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
|
|
13
|
-
<a href="https://www.npmjs.com/package
|
|
14
|
-
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
|
|
15
|
-
<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>
|
|
16
|
-
</p>
|
|
17
|
-
|
|
18
|
-
Un
|
|
19
|
-
|
|
20
|
-
## Cosa fa
|
|
21
|
-
|
|
22
|
-
Role OS
|
|
23
|
-
|
|
24
|
-
- **Deviazioni (Drift)**: i ruoli rimangono nel loro ambito. Il prodotto non viene ridisegnato. L'interfaccia utente non ridefinisce l'ambito. Il backend non inventa la direzione del prodotto.
|
|
25
|
-
- **Completamenti errati (False completion)**: la definizione di "completato" è concreta. Il lavoro che nasconde lacune, omette verifiche o risolve un problema diverso viene rifiutato.
|
|
26
|
-
- **Contaminazione (Contamination)**: i progetti derivati o ereditati contengono residui di identità. Role OS rileva e rifiuta le deviazioni cross-progetto in termini, elementi visivi e modelli mentali.
|
|
27
|
-
- **Avanzamento basato su impressioni (Vibes-based progress)**: ogni passaggio è strutturato. Ogni decisione si basa su prove. "Sembra fatto" non è uno stato valido.
|
|
28
|
-
|
|
29
|
-
## Come funziona
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
##
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
**
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
-
|
|
122
|
-
|
|
123
|
-
##
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
-
|
|
149
|
-
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.md">English</a> | <a href="README.pt-BR.md">Português (BR)</a>
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
# Role OS
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/role-os/readme.png" alt="Role OS" width="400">
|
|
9
|
+
</p>
|
|
10
|
+
|
|
11
|
+
<p align="center">
|
|
12
|
+
<a href="https://github.com/mcp-tool-shop-org/role-os/actions"><img src="https://github.com/mcp-tool-shop-org/role-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
|
|
13
|
+
<a href="https://www.npmjs.com/package/role-os"><img src="https://img.shields.io/npm/v/role-os" alt="npm"></a>
|
|
14
|
+
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
|
|
15
|
+
<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>
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+
Un sistema operativo multi-Claude che assegna personale, definisce i percorsi, convalida e gestisce le attività attraverso 31 contratti di ruolo specializzati. Crea pacchetti di attività, assembla il team giusto in base alla corrispondenza dei ruoli, rileva problemi prima dell'esecuzione, indirizza automaticamente le operazioni di ripristino quando un'attività viene bloccata o rifiutata e richiede prove strutturate in ogni decisione.
|
|
19
|
+
|
|
20
|
+
## Cosa fa
|
|
21
|
+
|
|
22
|
+
Role OS è il modo professionale di utilizzare multi-Claude. Previene i problemi specifici che i flussi di lavoro AI generici possono causare:
|
|
23
|
+
|
|
24
|
+
- **Deviazioni (Drift)**: i ruoli rimangono nel loro ambito. Il prodotto non viene ridisegnato. L'interfaccia utente non ridefinisce l'ambito. Il backend non inventa la direzione del prodotto.
|
|
25
|
+
- **Completamenti errati (False completion)**: la definizione di "completato" è concreta. Il lavoro che nasconde lacune, omette verifiche o risolve un problema diverso viene rifiutato.
|
|
26
|
+
- **Contaminazione (Contamination)**: i progetti derivati o ereditati contengono residui di identità. Role OS rileva e rifiuta le deviazioni cross-progetto in termini, elementi visivi e modelli mentali.
|
|
27
|
+
- **Avanzamento basato su impressioni (Vibes-based progress)**: ogni passaggio è strutturato. Ogni decisione si basa su prove. "Sembra fatto" non è uno stato valido.
|
|
28
|
+
|
|
29
|
+
## Come funziona
|
|
30
|
+
|
|
31
|
+
Descrivi la tua attività. Role OS determina automaticamente il livello di orchestrazione appropriato.
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
roleos start "fix the crash in save handler"
|
|
35
|
+
# → MISSION: Bugfix & Diagnosis (70% confidence)
|
|
36
|
+
# Chain: Repo Researcher → Backend Engineer → Test Engineer → Critic Reviewer
|
|
37
|
+
|
|
38
|
+
roleos start "add a new export command"
|
|
39
|
+
# → PACK: Feature Build (50% confidence)
|
|
40
|
+
# Roles: Orchestrator, Product Strategist, Spec Writer, Backend Engineer, Test Engineer, Critic Reviewer
|
|
41
|
+
|
|
42
|
+
roleos start "something completely novel"
|
|
43
|
+
# → FREE-ROUTING (10% confidence)
|
|
44
|
+
# Hint: Create a packet and run `roleos route` for role-level routing
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
**La gerarchia di fallback:**
|
|
48
|
+
|
|
49
|
+
1. **Missione** — quando l'attività corrisponde a un flusso di lavoro ricorrente consolidato (correzione di bug, trattamento, rilascio di funzionalità, documentazione, sicurezza, ricerca). Catena di ruoli nota, flusso di artefatti, rami di escalation e definizioni parziali chiare.
|
|
50
|
+
2. **Pacchetto** — quando l'attività appartiene a una famiglia nota, ma non corrisponde a una missione completa. 7 pacchetti di team calibrati con selezione automatica e protezioni contro le incompatibilità.
|
|
51
|
+
3. **Instradamento libero** — quando l'attività è nuova, complessa o incerta. Assegna un punteggio a tutti i 31 ruoli in base al contenuto del pacchetto e crea una catena dinamica.
|
|
52
|
+
|
|
53
|
+
Il sistema non forza mai un'attività attraverso un livello di astrazione errato. Spiega perché ha scelto ogni livello e offre alternative.
|
|
54
|
+
|
|
55
|
+
**Una volta instradata:**
|
|
56
|
+
|
|
57
|
+
1. **Ogni ruolo produce un passaggio** — output strutturato con elementi di prova che riducono l'ambiguità per il ruolo successivo.
|
|
58
|
+
2. **La revisione critica avviene in base al contratto** — accetta, rifiuta o blocca in base a prove strutturate, non a impressioni.
|
|
59
|
+
3. **Il ripristino avviene automaticamente** — le attività bloccate o rifiutate vengono indirizzate al risolutore appropriato con una motivazione, il tipo di ripristino e gli artefatti richiesti.
|
|
60
|
+
|
|
61
|
+
## Stato di implementazione nell'organizzazione
|
|
62
|
+
|
|
63
|
+
Lo stato di implementazione a livello di organizzazione (coda, decisioni, registri di controllo, pacchetti di blocco per repository) si trova in un repository privato separato: [`role-os-rollout`](https://github.com/mcp-tool-shop-org/role-os-rollout). Questo repository è il prodotto; quello è lo stato operativo.
|
|
64
|
+
|
|
65
|
+
## Memoria e continuità
|
|
66
|
+
|
|
67
|
+
Role OS non possiede né duplica il livello di memoria. Quando esiste la memoria del progetto Claude, questa è il sistema di continuità canonico: i fatti del repository, le decisioni, i problemi aperti e la cronologia delle modifiche sono memorizzati lì.
|
|
68
|
+
|
|
69
|
+
Role OS si integra con la memoria del progetto Claude. Non la sostituisce.
|
|
70
|
+
|
|
71
|
+
## Elaborazione completa e controllo di qualità
|
|
72
|
+
|
|
73
|
+
L'elaborazione completa è un protocollo canonico di 7 fasi definito nella memoria del progetto Claude (`memory/full-treatment.md`). Role OS indirizza e valuta le elaborazioni utilizzando contratti di ruolo, passaggi e controlli, ma non ridefinisce il protocollo.
|
|
74
|
+
|
|
75
|
+
Il **controllo di qualità (shipcheck)** è il sistema di controllo di 31 elementi che viene eseguito prima dell'elaborazione completa. I controlli obbligatori A-D devono essere superati prima che qualsiasi elaborazione possa iniziare. Riferimento canonico: `memory/shipcheck.md`.
|
|
76
|
+
|
|
77
|
+
Ordine: controllo di qualità, quindi elaborazione completa. Nessuna versione 1.0.0 senza aver superato i controlli obbligatori.
|
|
78
|
+
|
|
79
|
+
## 32 ruoli in 8 pacchetti
|
|
80
|
+
|
|
81
|
+
| Pacchetto | Ruoli |
|
|
82
|
+
|------|-------|
|
|
83
|
+
| **Core** (3) | Orchestratore, Product Strategist, Recensore |
|
|
84
|
+
| **Engineering** (7) | Sviluppatore Frontend, Ingegnere Backend, Ingegnere di Test, Ingegnere di Refactoring, Ingegnere delle Prestazioni, Revisore delle Dipendenze, Revisore di Sicurezza |
|
|
85
|
+
| **Design** (2) | UI Designer, Responsabile del Brand |
|
|
86
|
+
| **Marketing** (1) | Copywriter per il lancio |
|
|
87
|
+
| **Treatment** (7) | Ricercatore di Repository, Traduttore di Repository, Architetto della Documentazione, Curatore dei Metadati, Revisore della Copertura, Verificatore del Deployment, Ingegnere del Rilascio |
|
|
88
|
+
| **Product** (3) | Generatore di feedback, Prioritizzatore della roadmap, Redattore di specifiche. |
|
|
89
|
+
| **Research** (4) | Ricercatore UX, Analista della Concorrenza, Ricercatore di Tendenze, Sintetizzatore di Interviste con gli Utenti |
|
|
90
|
+
| **Growth** (4) | Strategista per il lancio, Strategista dei Contenuti, Community Manager, Responsabile del Supporto |
|
|
91
|
+
|
|
92
|
+
Ogni ruolo ha un contratto completo: missione, quando utilizzarlo, quando non utilizzarlo, input previsti, output richiesti, standard di qualità e trigger di escalation. Ogni ruolo può essere indirizzato; `roleos route` può raccomandare uno qualsiasi di essi in base al contenuto del pacchetto.
|
|
93
|
+
|
|
94
|
+
## Guida rapida
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
npx role-os init
|
|
98
|
+
|
|
99
|
+
# Describe what you need — Role OS picks the right level:
|
|
100
|
+
roleos start "fix the crash in save handler"
|
|
101
|
+
|
|
102
|
+
# Or go manual:
|
|
103
|
+
roleos packet new feature
|
|
104
|
+
roleos route .claude/packets/my-feature.md
|
|
105
|
+
roleos review .claude/packets/my-feature.md accept
|
|
106
|
+
roleos status
|
|
107
|
+
|
|
108
|
+
# Explore missions and packs:
|
|
109
|
+
roleos mission list
|
|
110
|
+
roleos mission show bugfix
|
|
111
|
+
roleos packs list
|
|
112
|
+
roleos packs show feature
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Quando non utilizzare Role OS
|
|
116
|
+
|
|
117
|
+
- Correzioni di una sola riga, errori di battitura o bug evidenti
|
|
118
|
+
- Ricerche esplorative senza un output definito
|
|
119
|
+
- Lavori che possono essere completati nella mente di una persona in 5 minuti
|
|
120
|
+
- Correzioni urgenti che devono essere rilasciate prima che la catena di revisione sia completa
|
|
121
|
+
- Progetti in cui si privilegia la velocità rispetto alla struttura
|
|
122
|
+
|
|
123
|
+
## Prove
|
|
124
|
+
|
|
125
|
+
Role OS è stato testato in tre scenari diversi in due repository strutturalmente diversi:
|
|
126
|
+
|
|
127
|
+
**Test 001 — Sviluppo funzionalità** (Schermata Crew, Star Freight)
|
|
128
|
+
- Catena di 7 ruoli, 45 scenari di test, 0 conflitti di ruolo.
|
|
129
|
+
- Ha prevenuto la contaminazione da un progetto antenato, ha rilevato modifiche non autorizzate e ha evidenziato i blocchi reali.
|
|
130
|
+
|
|
131
|
+
**Test 002 — Integrazione** (Collegamento CampaignState, Star Freight)
|
|
132
|
+
- Catena di 5 ruoli, ha risolto la connessione architetturale senza soluzioni di ripiego.
|
|
133
|
+
- I test anti-fallback hanno dimostrato che il percorso attivo è reale, non un segnaposto.
|
|
134
|
+
|
|
135
|
+
**Test 003 — Correzione di identità** (Pulizia della contaminazione, Star Freight)
|
|
136
|
+
- Catena di 6 ruoli, 51 scenari di test, inclusa la difesa duratura contro la contaminazione del sistema di integrazione continua.
|
|
137
|
+
- Ha corretto le incongruenze ereditate senza dover rifare completamente il progetto.
|
|
138
|
+
|
|
139
|
+
**Prova di portabilità** (Coerenza della persona, sensibilità al contesto)
|
|
140
|
+
- Stessa struttura di base, ma con linguaggio/ambito/stack diversi.
|
|
141
|
+
- Adattamento solo al contesto, senza modifiche al contratto principale.
|
|
142
|
+
|
|
143
|
+
**Trattamento completo FT-001** (portlight-desktop)
|
|
144
|
+
- Trattamento con personale dedicato in 7 fasi, con ruoli del pacchetto di trattamento
|
|
145
|
+
- Controllo di spedizione dimostrato, zero conflitti tra ruoli
|
|
146
|
+
|
|
147
|
+
**Trattamento completo FT-002** (studioflow)
|
|
148
|
+
- Stesso pacchetto di trattamento, repository strutturalmente diverso (spazio di lavoro creativo vs gioco)
|
|
149
|
+
- Pacchetto di trattamento portatile: non sono necessarie modifiche al contratto
|
|
150
|
+
|
|
151
|
+
## Proprietà fondamentali
|
|
152
|
+
|
|
153
|
+
Queste sono non negoziabili. Se una modifica ne indebolisce una, rifiutarla.
|
|
154
|
+
|
|
155
|
+
- I confini dei ruoli rimangono validi.
|
|
156
|
+
- La revisione è efficace.
|
|
157
|
+
- L'escalation rimane trasparente.
|
|
158
|
+
- I pacchetti rimangono testabili.
|
|
159
|
+
- La portabilità richiede adattamento al contesto, non modifiche radicali.
|
|
160
|
+
|
|
161
|
+
## Struttura del progetto
|
|
162
|
+
|
|
163
|
+
```
|
|
164
|
+
role-os/
|
|
165
|
+
bin/roleos.mjs ← CLI entrypoint
|
|
166
|
+
src/
|
|
167
|
+
entry.mjs ← Unified entry: mission → pack → free routing
|
|
168
|
+
entry-cmd.mjs ← `roleos start` CLI command
|
|
169
|
+
mission.mjs ← 6 named mission types (feature, bugfix, treatment, docs, security, research)
|
|
170
|
+
mission-run.mjs ← Mission runner: create → step → complete → report
|
|
171
|
+
mission-cmd.mjs ← `roleos mission` CLI commands
|
|
172
|
+
route.mjs ← 31-role routing + dynamic chain builder
|
|
173
|
+
packs.mjs ← 7 calibrated team packs + auto-selection
|
|
174
|
+
conflicts.mjs ← 4-pass conflict detection
|
|
175
|
+
escalation.mjs ← Auto-routing for blocked/rejected/split
|
|
176
|
+
evidence.mjs ← Structured evidence + role-aware requirements
|
|
177
|
+
dispatch.mjs ← Runtime dispatch manifests for multi-claude
|
|
178
|
+
artifacts.mjs ← 20 per-role artifact contracts + 7 pack handoffs
|
|
179
|
+
decompose.mjs ← Composite task detection + splitting
|
|
180
|
+
composite.mjs ← Dependency-ordered execution + recovery
|
|
181
|
+
replan.mjs ← Mid-run adaptive replanning
|
|
182
|
+
calibration.mjs ← Outcome recording + weight tuning
|
|
183
|
+
hooks.mjs ← 5 lifecycle hooks for runtime enforcement
|
|
184
|
+
session.mjs ← Session scaffolding + doctor
|
|
185
|
+
test/ ← 527 tests across 20 test files
|
|
186
|
+
starter-pack/ ← Drop-in role contracts, policies, schemas, workflows
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
## Sicurezza
|
|
190
|
+
|
|
191
|
+
Il sistema operativo del ruolo opera **solo localmente**. Copia i modelli Markdown e scrive i file dei pacchetti/verdetto nella directory `.claude/` del tuo repository. Non accede alla rete, non gestisce segreti e non raccoglie dati di telemetria. Nessuna operazione pericolosa: tutte le scritture di file utilizzano la funzione "skip-if-exists" per impostazione predefinita. Consultare il file [SECURITY.md](SECURITY.md) per la politica completa.
|
|
192
|
+
|
|
193
|
+
## Il sistema operativo
|
|
194
|
+
|
|
195
|
+
| Livello. | Cosa fa | Stato |
|
|
196
|
+
|-------|-------------|--------|
|
|
197
|
+
| **Routing** | Assegna un punteggio a tutti i 31 ruoli in base al contenuto del pacchetto, spiega le raccomandazioni, valuta la confidenza. | ✓ Implementato. |
|
|
198
|
+
| **Chain builder** | Assembla catene ordinate per fasi dai ruoli valutati, orientate al tipo di pacchetto, ma non vincolate a modelli. | ✓ Implementato. |
|
|
199
|
+
| **Conflict detection** | Convalida in 4 passaggi: conflitti gravi, sequenza, ridondanza, lacune di copertura. Suggerimenti per la correzione. | ✓ Implementato. |
|
|
200
|
+
| **Escalation** | Indirizza automaticamente le attività bloccate/rifiutate/divise al risolutore appropriato con la motivazione e gli artefatti richiesti. | ✓ Implementato. |
|
|
201
|
+
| **Evidence** | Prove strutturate specifiche per il ruolo nelle decisioni. Controlli di sufficienza. 12 tipi di prove. | ✓ Implementato. |
|
|
202
|
+
| **Dispatch** | Genera manifesti di esecuzione per multi-claude. Profili degli strumenti per ruolo, prompt di sistema, budget. | ✓ Implementato. |
|
|
203
|
+
| **Trials** | Roster completo dimostrato: 30/30 attività di successo + 5/5 test negativi. 7 test dei pacchetti completati. | ✓ Completo. |
|
|
204
|
+
| **Team Packs** | 7 pacchetti calibrati con selezione automatica, protezioni contro le incompatibilità e fallback con instradamento libero. | ✓ Implementato. |
|
|
205
|
+
| **Outcome calibration** | Registra i risultati delle esecuzioni, calibra i pesi dei pacchetti/ruoli in base ai risultati, regola le soglie di confidenza. | ✓ Implementato. |
|
|
206
|
+
| **Mixed-task decomposition** | Rileva attività composte, le divide in pacchetti secondari, assegna i pacchetti e preserva le dipendenze. | ✓ Implementato. |
|
|
207
|
+
| **Composite execution** | Esegue i pacchetti secondari nell'ordine delle dipendenze con il passaggio degli artefatti, il ripristino dei rami e la sintesi. | ✓ Implementato. |
|
|
208
|
+
| **Adaptive replanning** | Le modifiche all'ambito, le scoperte o i nuovi requisiti durante l'esecuzione aggiornano il piano senza doverlo riavviare. | ✓ Implementato. |
|
|
209
|
+
| **Session spine** | `roleos init claude` crea i file CLAUDE.md, /roleos-route, /roleos-review, /roleos-status. `roleos doctor` verifica la configurazione. Le schede di instradamento dimostrano l'utilizzo. | ✓ Implementato. |
|
|
210
|
+
| **Hook spine** | 5 "hook" del ciclo di vita (SessionStart, PromptSubmit, PreToolUse, SubagentStart, Stop). Applicazione delle policy: promemoria sulle "route card", controllo sull'utilizzo degli strumenti, assegnazione di ruoli ai "subagent", verifica del completamento. | ✓ Implementato. |
|
|
211
|
+
| **Artifact spine** | 20 contratti per ruolo relativi agli artefatti. 7 contratti per il passaggio di consegne tra "pack". Validazione strutturale. Controlli di completezza della "catena". I ruoli successivi non devono mai indovinare ciò che hanno ricevuto. | ✓ Implementato. |
|
|
212
|
+
| **Mission library** | 6 missioni denominate (implementazione di funzionalità, correzione di bug, ottimizzazione, rilascio della documentazione, rafforzamento della sicurezza, avvio della ricerca). Ogni missione definisce il "pack", la catena di ruoli, il flusso degli artefatti, i percorsi di escalation e una definizione parziale e trasparente. Tutte e 6 le missioni sono state testate e ottimizzate. | ✓ Implementato. |
|
|
213
|
+
| **Mission runner** | Creazione di esecuzioni, passaggio graduale con tracciamento dello stato, completamento/fallimento con reportistica trasparente. Propagazione dei passaggi bloccati, avvisi di escalation al di fuori della catena, riapertura dell'ultimo passaggio. | ✓ Implementato. |
|
|
214
|
+
| **Unified entry** | Il comando `roleos start` decide automaticamente tra l'utilizzo di una missione, di un "pack" o di un percorso libero. Sistema di fallback con punteggi di affidabilità, alternative e rilevamento composito. | ✓ Implementato. |
|
|
215
|
+
|
|
216
|
+
## 6 missioni
|
|
217
|
+
|
|
218
|
+
| Missione | Pacchetto | Ruoli | Quando utilizzarla |
|
|
219
|
+
|---------|------|-------|-------------|
|
|
220
|
+
| `feature-ship` | Funzionalità | 5 | Erogazione completa di una funzionalità: definizione dell'ambito → specifica → implementazione → test → revisione |
|
|
221
|
+
| `bugfix` | Correzione di bug | 4 | Diagnosi della causa principale, correzione, test, verifica |
|
|
222
|
+
| `treatment` | Ottimizzazione | 4 | Controllo della qualità + rifinitura + documentazione + verifica tramite CI + revisione |
|
|
223
|
+
| `docs-release` | Documentazione | 2 | Scrittura/aggiornamento della documentazione, note di rilascio |
|
|
224
|
+
| `security-hardening` | Sicurezza | 4 | Modello delle minacce, audit, correzione delle vulnerabilità, nuovo audit, verifica |
|
|
225
|
+
| `research-launch` | Ricerca | 4 | Formulazione della domanda, ricerca, documentazione dei risultati, decisione |
|
|
226
|
+
|
|
227
|
+
Ogni missione include definizioni parziali e trasparenti: quando il lavoro si blocca, il sistema documenta ciò che è stato completato e ciò che rimane, invece di fornire una falsa impressione di completamento.
|
|
228
|
+
|
|
229
|
+
## Stato
|
|
230
|
+
|
|
231
|
+
- v0.1–v0.4: Fondamenta: test, adozione, "pack" di ottimizzazione, "pack" di avvio
|
|
232
|
+
- v1.0.0: 32 ruoli, interfaccia a riga di comando completa, ottimizzazione collaudata, portabilità multi-repository
|
|
233
|
+
- v1.0.2: Blocco del sistema operativo dei ruoli (correzioni per garantire la veridicità, `init --force`)
|
|
234
|
+
- v1.1.0: 31 ruoli, "spina dorsale" completa per il routing, rilevamento dei conflitti, escalation, evidenza, dispatch, 7 "pack" di team collaudati. 35 esecuzioni di prova. 212 test.
|
|
235
|
+
- v1.2.0: "Pack" calibrati promossi a impostazione predefinita. Selezione automatica, rilevamento delle incongruenze, suggerimento di alternative, fallback per il routing libero. 246 test.
|
|
236
|
+
- v1.3.0: Calibrazione dei risultati, decomposizione dei compiti misti, esecuzione composita, riprogrammazione adattiva. 317 test.
|
|
237
|
+
- v1.4.0: "Spina dorsale" della sessione: `roleos init claude`, `roleos doctor`, "route card", comandi `/roleos-route + /roleos-review + /roleos-status`. 335 test.
|
|
238
|
+
- v1.5.0: "Spina dorsale" dei "hook": 5 "hook" del ciclo di vita per l'applicazione delle policy in fase di esecuzione. 358 test.
|
|
239
|
+
- v1.6.0: "Spina dorsale" degli artefatti: 20 contratti per ruolo relativi agli artefatti, 7 contratti per il passaggio di consegne tra "pack", validazione strutturale. 385 test.
|
|
240
|
+
- v1.7.0: Prova di completamento: attività reali eseguite sull'intera piattaforma. Interfaccia a riga di comando `roleos artifacts`. Escalation trasparente in caso di correzioni strutturali. 398 test.
|
|
241
|
+
- v1.8.0: Libreria di missioni (Fase S): 6 missioni denominate, motore di esecuzione, report di completamento. Ottimizzate da 6 esecuzioni di prova reali. 481 test.
|
|
242
|
+
- **v1.9.0**: Percorso di accesso unificato (Fase T) - `roleos start` decide automaticamente tra l'utilizzo di una missione, di un "pack" o di un percorso libero. Sistema di fallback, rilevamento composito, test di confronto del percorso di accesso. 527 test.
|
|
243
|
+
|
|
244
|
+
## Licenza
|
|
245
|
+
|
|
246
|
+
MIT
|
|
247
|
+
|
|
248
|
+
---
|
|
249
|
+
|
|
250
|
+
Creato da <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a
|