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.pt-BR.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.it.md">Italiano</a> | <a href="README.md">English</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
|
-
## O que ele faz
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
- **Desvio (Drift)** — as funções permanecem em seu domínio. O produto não é redesenhado. A interface não redefine o escopo. O backend não inventa a direção do produto.
|
|
25
|
-
- **Conclusão falsa** — a definição de "concluído" é concreta. O trabalho que esconde lacunas, ignora a verificação ou resolve um problema diferente é rejeitado.
|
|
26
|
-
- **Contaminação** — projetos bifurcados ou herdados carregam resíduos de identidade. O Role OS detecta e rejeita desvios entre projetos em termos, visuais e modelos mentais.
|
|
27
|
-
- **Progresso baseado em impressões** — cada transferência é estruturada. Cada veredicto está vinculado a evidências. "Parece pronto" não é um estado válido.
|
|
28
|
-
|
|
29
|
-
## Como 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.es.md">Español</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.md">English</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
|
+
Um sistema operacional multi-Claude que aloca, direciona, valida e executa tarefas por meio de 31 contratos de funções especializadas. Cria pacotes de tarefas, monta a equipe certa com base em correspondência de funções, detecta problemas antes da execução, direciona automaticamente a recuperação quando o trabalho é bloqueado ou rejeitado e exige evidências estruturadas em cada decisão.
|
|
19
|
+
|
|
20
|
+
## O que ele faz
|
|
21
|
+
|
|
22
|
+
Role OS é a maneira profissional de usar o multi-Claude. Ele evita as falhas específicas que os fluxos de trabalho de IA genéricos produzem:
|
|
23
|
+
|
|
24
|
+
- **Desvio (Drift)** — as funções permanecem em seu domínio. O produto não é redesenhado. A interface não redefine o escopo. O backend não inventa a direção do produto.
|
|
25
|
+
- **Conclusão falsa** — a definição de "concluído" é concreta. O trabalho que esconde lacunas, ignora a verificação ou resolve um problema diferente é rejeitado.
|
|
26
|
+
- **Contaminação** — projetos bifurcados ou herdados carregam resíduos de identidade. O Role OS detecta e rejeita desvios entre projetos em termos, visuais e modelos mentais.
|
|
27
|
+
- **Progresso baseado em impressões** — cada transferência é estruturada. Cada veredicto está vinculado a evidências. "Parece pronto" não é um estado válido.
|
|
28
|
+
|
|
29
|
+
## Como funciona
|
|
30
|
+
|
|
31
|
+
Descreva sua tarefa. O Role OS decide automaticamente o nível de orquestração adequado.
|
|
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
|
+
**A hierarquia de fallback:**
|
|
48
|
+
|
|
49
|
+
1. **Missão:** quando a tarefa corresponde a um fluxo de trabalho recorrente comprovado (correção de bugs, tratamento, lançamento de recursos, documentação, segurança, pesquisa). Cadeia de funções conhecida, fluxo de artefatos, ramificações de escalonamento e definições parciais claras.
|
|
50
|
+
2. **Pacote:** quando a tarefa é uma família conhecida, mas não se encaixa em um formato de missão completo. 7 pacotes de equipe calibrados com seleção automática e proteções contra incompatibilidades.
|
|
51
|
+
3. **Direcionamento livre:** quando a tarefa é nova, mista ou incerta. Avalia todas as 31 funções com base no conteúdo do pacote e monta uma cadeia dinâmica.
|
|
52
|
+
|
|
53
|
+
O sistema nunca força o trabalho a passar pela camada de abstração incorreta. Ele explica por que escolheu cada nível e oferece alternativas.
|
|
54
|
+
|
|
55
|
+
**Depois de direcionado:**
|
|
56
|
+
|
|
57
|
+
1. **Cada função produz uma transferência:** saída estruturada com itens de evidência que reduzem a ambiguidade para a próxima função.
|
|
58
|
+
2. **O revisor avalia em relação ao contrato:** aceita, rejeita ou bloqueia com base em evidências estruturadas, e não em impressões.
|
|
59
|
+
3. **A recuperação é direcionada automaticamente:** o trabalho bloqueado ou rejeitado é direcionado ao resolvedor correto, com um motivo, tipo de recuperação e artefato necessário.
|
|
60
|
+
|
|
61
|
+
## Estado de implantação na organização
|
|
62
|
+
|
|
63
|
+
O estado de implantação em toda a organização (fila, decisões, registros de auditoria, pacotes de bloqueio por repositório) reside em um repositório privado separado: [`role-os-rollout`](https://github.com/mcp-tool-shop-org/role-os-rollout). Este repositório é o produto; aquele repositório é o estado operacional.
|
|
64
|
+
|
|
65
|
+
## Memória e continuidade
|
|
66
|
+
|
|
67
|
+
O Role OS não possui nem duplica a camada de memória. Onde a memória do projeto Claude existe, ela é o sistema de continuidade canônico — os fatos do repositório, decisões, lacunas abertas e histórico de tratamento residem lá.
|
|
68
|
+
|
|
69
|
+
O Role OS se integra com a memória do projeto Claude. Ele não a substitui.
|
|
70
|
+
|
|
71
|
+
## Tratamento completo e verificação de envio
|
|
72
|
+
|
|
73
|
+
O tratamento completo é um protocolo canônico de 7 fases definido na memória do projeto Claude (`memory/full-treatment.md`). O Role OS direciona e revisa os tratamentos usando contratos de função, transferências e portas de revisão — ele não redefine o protocolo.
|
|
74
|
+
|
|
75
|
+
A **verificação de envio (Shipcheck)** é a porta de qualidade de 31 itens que é executada antes do tratamento completo. As portas rígidas A a D devem ser aprovadas antes que qualquer tratamento comece. Referência canônica: `memory/shipcheck.md`.
|
|
76
|
+
|
|
77
|
+
Ordem: Verificação de envio primeiro, depois tratamento completo. Não há v1.0.0 sem a aprovação das portas rígidas.
|
|
78
|
+
|
|
79
|
+
## 32 funções em 8 pacotes
|
|
80
|
+
|
|
81
|
+
| Pacote | Funções |
|
|
82
|
+
|------|-------|
|
|
83
|
+
| **Core** (3) | Coordenador, Estrategista de Produto, Avaliador Crítico |
|
|
84
|
+
| **Engineering** (7) | Desenvolvedor Front-end, Engenheiro Back-end, Engenheiro de Testes, Engenheiro de Refatoração, Engenheiro de Desempenho, Auditor de Dependências, Avaliador de Segurança |
|
|
85
|
+
| **Design** (2) | Designer de Interface, Guardião da Marca |
|
|
86
|
+
| **Marketing** (1) | Redator para Lançamento |
|
|
87
|
+
| **Treatment** (7) | Pesquisador de Repositórios, Tradutor de Repositórios, Arquiteto de Documentação, Curador de Metadados, Auditor de Cobertura, Verificador de Implantação, Engenheiro de Lançamento |
|
|
88
|
+
| **Product** (3) | Sintetizador de feedback, Priorizador de roteiro, Redator de especificações. |
|
|
89
|
+
| **Research** (4) | Pesquisador de Experiência do Usuário, Analista da Concorrência, Pesquisador de Tendências, Sintetizador de Entrevistas com Usuários |
|
|
90
|
+
| **Growth** (4) | Estrategista de Lançamento, Estrategista de Conteúdo, Gerente de Comunidade, Líder de Triagem de Suporte |
|
|
91
|
+
|
|
92
|
+
Cada função tem um contrato completo: missão, quando usar, quando não usar, entradas esperadas, saídas necessárias, padrão de qualidade e gatilhos de escalonamento. Cada função pode ser direcionada — `roleos route` pode recomendar qualquer uma delas com base no conteúdo do pacote.
|
|
93
|
+
|
|
94
|
+
## Como começar
|
|
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 não usar o Role OS
|
|
116
|
+
|
|
117
|
+
- Correções simples, erros de digitação ou bugs óbvios
|
|
118
|
+
- Pesquisa exploratória sem saída definida
|
|
119
|
+
- Trabalho que cabe na cabeça de uma pessoa em 5 minutos
|
|
120
|
+
- Correções emergenciais que precisam ser lançadas antes que a cadeia de revisão seja concluída
|
|
121
|
+
- Projetos onde a velocidade é mais importante que a estrutura
|
|
122
|
+
|
|
123
|
+
## Evidências
|
|
124
|
+
|
|
125
|
+
O Role OS foi comprovado em três modelos de teste em dois repositórios estruturalmente diferentes:
|
|
126
|
+
|
|
127
|
+
**Teste 001 — Trabalho de funcionalidade** (Tela da Equipe, Star Freight)
|
|
128
|
+
- Cadeia de 7 funções, 45 cenários de teste, 0 conflito de funções.
|
|
129
|
+
- Preveniu a contaminação de um ancestral bifurcado, detectou invenções inline e revelou bloqueios reais.
|
|
130
|
+
|
|
131
|
+
**Teste 002 — Trabalho de integração** (Conexão do Estado da Campanha, Star Freight)
|
|
132
|
+
- Cadeia de 5 funções, resolveu a junção arquitetural sem mentiras de fallback.
|
|
133
|
+
- Testes anti-fallback provaram que o caminho ativo é real, não um espaço reservado.
|
|
134
|
+
|
|
135
|
+
**Teste 003 — Trabalho de identidade** (Remoção de contaminação, Star Freight)
|
|
136
|
+
- Cadeia de 6 funções, 51 cenários de teste, incluindo defesa durável contra contaminação do CI.
|
|
137
|
+
- Corrigiu a derivação de ficção herdada sem reverter para uma grande reformulação.
|
|
138
|
+
|
|
139
|
+
**Teste de portabilidade** (Consistência da persona, sensibilidade aos sensores)
|
|
140
|
+
- Mesma estrutura básica, diferentes idiomas/domínios/pilhas de tecnologias.
|
|
141
|
+
- Adaptado apenas com mudanças de contexto — sem modificações no contrato principal.
|
|
142
|
+
|
|
143
|
+
**Tratamento Completo FT-001** (portlight-desktop)
|
|
144
|
+
- Tratamento completo em 7 fases, com funções do Pacote de Tratamento
|
|
145
|
+
- Verificação de lançamento comprovada, sem colisões de funções
|
|
146
|
+
|
|
147
|
+
**Tratamento Completo FT-002** (studioflow)
|
|
148
|
+
- Mesmo pacote de tratamento, repositório estruturalmente diferente (ambiente de criação vs. jogo)
|
|
149
|
+
- Pacote de tratamento portátil — nenhuma modificação no contrato é necessária
|
|
150
|
+
|
|
151
|
+
## Propriedades essenciais
|
|
152
|
+
|
|
153
|
+
Estas são inegociáveis. Se uma alteração enfraquecer qualquer uma delas, rejeite-a.
|
|
154
|
+
|
|
155
|
+
- Os limites de função são mantidos.
|
|
156
|
+
- A revisão é rigorosa.
|
|
157
|
+
- A escalação permanece transparente.
|
|
158
|
+
- Os pacotes permanecem testáveis.
|
|
159
|
+
- A portabilidade requer adaptação ao contexto, não alterações profundas na estrutura.
|
|
160
|
+
|
|
161
|
+
## Estrutura do projeto
|
|
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
|
+
## Segurança
|
|
190
|
+
|
|
191
|
+
O sistema "Role OS" opera **apenas localmente**. Ele copia modelos em formato Markdown e escreve arquivos de pacotes/resultados no diretório `.claude/` do seu repositório. Ele não acessa a rede, não lida com informações confidenciais e não coleta dados de telemetria. Não há operações perigosas — todas as operações de escrita de arquivos usam a opção "skip-if-exists" por padrão. Consulte o arquivo [SECURITY.md](SECURITY.md) para a política completa.
|
|
192
|
+
|
|
193
|
+
## O sistema operacional
|
|
194
|
+
|
|
195
|
+
| Camada. | O que ele faz | Status |
|
|
196
|
+
|-------|-------------|--------|
|
|
197
|
+
| **Routing** | Avalia todas as 31 funções com base no conteúdo do pacote, explica as recomendações, avalia a confiança. | ✓ Implementado. |
|
|
198
|
+
| **Chain builder** | Monta cadeias ordenadas por fase a partir de funções classificadas, com viés para o tipo de pacote, mas não bloqueadas por modelos. | ✓ Implementado. |
|
|
199
|
+
| **Conflict detection** | Validação em 4 etapas: conflitos graves, sequência, redundância, lacunas de cobertura. Sugestões de correção. | ✓ Implementado. |
|
|
200
|
+
| **Escalation** | Direciona automaticamente o trabalho bloqueado/rejeitado/dividido para o resolvedor correto, com motivo + artefato necessário. | ✓ Implementado. |
|
|
201
|
+
| **Evidence** | Evidências estruturadas em decisões, específicas para cada função. Verificações de suficiência. 12 tipos de evidência. | ✓ Implementado. |
|
|
202
|
+
| **Dispatch** | Gera manifestos de execução para multi-claude. Perfis de ferramentas por função, prompts do sistema, orçamentos. | ✓ Implementado. |
|
|
203
|
+
| **Trials** | Conjunto completo comprovado: 30/30 tarefas de sucesso + 5/5 testes negativos. 7 testes de pacote concluídos. | ✓ Completo. |
|
|
204
|
+
| **Team Packs** | 7 pacotes calibrados com seleção automática, proteções contra incompatibilidades e fallback de direcionamento livre. | ✓ Implementado. |
|
|
205
|
+
| **Outcome calibration** | Registra os resultados da execução, ajusta os pesos dos pacotes/funções com base nos resultados e ajusta os limites de confiança. | ✓ Implementado. |
|
|
206
|
+
| **Mixed-task decomposition** | Detecta trabalhos compostos, divide em pacotes filhos, atribui pacotes, preserva dependências. | ✓ Implementado. |
|
|
207
|
+
| **Composite execution** | Executa pacotes filhos na ordem de dependência, com passagem de artefatos, recuperação de ramificação e síntese. | ✓ Implementado. |
|
|
208
|
+
| **Adaptive replanning** | Alterações de escopo, descobertas ou novos requisitos durante a execução atualizam o plano sem reinicialização. | ✓ Implementado. |
|
|
209
|
+
| **Session spine** | `roleos init claude` cria os arquivos CLAUDE.md, /roleos-route, /roleos-review, /roleos-status. `roleos doctor` verifica as conexões. Os cartões de roteamento comprovam o engajamento. | ✓ Implementado. |
|
|
210
|
+
| **Hook spine** | 5 ganchos de ciclo de vida (SessionStart, PromptSubmit, PreToolUse, SubagentStart, Stop). Aplicação de políticas: lembretes de roteamento, controle de acesso a ferramentas, injeção de papéis de subagente, auditoria de conclusão. | ✓ Implementado. |
|
|
211
|
+
| **Artifact spine** | 20 contratos de artefatos por papel. 7 contratos de transferência de pacotes. Validação estrutural. Verificações de integridade da cadeia. Os papéis subsequentes nunca adivinham o que receberam. | ✓ Implementado. |
|
|
212
|
+
| **Mission library** | 6 missões nomeadas (feature-ship, bugfix, treatment, docs-release, security-hardening, research-launch). Cada uma define pacote, cadeia de papéis, fluxo de artefatos, ramificações de escalonamento, definição honesta e parcial. Todas as 6 foram testadas e aprimoradas. | ✓ Implementado. |
|
|
213
|
+
| **Mission runner** | Criação de execuções, acompanhamento passo a passo com estado rastreado, conclusão/falha com relatórios precisos. Propagação de etapas bloqueadas, avisos de escalonamento fora da cadeia, reabertura da última etapa. | ✓ Implementado. |
|
|
214
|
+
| **Unified entry** | `roleos start` decide automaticamente entre missão, pacote ou roteamento livre. Sistema de fallback com pontuações de confiança, alternativas e detecção composta. | ✓ Implementado. |
|
|
215
|
+
|
|
216
|
+
## 6 missões
|
|
217
|
+
|
|
218
|
+
| Missão | Pacote | Funções | Quando usar |
|
|
219
|
+
|---------|------|-------|-------------|
|
|
220
|
+
| `feature-ship` | Funcionalidade (feature) | 5 | Entrega completa da funcionalidade: escopo → especificação → implementação → teste → revisão |
|
|
221
|
+
| `bugfix` | Correção de bug (bugfix) | 4 | Diagnosticar a causa raiz, corrigir, testar, verificar |
|
|
222
|
+
| `treatment` | Tratamento | 4 | Verificação + polimento + documentação + verificação CI + revisão |
|
|
223
|
+
| `docs-release` | Documentação | 2 | Escrever/atualizar documentação, notas de lançamento |
|
|
224
|
+
| `security-hardening` | Segurança | 4 | Modelo de ameaças, auditoria, correção de vulnerabilidades, re-auditoria, verificação |
|
|
225
|
+
| `research-launch` | Pesquisa | 4 | Formular a pergunta, pesquisar, documentar os resultados, decidir |
|
|
226
|
+
|
|
227
|
+
Cada missão inclui definições honestas e parciais — quando o trabalho é interrompido, o sistema documenta o que foi concluído e o que resta, em vez de apresentar uma conclusão falsa.
|
|
228
|
+
|
|
229
|
+
## Status
|
|
230
|
+
|
|
231
|
+
- v0.1–v0.4: Fundação — testes, adoção, pacote de tratamento, pacote inicial
|
|
232
|
+
- v1.0.0: 32 papéis, CLI completa, tratamento comprovado, portabilidade multi-repositório
|
|
233
|
+
- v1.0.2: Bloqueio do sistema de papéis (correções de inicialização da verdade, init --force)
|
|
234
|
+
- v1.1.0: 31 papéis, espinha dorsal de roteamento completa, detecção de conflitos, escalonamento, evidências, despacho, 7 pacotes de equipe comprovados. 35 execuções de teste. 212 testes.
|
|
235
|
+
- v1.2.0: Pacotes calibrados promovidos à entrada padrão. Seleção automática, detecção de incompatibilidades, sugestão de alternativas, fallback de roteamento livre. 246 testes.
|
|
236
|
+
- v1.3.0: Calibração de resultados, decomposição de tarefas mistas, execução composta, replanejamento adaptativo. 317 testes.
|
|
237
|
+
- v1.4.0: Espinha dorsal da sessão — `roleos init claude`, `roleos doctor`, cartões de roteamento, comandos /roleos-route + /roleos-review + /roleos-status. 335 testes.
|
|
238
|
+
- v1.5.0: Espinha dorsal de ganchos — 5 ganchos de ciclo de vida para aplicação de políticas em tempo de execução. 358 testes.
|
|
239
|
+
- v1.6.0: Espinha dorsal de artefatos — 20 contratos de artefatos por papel, 7 contratos de transferência de pacotes, validação estrutural. 385 testes.
|
|
240
|
+
- v1.7.0: Prova de conclusão — tarefas reais executadas em toda a pilha. CLI `roleos artifacts`. Escalonamento honesto para correções estruturais. 398 testes.
|
|
241
|
+
- v1.8.0: Biblioteca de missões (Fase S) — 6 missões nomeadas, motor de execução, relatórios de conclusão. Aprimorado a partir de 6 execuções de teste reais. 481 testes.
|
|
242
|
+
- **v1.9.0**: Caminho de entrada unificado (Fase T) — `roleos start` decide automaticamente entre missão, pacote ou roteamento livre. Sistema de fallback, detecção composta, testes de comparação de caminho de entrada. 527 testes.
|
|
243
|
+
|
|
244
|
+
## Licença
|
|
245
|
+
|
|
246
|
+
MIT
|
|
247
|
+
|
|
248
|
+
---
|
|
249
|
+
|
|
250
|
+
Desenvolvido por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a
|