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.es.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.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</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
|
-
|
|
19
|
-
|
|
20
|
-
## ¿Qué hace?
|
|
21
|
-
|
|
22
|
-
Role OS
|
|
23
|
-
|
|
24
|
-
- **Desviación (Drift)**: Los roles se mantienen dentro de su ámbito. El producto no se rediseña. La interfaz de usuario no redefine el alcance. El backend no inventa la dirección del producto.
|
|
25
|
-
- **Finalización falsa**: La definición de "hecho" es concreta. El trabajo que oculta deficiencias, omite la verificación o resuelve un problema diferente es rechazado.
|
|
26
|
-
- **Contaminación**: Los proyectos bifurcados o heredados conservan residuos de identidad. Role OS detecta y rechaza las desviaciones entre proyectos en terminología, elementos visuales y modelos mentales.
|
|
27
|
-
- **Progreso basado en impresiones**: Cada transferencia es estructurada. Cada decisión se basa en evidencia. "Parece que está terminado" no es un estado válido.
|
|
28
|
-
|
|
29
|
-
## ¿Cómo funciona?
|
|
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.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</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 que asigna personal, dirige, valida y ejecuta tareas a través de 31 contratos de roles especializados. Crea paquetes de tareas, ensambla el equipo adecuado a partir de la coincidencia de roles, detecta problemas antes de la ejecución, redirige automáticamente la recuperación cuando una tarea se bloquea o se rechaza, y requiere evidencia estructurada en cada decisión.
|
|
19
|
+
|
|
20
|
+
## ¿Qué hace?
|
|
21
|
+
|
|
22
|
+
Role OS es la forma profesional de utilizar multi-Claude. Evita los fallos específicos que producen los flujos de trabajo de IA genéricos:
|
|
23
|
+
|
|
24
|
+
- **Desviación (Drift)**: Los roles se mantienen dentro de su ámbito. El producto no se rediseña. La interfaz de usuario no redefine el alcance. El backend no inventa la dirección del producto.
|
|
25
|
+
- **Finalización falsa**: La definición de "hecho" es concreta. El trabajo que oculta deficiencias, omite la verificación o resuelve un problema diferente es rechazado.
|
|
26
|
+
- **Contaminación**: Los proyectos bifurcados o heredados conservan residuos de identidad. Role OS detecta y rechaza las desviaciones entre proyectos en terminología, elementos visuales y modelos mentales.
|
|
27
|
+
- **Progreso basado en impresiones**: Cada transferencia es estructurada. Cada decisión se basa en evidencia. "Parece que está terminado" no es un estado válido.
|
|
28
|
+
|
|
29
|
+
## ¿Cómo funciona?
|
|
30
|
+
|
|
31
|
+
Describa su tarea. Role OS decide automáticamente el nivel de orquestación adecuado.
|
|
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 jerarquía de respaldo:**
|
|
48
|
+
|
|
49
|
+
1. **Misión:** cuando la tarea coincide con un flujo de trabajo recurrente probado (corrección de errores, tratamiento, lanzamiento de funciones, documentación, seguridad, investigación). Cadena de roles conocida, flujo de artefactos, ramas de escalamiento y definiciones parciales.
|
|
50
|
+
2. **Paquete:** cuando la tarea pertenece a una familia conocida pero no tiene una estructura de misión completa. 7 paquetes de equipo calibrados con selección automática y mecanismos de protección contra errores.
|
|
51
|
+
3. **Enrutamiento libre:** cuando la tarea es novedosa, mixta o incierta. Asigna una puntuación a los 31 roles en función del contenido del paquete y ensambla una cadena dinámica.
|
|
52
|
+
|
|
53
|
+
El sistema nunca fuerza una tarea a través de una abstracción incorrecta. Explica por qué eligió cada nivel y ofrece alternativas.
|
|
54
|
+
|
|
55
|
+
**Una vez enrutada:**
|
|
56
|
+
|
|
57
|
+
1. **Cada rol produce una transferencia:** salida estructurada con elementos de evidencia que reducen la ambigüedad para el siguiente rol.
|
|
58
|
+
2. **El revisor evalúa según el contrato:** acepta, rechaza o bloquea en función de la evidencia estructurada, no de la impresión.
|
|
59
|
+
3. **La recuperación se redirige automáticamente:** las tareas bloqueadas o rechazadas se redirigen al responsable adecuado, junto con la razón, el tipo de recuperación y el artefacto requerido.
|
|
60
|
+
|
|
61
|
+
## Estado de implementación en la organización
|
|
62
|
+
|
|
63
|
+
El estado de implementación en toda la organización (cola, decisiones, registros de auditoría, paquetes de bloqueo por repositorio) se encuentra en un repositorio privado separado: [`role-os-rollout`](https://github.com/mcp-tool-shop-org/role-os-rollout). Este repositorio es el producto; el otro es el estado operativo.
|
|
64
|
+
|
|
65
|
+
## Memoria y continuidad
|
|
66
|
+
|
|
67
|
+
Role OS no posee ni duplica la capa de memoria. Cuando existe la memoria del proyecto Claude, esta es el sistema de continuidad canónico: los hechos del repositorio, las decisiones, los problemas pendientes y el historial de tratamiento se almacenan allí.
|
|
68
|
+
|
|
69
|
+
Role OS se integra con la memoria del proyecto Claude. No la reemplaza.
|
|
70
|
+
|
|
71
|
+
## Tratamiento completo y verificación de entrega
|
|
72
|
+
|
|
73
|
+
El tratamiento completo es un protocolo canónico de 7 fases definido en la memoria del proyecto Claude (`memory/full-treatment.md`). Role OS dirige y revisa los tratamientos utilizando contratos de roles, transferencias y puertas de revisión, y no redefine el protocolo.
|
|
74
|
+
|
|
75
|
+
La **verificación de entrega (Shipcheck)** es la puerta de calidad de 31 elementos que se ejecuta antes del tratamiento completo. Las puertas A, B, C y D deben superarse antes de que comience cualquier tratamiento. Referencia canónica: `memory/shipcheck.md`.
|
|
76
|
+
|
|
77
|
+
Orden: Verificación de entrega primero, luego tratamiento completo. No hay versión 1.0.0 sin superar las puertas obligatorias.
|
|
78
|
+
|
|
79
|
+
## 32 roles en 8 paquetes
|
|
80
|
+
|
|
81
|
+
| Paquete | Roles |
|
|
82
|
+
|------|-------|
|
|
83
|
+
| **Core** (3) | Orquestador, Estratega de Producto, Evaluador Crítico. |
|
|
84
|
+
| **Engineering** (7) | Desarrollador Frontend, Ingeniero Backend, Ingeniero de Pruebas, Ingeniero de Refactorización, Ingeniero de Rendimiento, Auditor de Dependencias, Evaluador de Seguridad. |
|
|
85
|
+
| **Design** (2) | Diseñador de Interfaz de Usuario, Guardián de la Marca. |
|
|
86
|
+
| **Marketing** (1) | Redactor para Lanzamiento. |
|
|
87
|
+
| **Treatment** (7) | Investigador de Repositorios, Traductor de Repositorios, Arquitecto de Documentación, Curador de Metadatos, Auditor de Cobertura, Verificador de Despliegue, Ingeniero de Lanzamiento. |
|
|
88
|
+
| **Product** (3) | Sintetizador de comentarios, Priorizador de hoja de ruta, Redactor de especificaciones. |
|
|
89
|
+
| **Research** (4) | Investigador de Experiencia de Usuario, Analista de la Competencia, Investigador de Tendencias, Sintetizador de Entrevistas con Usuarios. |
|
|
90
|
+
| **Growth** (4) | Estratega de Lanzamiento, Estratega de Contenido, Community Manager, Líder de Soporte. |
|
|
91
|
+
|
|
92
|
+
Cada rol tiene un contrato completo: misión, cuándo usar, cuándo no usar, entradas esperadas, salidas requeridas, nivel de calidad y desencadenantes de escalamiento. Cada rol es enrutable; `roleos route` puede recomendar cualquiera de ellos en función del contenido del paquete.
|
|
93
|
+
|
|
94
|
+
## Cómo empezar
|
|
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
|
+
## Cuándo no usar Role OS
|
|
116
|
+
|
|
117
|
+
- Correcciones de una sola línea, errores tipográficos o errores obvios.
|
|
118
|
+
- Investigación exploratoria sin una salida definida.
|
|
119
|
+
- Trabajo que se puede realizar en la mente de una persona en 5 minutos.
|
|
120
|
+
- Correcciones urgentes que deben enviarse antes de que se complete una cadena de revisión.
|
|
121
|
+
- Proyectos donde se prioriza la velocidad sobre la estructura.
|
|
122
|
+
|
|
123
|
+
## Evidencia
|
|
124
|
+
|
|
125
|
+
Role OS se ha probado en tres tipos de tareas diferentes en dos repositorios con estructuras diferentes:
|
|
126
|
+
|
|
127
|
+
**Prueba 001: Trabajo de funciones** (Pantalla de la tripulación, Star Freight)
|
|
128
|
+
- Cadena de 7 roles, 45 escenarios de prueba, 0 conflictos de roles.
|
|
129
|
+
- Evitó la contaminación de un proyecto derivado, detectó invenciones realizadas directamente y reveló bloqueos reales.
|
|
130
|
+
|
|
131
|
+
**Prueba 002: Trabajo de integración** (Conexión de CampaignState, Star Freight)
|
|
132
|
+
- Cadena de 5 roles, resolvió la interfaz arquitectónica sin soluciones alternativas falsas.
|
|
133
|
+
- Las pruebas anti-fallback demostraron que la ruta activa es real, no un marcador de posición.
|
|
134
|
+
|
|
135
|
+
**Prueba 003: Trabajo de identidad** (Eliminación de contaminación, Star Freight)
|
|
136
|
+
- Cadena de 6 roles, 51 escenarios de prueba, incluyendo una defensa duradera contra la contaminación en el sistema de integración continua.
|
|
137
|
+
- Corrigió la desviación de la ficción heredada sin provocar una reestructuración general.
|
|
138
|
+
|
|
139
|
+
**Prueba de portabilidad** (Consistencia de la persona, sensor-humor)
|
|
140
|
+
- Misma estructura base, diferentes idioma/dominio/entorno.
|
|
141
|
+
- Se adapta solo con cambios de contexto; no se realizan modificaciones en el contrato principal.
|
|
142
|
+
|
|
143
|
+
**Tratamiento completo FT-001** (portlight-desktop)
|
|
144
|
+
- Tratamiento con personal en 7 fases con roles del paquete de tratamiento.
|
|
145
|
+
- Verificación de envío probada, sin colisiones de roles.
|
|
146
|
+
|
|
147
|
+
**Tratamiento completo FT-002** (studioflow)
|
|
148
|
+
- Mismo paquete de tratamiento, repositorio estructuralmente diferente (espacio de trabajo creativo vs. juego).
|
|
149
|
+
- Paquete de tratamiento portátil: no se requieren modificaciones en el contrato.
|
|
150
|
+
|
|
151
|
+
## Propiedades fundamentales
|
|
152
|
+
|
|
153
|
+
Estas son innegociables. Si un cambio debilita alguna de ellas, recházalo.
|
|
154
|
+
|
|
155
|
+
- Los límites de los roles se mantienen.
|
|
156
|
+
- La revisión es rigurosa.
|
|
157
|
+
- La escalación se mantiene transparente.
|
|
158
|
+
- Los paquetes siguen siendo verificables.
|
|
159
|
+
- La portabilidad requiere adaptación al contexto, no una modificación profunda.
|
|
160
|
+
|
|
161
|
+
## Estructura del proyecto
|
|
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
|
+
## Seguridad
|
|
190
|
+
|
|
191
|
+
El sistema operativo del rol opera **únicamente de forma local**. Copia las plantillas de Markdown y escribe archivos de paquetes/verdictos en el directorio `.claude/` de su repositorio. No accede a la red, no maneja secretos ni recopila datos de telemetría. No se realizan operaciones peligrosas; todas las escrituras de archivos utilizan la opción "omitir si existe" de forma predeterminada. Consulte [SECURITY.md](SECURITY.md) para obtener la política completa.
|
|
192
|
+
|
|
193
|
+
## El sistema operativo
|
|
194
|
+
|
|
195
|
+
| Capa. | ¿Qué hace? | Estado |
|
|
196
|
+
|-------|-------------|--------|
|
|
197
|
+
| **Routing** | Asigna una puntuación a los 31 roles en función del contenido del paquete, explica las recomendaciones, evalúa la confianza. | ✓ Implementado. |
|
|
198
|
+
| **Chain builder** | Ensambla cadenas ordenadas por fases a partir de roles con puntuación, sesgadas por tipo de paquete, pero no bloqueadas por plantillas. | ✓ Implementado. |
|
|
199
|
+
| **Conflict detection** | Validación de 4 pasos: conflictos graves, secuencia, redundancia, lagunas de cobertura. Sugerencias de corrección. | ✓ Implementado. |
|
|
200
|
+
| **Escalation** | Redirige automáticamente las tareas bloqueadas/rechazadas/divididas al responsable adecuado, junto con la razón y el artefacto requerido. | ✓ Implementado. |
|
|
201
|
+
| **Evidence** | Evidencia estructurada en las decisiones, específica para cada rol. Comprobaciones de suficiencia. 12 tipos de evidencia. | ✓ Implementado. |
|
|
202
|
+
| **Dispatch** | Genera manifiestos de ejecución para multi-claude. Perfiles de herramientas por rol, indicaciones del sistema, presupuestos. | ✓ Implementado. |
|
|
203
|
+
| **Trials** | Lista completa probada: 30/30 tareas de oro + 5/5 pruebas negativas. 7 pruebas de paquete completadas. | ✓ Completo. |
|
|
204
|
+
| **Team Packs** | 7 paquetes calibrados con selección automática, mecanismos de protección contra errores y enrutamiento libre como respaldo. | ✓ Implementado. |
|
|
205
|
+
| **Outcome calibration** | Registra los resultados de la ejecución, ajusta los pesos de los paquetes/roles en función de los resultados y ajusta los umbrales de confianza. | ✓ Implementado. |
|
|
206
|
+
| **Mixed-task decomposition** | Detecta tareas compuestas, las divide en paquetes secundarios, asigna paquetes y conserva las dependencias. | ✓ Implementado. |
|
|
207
|
+
| **Composite execution** | Ejecuta los paquetes secundarios en orden de dependencia, con transferencia de artefactos, recuperación de ramas y síntesis. | ✓ Implementado. |
|
|
208
|
+
| **Adaptive replanning** | Los cambios de alcance, los hallazgos o los nuevos requisitos durante la ejecución actualizan el plan sin necesidad de reiniciar. | ✓ Implementado. |
|
|
209
|
+
| **Session spine** | `roleos init claude` crea CLAUDE.md, /roleos-route, /roleos-review, /roleos-status. `roleos doctor` verifica la configuración. Las tarjetas de enrutamiento demuestran la participación. | ✓ Implementado. |
|
|
210
|
+
| **Hook spine** | 5 ganchos de ciclo de vida (SessionStart, PromptSubmit, PreToolUse, SubagentStart, Stop). Aplicación de políticas: recordatorios en las tarjetas de ruta, control de acceso a herramientas, inyección de roles de subagente, auditoría de finalización. | ✓ Implementado. |
|
|
211
|
+
| **Artifact spine** | 20 contratos de artefactos por rol. 7 contratos de transferencia de paquetes. Validación estructural. Comprobaciones de integridad de la cadena. Los roles posteriores nunca adivinan lo que recibieron. | ✓ Implementado. |
|
|
212
|
+
| **Mission library** | 6 misiones con nombre (desarrollo de características, corrección de errores, implementación, lanzamiento de documentación, endurecimiento de seguridad, lanzamiento de investigación). Cada una define el paquete, la cadena de roles, el flujo de artefactos, las ramas de escalada y una definición honesta y parcial. Las 6 misiones se probaron y se optimizaron. | ✓ Implementado. |
|
|
213
|
+
| **Mission runner** | Crear ejecuciones, avanzar paso a paso con el estado rastreado, completar/fallar con informes precisos. Propagación de pasos bloqueados, advertencias de escalada fuera de la cadena, reapertura del último paso. | ✓ Implementado. |
|
|
214
|
+
| **Unified entry** | `roleos start` decide automáticamente entre una misión, un paquete o una ruta libre. Escalera de respaldo con puntuaciones de confianza, alternativas y detección compuesta. | ✓ Implementado. |
|
|
215
|
+
|
|
216
|
+
## 6 misiones
|
|
217
|
+
|
|
218
|
+
| Misión | Paquete | Roles | Cuándo usar |
|
|
219
|
+
|---------|------|-------|-------------|
|
|
220
|
+
| `feature-ship` | característica | 5 | Entrega completa de una característica: alcance → especificación → implementación → prueba → revisión |
|
|
221
|
+
| `bugfix` | corrección de errores | 4 | Diagnosticar la causa raíz, corregir, probar, verificar |
|
|
222
|
+
| `treatment` | implementación | 4 | Verificación + pulido + documentación + verificación CI + revisión |
|
|
223
|
+
| `docs-release` | documentación | 2 | Escribir/actualizar documentación, notas de la versión |
|
|
224
|
+
| `security-hardening` | Seguridad | 4 | Modelo de amenazas, auditoría, corregir vulnerabilidades, volver a auditar, verificar |
|
|
225
|
+
| `research-launch` | investigación | 4 | Formular la pregunta, investigar, documentar los hallazgos, decidir |
|
|
226
|
+
|
|
227
|
+
Cada misión incluye definiciones honestas y parciales: cuando el trabajo se detiene, el sistema documenta lo que se completó y lo que queda, en lugar de simular una finalización.
|
|
228
|
+
|
|
229
|
+
## Estado
|
|
230
|
+
|
|
231
|
+
- v0.1–v0.4: Fundación: pruebas, adopción, paquete de implementación, paquete de inicio
|
|
232
|
+
- v1.0.0: 32 roles, CLI completa, implementación probada, portabilidad multi-repositorio
|
|
233
|
+
- v1.0.2: Bloqueo del sistema de roles (correcciones de inicialización de la verdad, init --force)
|
|
234
|
+
- v1.1.0: 31 roles, columna vertebral de enrutamiento completa, detección de conflictos, escalada, evidencia, despacho, 7 paquetes de equipo probados. 35 ejecuciones de prueba. 212 pruebas.
|
|
235
|
+
- v1.2.0: Paquetes calibrados promovidos a la entrada predeterminada. Selección automática, detección de incompatibilidades, sugerencia de alternativas, respaldo de enrutamiento libre. 246 pruebas.
|
|
236
|
+
- v1.3.0: Calibración de resultados, descomposición de tareas mixtas, ejecución compuesta, replanificación adaptativa. 317 pruebas.
|
|
237
|
+
- v1.4.0: Columna vertebral de la sesión: `roleos init claude`, `roleos doctor`, tarjetas de ruta, comandos /roleos-route + /roleos-review + /roleos-status. 335 pruebas.
|
|
238
|
+
- v1.5.0: Columna vertebral de los ganchos: 5 ganchos de ciclo de vida para la aplicación en tiempo de ejecución. 358 pruebas.
|
|
239
|
+
- v1.6.0: Columna vertebral de los artefactos: 20 contratos de artefactos por rol, 7 contratos de transferencia de paquetes, validación estructural. 385 pruebas.
|
|
240
|
+
- v1.7.0: Prueba de finalización: tareas reales que se ejecutan a través de toda la pila. CLI `roleos artifacts`. Escalada honesta para correcciones estructurales. 398 pruebas.
|
|
241
|
+
- v1.8.0: Biblioteca de misiones (Fase S): 6 misiones con nombre, motor de ejecución, informes de finalización. Optimizadas a partir de 6 ejecuciones de prueba reales. 481 pruebas.
|
|
242
|
+
- **v1.9.0**: Ruta de entrada unificada (Fase T): `roleos start` decide automáticamente entre una misión, un paquete o una ruta libre. Escalera de respaldo, detección compuesta, pruebas de comparación de la ruta de entrada. 527 pruebas.
|
|
243
|
+
|
|
244
|
+
## Licencia
|
|
245
|
+
|
|
246
|
+
MIT
|
|
247
|
+
|
|
248
|
+
---
|
|
249
|
+
|
|
250
|
+
Creado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a
|