pantheon-opencode 2.0.0-beta.5 → 2.0.0-rc.1
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/AGENTS.global.md +6 -1
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +67 -0
- package/README.md +169 -510
- package/README.pt-BR.md +177 -149
- package/bin/pantheon-init.mjs +1 -1
- package/commands/pantheon-deepwork.md +6 -1
- package/commands/pantheon.md +10 -5
- package/package.json +1 -1
- package/plugin.json +2 -2
- package/prompts/orchestrate-with-zeus.prompt.md +82 -290
- package/prompts/subtask.prompt.md +1 -1
- package/pyproject.toml +1 -1
- package/scripts/doctor.mjs +27 -11
- package/scripts/hooks/format-multi-language.sh +30 -48
- package/scripts/install/opencode.mjs +13 -1
- package/scripts/jev-live-probe.mjs +1 -1
- package/scripts/release-gates.mjs +19 -5
- package/scripts/skill-search.mjs +66 -7
- package/scripts/test-opencode-sandbox.sh +44 -15
- package/scripts/update.mjs +9 -2
- package/skills-lock.json +5 -3
- package/src/agents/aphrodite.md +2 -0
- package/src/agents/apollo.md +8 -206
- package/src/agents/athena.md +25 -29
- package/src/agents/hermes.md +3 -1
- package/src/agents/mnemosyne.md +1 -1
- package/src/agents/nyx.md +1 -1
- package/src/agents/prometheus.md +0 -203
- package/src/agents/talos.md +2 -0
- package/src/agents/themis.md +8 -3
- package/src/agents/zeus.md +18 -12
- package/src/instructions/memory-protocol.instructions.md +4 -0
- package/src/instructions/test-economy.instructions.md +1 -0
- package/src/instructions/zeus-council-synthesis.instructions.md +13 -1
- package/src/pantheon/goal-loop-config.ts +55 -0
- package/src/pantheon/native-vision.ts +9 -5
- package/src/pantheon/pantheon-decision-catalog.ts +8 -0
- package/src/pantheon/skill-search-tool.ts +193 -0
- package/src/pantheon/tools.ts +2 -0
- package/src/pantheon/vision.ts +14 -1
- package/src/plugin.ts +39 -7
- package/src/plugins/tui/dist/tui.d.ts +12 -2
- package/src/plugins/tui/dist/tui.d.ts.map +1 -1
- package/src/plugins/tui/dist/tui.js +1399 -365
- package/src/plugins/tui/dist/tui.js.map +1 -1
- package/src/plugins/tui/package-lock.json +2 -2
- package/src/plugins/tui/package.json +1 -1
- package/src/plugins/tui/src/autonomy-state.ts +149 -0
- package/src/plugins/tui/src/context-gauge.ts +64 -5
- package/src/plugins/tui/src/decision-router-state.ts +175 -6
- package/src/plugins/tui/src/index.tsx +25 -3
- package/src/plugins/tui/src/pantheon-settings-state.ts +99 -0
- package/src/plugins/tui/src/pantheon-settings.tsx +647 -103
- package/src/plugins/tui/src/tui-prefs.ts +161 -9
- package/src/plugins/tui/src/update-status.ts +27 -8
- package/src/routing.yml +9 -0
- package/src/skills/README.md +35 -25
- package/src/skills/fast-path-execution/SKILL.md +54 -0
- package/src/skills/prompt-refinery/SKILL.md +53 -37
- package/src/skills/tdd-with-agents/SKILL.md +22 -10
- package/src/skills/test-slicing/SKILL.md +56 -0
- package/src/skills/verification-planning/SKILL.md +4 -3
package/README.pt-BR.md
CHANGED
|
@@ -1,11 +1,8 @@
|
|
|
1
|
-
<!-- synced-from: README.md
|
|
1
|
+
<!-- synced-from: README.md -->
|
|
2
2
|
# Pantheon
|
|
3
3
|
|
|
4
|
-
**Uma forma mais clara de trabalhar com OpenCode em projetos de software
|
|
5
|
-
|
|
6
|
-
numa experiência guiada. É um plugin e instalador para OpenCode, feito para
|
|
7
|
-
desenvolvedores e equipes que querem estrutura útil sem abrir mão do controle
|
|
8
|
-
sobre o próprio código.
|
|
4
|
+
**Uma forma mais clara, rápida e eficiente de trabalhar com OpenCode em projetos de software reais.**
|
|
5
|
+
O Pantheon reúne planejamento, implementação, revisão e documentação numa experiência guiada e otimizada para tokens. É um plugin e instalador para OpenCode feito para desenvolvedores e equipes que querem estrutura útil sem abrir mão de velocidade ou do controle sobre seu código.
|
|
9
6
|
|
|
10
7
|
[English](README.md) ·
|
|
11
8
|
[Repositório](https://github.com/ils15/pantheon-opencode) · [Licença MIT](LICENSE)
|
|
@@ -16,178 +13,209 @@ sobre o próprio código.
|
|
|
16
13
|
|
|
17
14
|
## O que é?
|
|
18
15
|
|
|
19
|
-
O Pantheon é um companheiro do [OpenCode](https://opencode.ai/) que ajuda a ir
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
16
|
+
O Pantheon é um companheiro do [OpenCode](https://opencode.ai/) que ajuda você a ir de uma ideia até uma alteração revisada e verificada. Quatorze agentes especializados compartilham um fluxo direto e consistente: planejar, implementar, checar, revisar e registrar o que foi importante. Você permanece no controle de cada decisão e de cada merge.
|
|
17
|
+
|
|
18
|
+
```mermaid
|
|
19
|
+
flowchart LR
|
|
20
|
+
U["Você"] --> Z["Zeus<br/>orquestrador"]
|
|
21
|
+
Z -->|"delega"| S["14 especialistas<br/>hermes · aphrodite · demeter · themis …"]
|
|
22
|
+
Z -->|"rota ambígua"| J["Jev decision router<br/>tipado · com budget · reversível"]
|
|
23
|
+
J -->|"ordena · classifica · verifica"| S
|
|
24
|
+
S -->|"último recurso"| M["MCP nativo<br/>memória · persistência · visão<br/>code-mode · recursos"]
|
|
25
|
+
Z --> G["J1 risk gate<br/>off / shadow / warn / enforce"]
|
|
26
|
+
G -->|"alto risco"| H["Aprovação humana"]
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
**A escada de escalonamento que todo agente segue**: contexto da sessão primeiro → seletor local gratuito → uma decisão Jev tipada quando genuinamente ambíguo → chamada a MCP nativo apenas como último recurso para estado que a sessão não puder reconstruir.
|
|
30
|
+
|
|
31
|
+
```mermaid
|
|
32
|
+
flowchart LR
|
|
33
|
+
R["pedido inicial"] --> T0{"claro e<br/>delimitado?"}
|
|
34
|
+
T0 -->|sim| X["executar diretamente"]
|
|
35
|
+
T0 -->|"vago /<br/>múltiplos tópicos"| T1["Tier 1 — interno<br/>ajuste mínimo ≤15 linhas<br/>(silencioso, sem aprovação)"]
|
|
36
|
+
T1 --> T2q{">> fornecido?"}
|
|
37
|
+
T2q -->|sim| T2["Tier 2 — contrato completo<br/>6 seções, confirmar-ou-ajustar"]
|
|
38
|
+
T2q -->|não| X
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
**A descoberta de skills segue uma cascata de confiança** — canônicas primeiro, popularidade nunca compensa proveniência:
|
|
42
|
+
|
|
43
|
+
```mermaid
|
|
44
|
+
flowchart LR
|
|
45
|
+
L["pool instalado<br/>(sempre primeiro)"] -->|"lacuna"| C1["anthropics/skills<br/>canônica"]
|
|
46
|
+
C1 -->|"sem ajuste"| C2["skills.sh<br/>sinal por instalações"]
|
|
47
|
+
C2 -->|"sem ajuste"| C3["GitHub raw<br/>mais ampla, menor confiança"]
|
|
48
|
+
C3 --> J["Jev ordena<br/>os candidatos"]
|
|
49
|
+
J --> P["VOCÊ revisa<br/>e roda o install"]
|
|
50
|
+
```
|
|
23
51
|
|
|
24
52
|
## Por que usar?
|
|
25
53
|
|
|
26
|
-
- **
|
|
27
|
-
- **
|
|
28
|
-
|
|
29
|
-
- **
|
|
30
|
-
|
|
31
|
-
- **Você no comando:** o Pantheon apoia seu julgamento; não o substitui.
|
|
32
|
-
- **Coordenação na medida:** trabalho delimitado vai para um especialista, que
|
|
33
|
-
reúne o contexto necessário. Planejamento, descoberta separada, paralelismo e
|
|
34
|
-
revisão entram quando escopo e risco pedem. `/pantheon-deepwork` continua sendo
|
|
35
|
-
o fluxo com checkpoints para trabalho pesado em várias fases.
|
|
54
|
+
- **Execução Fast-Track:** Micro-edições delimitadas (<= 2 arquivos, <= 50 linhas) pulam cerimônias pesadas e validam em < 10 segundos.
|
|
55
|
+
- **Fatiamento mandatório de testes (test slicing):** Execução direcionada em submissegundos em vez de rodar suites lentas do repositório inteiro durante loops de desenvolvimento.
|
|
56
|
+
- **Conselho assertivo (`/pantheon`):** Consultas paralelas entre especialistas resolvidas decisivamente via autoridade de domínio e decisões multi-critério JEV sem loops infinitos de debate.
|
|
57
|
+
- **Você no comando:** O Pantheon apoia seu julgamento; ele nunca altera permissões silenciosamente nem executa ações destrutivas sem aprovação.
|
|
58
|
+
- **Atualizações não-destrutivas:** Atualizar o Pantheon (`pantheon-opencode update`) renova skills, MCPs e instruções preservando rigorosamente todos os modelos do usuário, presets ativos, permissões e regras customizadas no `AGENTS.md`.
|
|
36
59
|
|
|
37
60
|
## Comece em 2 minutos
|
|
38
61
|
|
|
39
|
-
Requisitos: [OpenCode](https://opencode.ai/docs/) **2.x** e Node.js
|
|
40
|
-
**>=26.4.0** para a CLI e as ferramentas. **OpenCode 2.0.22 tem falha
|
|
41
|
-
conhecida**; veja [Compatibilidade](docs/COMPATIBILITY.md).
|
|
62
|
+
Requisitos: [OpenCode](https://opencode.ai/docs/) **2.x** e Node.js **>=26.4.0**. (Veja [Compatibilidade](docs/COMPATIBILITY.md)).
|
|
42
63
|
|
|
43
|
-
|
|
64
|
+
### 1. Instalação
|
|
44
65
|
|
|
66
|
+
**Opção A — Adição Rápida de Plugin (Global ou no Projeto):**
|
|
45
67
|
```bash
|
|
46
68
|
opencode plugin add pantheon-opencode
|
|
47
|
-
#
|
|
48
|
-
opencode
|
|
69
|
+
# Ou fixe uma versão específica:
|
|
70
|
+
opencode plugin add pantheon-opencode@2.0.0-rc.1
|
|
49
71
|
```
|
|
50
72
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
73
|
+
**Opção B — Instalação Global via CLI com Tooling MCP Completo:**
|
|
74
|
+
```bash
|
|
75
|
+
npm install -g pantheon-opencode@beta
|
|
76
|
+
pantheon-opencode init --yes
|
|
77
|
+
```
|
|
54
78
|
|
|
55
|
-
|
|
79
|
+
### 2. Verificação de Saúde
|
|
80
|
+
```bash
|
|
81
|
+
pantheon-opencode doctor
|
|
82
|
+
```
|
|
83
|
+
Executa um diagnóstico de 28 pontos checando inicialização de MCPs, ambientes virtuais Python, versão do Node, permissões e integridade de configuração.
|
|
56
84
|
|
|
57
|
-
|
|
58
|
-
|
|
85
|
+
### 3. Atualizando o Pantheon sem Sobrescrever Configurações
|
|
86
|
+
Quando uma nova versão for lançada:
|
|
87
|
+
```bash
|
|
88
|
+
pantheon-opencode update
|
|
59
89
|
```
|
|
90
|
+
O atualizador valida a identidade do pacote, baixa a versão mais recente e executa uma atualização de configuração totalmente não-destrutiva. **Seus modelos personalizados, preset ativo, permissões customizadas, opções de plugins e seções próprias no AGENTS.md são preservados sem alterações.**
|
|
60
91
|
|
|
61
|
-
|
|
62
|
-
conversa principal antes de pedir aprovação — nunca como um plano escondido na
|
|
63
|
-
conversa de um agente filho.
|
|
64
|
-
|
|
65
|
-
Reinicie o OpenCode depois de instalar ou trocar o plugin. O Pantheon registra
|
|
66
|
-
um único plugin; o host nunca carrega dois plugins Pantheon.
|
|
67
|
-
|
|
68
|
-
Flags do instalador, códigos de saída, planos salvos, backup e restore,
|
|
69
|
-
desinstalação, reconcile e pins de MCP estão no
|
|
70
|
-
[guia de instalação](docs/INSTALLATION.md). Para os primeiros dez minutos
|
|
71
|
-
apenas — `init` → reiniciar → `/dispatch` → primeiro resultado — veja o
|
|
72
|
-
[Início rápido](docs/QUICKSTART.md).
|
|
73
|
-
|
|
74
|
-
## O que está incluído?
|
|
75
|
-
|
|
76
|
-
- **14 agentes especializados**, com um orquestrador, especialistas de
|
|
77
|
-
implementação, um gate de qualidade e papéis de apoio.
|
|
78
|
-
- **23 skills** e instruções reutilizáveis para planejar, construir, revisar e
|
|
79
|
-
documentar.
|
|
80
|
-
- **5 servidores MCP locais** para memória de projeto, persistência, recursos,
|
|
81
|
-
execução confinada de scripts e visão.
|
|
82
|
-
- **Um roteador de decisão seletivo e consultivo**, com resultados locais
|
|
83
|
-
estruturados e recomendações por turno quando habilitado. O egress direto
|
|
84
|
-
pertencente ao Pantheon é inativo; o egress nativo existe apenas na tool
|
|
85
|
-
explícita `pantheon_jev_decide` (só para o Zeus), que chama a API nativa de
|
|
86
|
-
Decisions do host (Jev/TypeSafe via OpenCode Console ou modelo configurado)
|
|
87
|
-
atrás do consentimento e dos limites de orçamento do usuário — ela nunca
|
|
88
|
-
despacha agentes, executa skills ou altera permissões. Veja a
|
|
89
|
-
[referência do roteador](docs/reference/local-decision-router.md) e o
|
|
90
|
-
[Decisions nativas (Jev)](docs/reference/native-decisions.md).
|
|
91
|
-
- **Uma TUI opcional**, com bloco de dispatch na sidebar e painel `/dispatch`
|
|
92
|
-
em largura total. A sidebar mantém a versão do Pantheon, o preset/fonte
|
|
93
|
-
ativos, o estado do git e um bloco `Context` (tokens, medidor de percentual,
|
|
94
|
-
`$<gasto> gastos` e uma linha mutada `cache <n>% · <n.n> tok/s`); o rodapé
|
|
95
|
-
nativo do prompt segue intacto, e o Pantheon só acrescenta
|
|
96
|
-
`▸<preset> · ✦<n> ativos` enquanto há delegações rodando. A TUI não traz mais
|
|
97
|
-
painel de quota: para ver quota e uso de provedores dentro do OpenCode,
|
|
98
|
-
instale o plugin comunitário recomendado
|
|
99
|
-
[`@slkiser/opencode-quota`](https://github.com/slkiser/opencode-quota) — veja
|
|
100
|
-
[Quota & uso](docs/tui-v2-quota-providers.md). As tools `pantheon_cost` e
|
|
101
|
-
`pantheon_model` seguem funcionando sem alterações.
|
|
102
|
-
|
|
103
|
-
A memória MCP fica disponível para busca explícita: o coordenador consulta o
|
|
104
|
-
histórico uma vez quando ele pode mudar a tarefa e repassa apenas resultados
|
|
105
|
-
úteis. Checkpoints de sessão servem para retomadas entre sessões; memória
|
|
106
|
-
durável só é gravada quando solicitada ou autorizada. A compactação nativa do
|
|
107
|
-
OpenCode resume a conversa atual, sem salvar cada fase em outro MCP.
|
|
108
|
-
Veja [Memória](docs/MEMORY.md).
|
|
109
|
-
|
|
110
|
-
## Compatibilidade
|
|
111
|
-
|
|
112
|
-
OpenCode **2.x** é suportado. **OpenCode 2.0.22 tem falha conhecida.** A 2.0
|
|
113
|
-
remove o contrato V1 do OpenCode por completo — a 1.7.x foi a última linha com
|
|
114
|
-
suporte V1.
|
|
115
|
-
|
|
116
|
-
A política de suporte, a exceção conhecida e a evidência de versões verificadas
|
|
117
|
-
têm um único lar: [Compatibilidade](docs/COMPATIBILITY.md).
|
|
118
|
-
|
|
119
|
-
## Delegação
|
|
120
|
-
|
|
121
|
-
O Pantheon delega pelo motor nativo de sessões filhas do host: `subagent` no
|
|
122
|
-
runtime raiz relatado pelo usuário, chamado de `task()` na documentação de
|
|
123
|
-
host/API. Disponibilidade de ferramenta, suporte a background e observabilidade
|
|
124
|
-
de conclusão dependem do runtime; quando a conclusão não é observável, use
|
|
125
|
-
dispatch síncrono ou aguarde uma notificação do host.
|
|
126
|
-
|
|
127
|
-
Todo dispatch raiz leva um briefing conciso — objetivo, escopo limitado,
|
|
128
|
-
entradas relevantes, restrições, formato de retorno esperado e verificação. Os
|
|
129
|
-
contratos de retorno são específicos por papel: implementação usa
|
|
130
|
-
`## subtask_summary`, investigação devolve achados estruturados, Athena devolve
|
|
131
|
-
o plano completo e respostas de conselho usam `## specialist_response`.
|
|
132
|
-
Trabalho delegado tem no máximo uma retentativa após falha transitória, e o
|
|
133
|
-
Pantheon nunca alega fan-in determinístico ou recuperação de job sem um
|
|
134
|
-
mecanismo exposto.
|
|
135
|
-
|
|
136
|
-
O modelo de delegação, a matriz chamador/alvo e os gates de aprovação estão em
|
|
137
|
-
[Arquitetura](docs/ARCHITECTURE.md) e
|
|
138
|
-
[Permissões, Gates e Delegação](docs/PERMISSIONS-QUALITY-DELEGATION.md).
|
|
92
|
+
---
|
|
139
93
|
|
|
140
|
-
##
|
|
94
|
+
## Modos de Execução & Fluxo Ótimo
|
|
95
|
+
|
|
96
|
+
O Pantheon equilibra velocidade e rigor através de três modos de execução:
|
|
97
|
+
|
|
98
|
+
```mermaid
|
|
99
|
+
flowchart TD
|
|
100
|
+
Req["Pedido do Usuário"] --> Size{"Escopo / Risco"}
|
|
101
|
+
Size -->|"≤ 2 arquivos · ≤ 50 linhas<br/>correção / typo / CSS"| Fast["Fast-Track<br/>(Sub-10s · Test Slicing Inline)"]
|
|
102
|
+
Size -->|"Arquitetura / Escolha técnica<br/>Segurança / Multi-stakeholders"| Council["Síntese do Conselho (/pantheon)<br/>(2-3 Especialistas em Paralelo · Autoridade de Domínio)"]
|
|
103
|
+
Size -->|"Feature multi-fases<br/>Refatoração pesada · Breaking change"| Deep["Deepwork (/pantheon-deepwork)<br/>(Plano da Athena · Gates de Fase · Checkpoints)"]
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### 1. Fast-Track & Test Slicing (Micro-Edições < 10s)
|
|
107
|
+
Para correções de bugs pontuais, ajustes de estilo ou refatorações localizadas:
|
|
108
|
+
- **Sem cerimônia de planejamento:** Executa diretamente as alterações delimitadas.
|
|
109
|
+
- **Fatiamento direcionado de testes:** Executa APENAS a fatia de testes correspondente ao arquivo modificado (ex: `node --test tests/foo.test.mjs` ou `pytest -k <func>`). Suites completas são reservadas para CI e release gates.
|
|
110
|
+
- **Entrega em turno único:** Valida e finaliza em menos de 10 segundos.
|
|
141
111
|
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
112
|
+
### 2. Síntese Assertiva do Conselho (`/pantheon`)
|
|
113
|
+
Ao enfrentar encruzilhadas arquiteturais, avaliações tecnológicas ou trade-offs de segurança:
|
|
114
|
+
```text
|
|
115
|
+
/pantheon Devemos usar WebSockets ou Server-Sent Events para notificações push em tempo real?
|
|
116
|
+
```
|
|
117
|
+
- **Despacho Paralelo:** Dispara 2 a 3 especialistas simultaneamente com prompts independentes.
|
|
118
|
+
- **Arbitragem Assertiva:** Em vez de travar em rodadas repetitivas de debate, divergências são resolvidas de imediato via **Precedência de Autoridade de Domínio**:
|
|
119
|
+
- **Segurança / Auth:** `@themis` tem poder de veto sobre propostas vulneráveis.
|
|
120
|
+
- **Banco de Dados / Schema:** `@demeter` tem autoridade técnica sobre consultas e integridade transacional.
|
|
121
|
+
- **Frontend / UX / A11y:** `@aphrodite` rege acessibilidade e ergonomia visual.
|
|
122
|
+
- **Infraestrutura / CI:** `@prometheus` rege limites de runtime, containers e pipelines.
|
|
123
|
+
- **API / Protocolos:** `@hermes` rege conformidade contratual e esquemas de transporte.
|
|
124
|
+
- **Arquitetura / Modularidade:** `@athena` rege desacoplamento e manutenibilidade a longo prazo.
|
|
125
|
+
- **Decisões Multi-Critério JEV:** Se os trade-offs equilibrarem demandas concorrentes de mesmo peso, Zeus invoca `pantheon_jev_decide` (ou a matriz de decisão local) para ordenar as opções deterministicamente em uma única chamada.
|
|
126
|
+
|
|
127
|
+
### 3. Deepwork com Checkpoints (`/pantheon-deepwork`)
|
|
128
|
+
Para tarefas complexas com mais de 10 turnos ou distribuídas em várias sessões:
|
|
129
|
+
```text
|
|
130
|
+
/pantheon-deepwork "Implementar autenticação OAuth2 PKCE"
|
|
131
|
+
```
|
|
132
|
+
- **Fase 0 (Plano):** Athena mapeia os módulos e devolve o plano completo em Markdown exibido diretamente na conversa principal.
|
|
133
|
+
- **Fase 1 (Descoberta):** Apollo realiza exploração estruturada.
|
|
134
|
+
- **Fases 2–N (Implementação):** Especialistas implementam os módulos em fases paralelas.
|
|
135
|
+
- **Gates de Revisão:** Themis audita cada fase (`PASS` ou `FAIL`).
|
|
136
|
+
- **Resumibilidade:** Progresso salvo em `.pantheon/deepwork/<slug>/`. Retome a qualquer momento com `/pantheon-deepwork --resume <slug>`.
|
|
152
137
|
|
|
153
|
-
|
|
154
|
-
> Este README e o [guia de atualização](docs/UPGRADING.pt-BR.md) são as duas
|
|
155
|
-
> páginas mantidas em português.
|
|
138
|
+
---
|
|
156
139
|
|
|
157
|
-
##
|
|
140
|
+
## Os 14 Agentes Especializados
|
|
141
|
+
|
|
142
|
+
Toda delegação raiz carrega um brief conciso — objetivo, escopo delimitado, entradas relevantes, restrições, formato de retorno esperado e critérios de verificação. O trabalho é roteado de forma qualitativa — incerteza, especialidade de domínio, dependências, risco e verificação — nunca por limites arbitrários de linhas. Os contratos de retorno são específicos por papel: implementação usa `## subtask_summary`, investigações retornam achados estruturados, Athena entrega o plano completo e respostas ao conselho usam `## specialist_response`.
|
|
143
|
+
|
|
144
|
+
| Agente | Autoridade de Domínio | Responsabilidades Principais |
|
|
145
|
+
|---|---|---|
|
|
146
|
+
| **@zeus** | Orquestrador Central | Direciona o fluxo, delega tarefas, arbitra decisões do conselho e garante economia de tokens. Nunca implementa código diretamente. |
|
|
147
|
+
| **@athena** | Arquitetura e Planejamento | Planejamento research-first, fronteiras de sistema, LTS e análise de dependências. Plan-only; nunca implementa. |
|
|
148
|
+
| **@hermes** | Backend e APIs | FastAPI, Python assíncrono, backends Node/TypeScript, contratos de API e conformidade de protocolos. |
|
|
149
|
+
| **@aphrodite** | Frontend e UX | React 19, TypeScript estrito, design responsivo, acessibilidade WCAG e CSS moderno. |
|
|
150
|
+
| **@demeter** | Banco de Dados e Persistência | Migrações de schema, otimização de queries, prevenção de queries N+1 e integridade transacional. |
|
|
151
|
+
| **@themis** | Gate de Qualidade e Segurança | Auditorias OWASP, análise estática (Biome/ruff), autorização e limpeza de código legado. Revisa mudanças materiais. |
|
|
152
|
+
| **@prometheus** | DevOps e Infraestrutura | Docker, pipelines CI/CD, configuração de runtime, abstração de provedores e infra de telemetria. |
|
|
153
|
+
| **@talos** | Linha Rápida de Hotfixes | Correções rápidas e autônomas para bugs pequenos, typos e lógica simples sem sobrecarga de subagentes. |
|
|
154
|
+
| **@apollo** | Batedor de Investigação | Descoberta somente-leitura: buscas paralelas no código e na documentação. Retorna achados estruturados. |
|
|
155
|
+
| **@hephaestus**| Pipelines de IA e RAG | Embeddings, vector stores, engenharia de prompt e pipelines de agentes. |
|
|
156
|
+
| **@gaia** | Sensoriamento e Geoespacial | Sensoriamento remoto, SAR, análise geoespacial e classificação raster ML/DL (somente-leitura). |
|
|
157
|
+
| **@iris** | Operações Git e Release | Branches, PRs, triagem de issues e notas de lançamento. Nunca faz push ou merge sem aprovação humana explícita. |
|
|
158
|
+
| **@mnemosyne** | Banco de Memória do Projeto | Mantém o `.pantheon/memory-bank/` e registra ADRs quando explicitamente solicitado. |
|
|
159
|
+
| **@nyx** | Observabilidade e Telemetria| Rastreamento OpenTelemetry, monitoramento de tokens/custos e profiling de execução. |
|
|
158
160
|
|
|
159
|
-
|
|
160
|
-
confirmada. Consulte a dist-tag `beta` do npm para saber o que está realmente
|
|
161
|
-
publicado. Veja [Compatibilidade](docs/COMPATIBILITY.md) para os hosts
|
|
162
|
-
suportados e as [releases](https://github.com/ils15/pantheon-opencode/releases)
|
|
163
|
-
para as mudanças publicadas mais recentes.
|
|
161
|
+
---
|
|
164
162
|
|
|
165
|
-
##
|
|
163
|
+
## Skills & Ferramental MCP
|
|
166
164
|
|
|
167
|
-
|
|
168
|
-
|
|
165
|
+
- **Busca de Skills In-Process (`pantheon_skill_search`):** Encontra rapidamente skills locais e do ecossistema aberto sem depender de permissões de shell.
|
|
166
|
+
- **25 Skills de Produção:** Inclui `test-slicing`, `fast-path-execution`, `tdd-with-agents`, `instruction-forge` e `incremental-implementation`.
|
|
167
|
+
- **5 Servidores MCP Locais:**
|
|
168
|
+
- `pantheon-memory`: Memória compartilhada com travas atômicas SQLite.
|
|
169
|
+
- `pantheon-persistence`: Persistência de contexto e arquivos de projeto.
|
|
170
|
+
- `pantheon-resources`: Disponibilização de documentação e recursos locais.
|
|
171
|
+
- `pantheon-code-mode`: Execução confinada de scripts Python.
|
|
172
|
+
- `pantheon-vision`: Análise e inspeção visual diagnóstica de imagens.
|
|
173
|
+
- **Roteador Consultivo de Decisões JEV:** Avalia candidatos (`pantheon_jev_decide`), ordena trade-offs e fornece suporte a decisões multi-critério sem modificar permissões.
|
|
169
174
|
|
|
170
|
-
|
|
175
|
+
---
|
|
171
176
|
|
|
172
|
-
|
|
173
|
-
bem-vindos. Leia o [CONTRIBUTING.md](CONTRIBUTING.md) antes de abrir uma issue ou
|
|
174
|
-
pull request. Esse arquivo também define a regra de documentação: um único lar
|
|
175
|
-
por fato, com uma lista curta de fatos que não devem ser duplicados.
|
|
177
|
+
## Configurações & Janela TUI (`/pantheon-settings`)
|
|
176
178
|
|
|
177
|
-
|
|
178
|
-
conforme o risco. `npm test` executa a suíte completa do repositório; veja o
|
|
179
|
-
[CONTRIBUTING.md](CONTRIBUTING.md) para saber quando usá-la.
|
|
179
|
+
Execute `/pantheon-settings` (ou `Pantheon: Settings` na paleta de comandos) para abrir o painel de configurações:
|
|
180
180
|
|
|
181
|
-
|
|
181
|
+
- **Gates & Overrides:** Habilite ou desabilite comportamentos nomeados em tempo real (salvo em `pantheon-overrides.json`).
|
|
182
|
+
- **Presets de Modelos:** Alterne o tier de modelos ativo globalmente ou no projeto.
|
|
183
|
+
- **Modelo de Decisão:** Configure o roteamento local e remoto das decisões JEV.
|
|
184
|
+
- **Atualizações:** Verifique o canal do registro (`beta` / `stable`) e dispare upgrades.
|
|
185
|
+
- **Doctor:** Execute o diagnóstico de saúde do sistema diretamente na interface.
|
|
186
|
+
- **Personalização da TUI:** Ajuste espaçamento (`comfortable` vs `compact`), separadores, estilo das barras de progresso e linhas de contexto.
|
|
182
187
|
|
|
183
|
-
|
|
184
|
-
[DOI de conceito do Zenodo](https://doi.org/10.5281/zenodo.22650136), que sempre
|
|
185
|
-
resolve para a release arquivada mais recente; cada release também tem seu
|
|
186
|
-
próprio DOI de versão. Os metadados de citação estão em
|
|
187
|
-
[CITATION.cff](CITATION.cff).
|
|
188
|
+
---
|
|
188
189
|
|
|
189
|
-
|
|
190
|
+
## Documentação
|
|
191
|
+
|
|
192
|
+
| Comece por aqui | Arquitetura e Aprofundamento | Referência e Operações |
|
|
193
|
+
|---|---|---|
|
|
194
|
+
| [Início Rápido](docs/QUICKSTART.md) | [Arquitetura](docs/ARCHITECTURE.md) | [Ferramentas MCP](docs/mcp-tools.md) |
|
|
195
|
+
| [Guia de Instalação](docs/INSTALLATION.md) | [Delegação & Gates](docs/PERMISSIONS-QUALITY-DELEGATION.md) | [Decisões Nativas (Jev)](docs/reference/native-decisions.md) |
|
|
196
|
+
| [Compatibilidade](docs/COMPATIBILITY.md) | [Sistema de Memória](docs/MEMORY.md) | [Roteamento de Modelos](docs/reference/model-routing.md) |
|
|
197
|
+
| [Atualização](docs/UPGRADING.md) | [Integração OpenCode 2.x](docs/opencode.md) | [Changelog](CHANGELOG.md) |
|
|
190
198
|
|
|
191
199
|
---
|
|
192
200
|
|
|
193
|
-
|
|
201
|
+
## O Que Há de Novo na v2.0.0-rc.1
|
|
202
|
+
|
|
203
|
+
- **Inauguração da Série Release Candidate:** Orquestração multi-agente pronta para produção no OpenCode 2.x.
|
|
204
|
+
- **Compactação de Tokens dos Agentes (-44.3%):** Remoção de código duplicado no Apollo/Prometheus, economizando 8.150 tokens por turno (~29,3M tokens/mês).
|
|
205
|
+
- **Diretiva de Pragmatismo e Anti-Pedantismo:** Diagnósticos seguros autorizados sem burocracia excessiva, eliminando lentidão e morosidade.
|
|
206
|
+
- **TDD em Lote (Batched Suite) e Test-Slicing:** Implementação coesa de módulos completos e execução de testes em menos de 100ms.
|
|
207
|
+
- **Descoberta Proativa de Skills com Cache:** Buscas de skills cacheadas (TTL 24h) e recomendação proativa de ferramentas pelo Zeus.
|
|
208
|
+
- **Scorecard JEV ao Vivo e App Web no Sandbox:** 16/16 cenários aprovados ($0,0000238/decisão) validados com app real no sandbox.
|
|
209
|
+
|
|
210
|
+
Consulte o [CHANGELOG.md](CHANGELOG.md) para o histórico completo de lançamentos.
|
|
211
|
+
|
|
212
|
+
## Contribuição
|
|
213
|
+
|
|
214
|
+
Ideias, relatórios de bugs e contribuições de código são muito bem-vindos! Por favor, leia [CONTRIBUTING.md](CONTRIBUTING.md) antes de abrir um PR.
|
|
215
|
+
|
|
216
|
+
## Citação e Licença
|
|
217
|
+
|
|
218
|
+
O Pantheon é software de código aberto sob a [Licença MIT](LICENSE).
|
|
219
|
+
Cite via Zenodo concept DOI: [10.5281/zenodo.22650136](https://doi.org/10.5281/zenodo.22650136). Metadados de citação disponíveis em [CITATION.cff](CITATION.cff).
|
|
220
|
+
|
|
221
|
+
Repositório canônico: <https://github.com/ils15/pantheon-opencode>
|
package/bin/pantheon-init.mjs
CHANGED
|
@@ -105,7 +105,7 @@ function printUsage() {
|
|
|
105
105
|
console.log(
|
|
106
106
|
' npx pantheon-opencode decision-router select|enable|consent|caps|period # explicit actions',
|
|
107
107
|
)
|
|
108
|
-
console.log(' npx pantheon-opencode update [--stable] [--allow-prerelease]')
|
|
108
|
+
console.log(' npx pantheon-opencode update [--stable] [--allow-prerelease] [--project]')
|
|
109
109
|
console.log(
|
|
110
110
|
' # Update + re-run init. Default channel is beta; a stable install never jumps to a beta without --allow-prerelease.',
|
|
111
111
|
)
|
|
@@ -30,10 +30,15 @@ Phase 1: DISCOVERY
|
|
|
30
30
|
|
|
31
31
|
Phase 2-N: IMPLEMENTATION (parallel per phase)
|
|
32
32
|
└─ @hermes, @aphrodite, @demeter, @hephaestus, @prometheus
|
|
33
|
+
└─ Concurrent Isolation: For 2+ specialists running in parallel, allocate isolated git worktrees via `worktrees` skill:
|
|
34
|
+
`<project-parent>/.pantheon-worktrees/<repo>/deepwork-<slug>-<agent>`
|
|
35
|
+
(prevents file collisions, race conditions, and test runner port conflicts)
|
|
33
36
|
└─ Output: IMPL-phase-<N>-<agent>.md
|
|
34
37
|
|
|
35
38
|
GATE after each phase:
|
|
36
|
-
└─ @themis reviews output
|
|
39
|
+
└─ @themis reviews output:
|
|
40
|
+
• PASS: Merge worktree/branch, update STATUS.md, advance to next phase.
|
|
41
|
+
• FAIL: Halt advancement. Revert broken edits to phase boundary or dispatch targeted fix subtask to responsible specialist. Never advance on FAIL.
|
|
37
42
|
|
|
38
43
|
Phase FINAL: VERIFICATION
|
|
39
44
|
└─ @themis full integration review → REVIEW.md
|
package/commands/pantheon.md
CHANGED
|
@@ -4,12 +4,17 @@ agent: zeus
|
|
|
4
4
|
---
|
|
5
5
|
# /pantheon — Council Synthesis
|
|
6
6
|
|
|
7
|
-
**What:** Dispatches
|
|
8
|
-
**Usage:** `/pantheon <question>`
|
|
9
|
-
**When:** Architecture trade-offs, technology selection, security
|
|
10
|
-
**Returns:** Structured synthesis with recommendation, confidence level,
|
|
7
|
+
**What:** Dispatches an architectural or high-impact question to 2-3 specialist agents **in parallel**, then synthesizes their perspectives into an assertive, actionable decision with resolved divergences.
|
|
8
|
+
**Usage:** `/pantheon <question>` (add `--research` for a 30s Apollo pre-scan)
|
|
9
|
+
**When:** Architecture trade-offs, technology selection, security reviews, multi-stakeholder decisions. (Never for routine fixes or single-file edits — use Fast-Track instead).
|
|
10
|
+
**Returns:** Structured synthesis with decisive recommendation, confidence level, and clear arbitration.
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
### Execution & Arbitration:
|
|
13
|
+
- **Parallel Dispatch:** Dispatches 2-3 specialists in a single turn with independent briefs.
|
|
14
|
+
- **Assertive Arbitration:** Divergences are resolved via **Domain Authority Precedence** (Themis for Security/Auth vetoes, Demeter for DB/Persistence, Aphrodite for UI/A11y, Prometheus for Infra/CI, Hermes for APIs, Athena for Modularity) or **JEV Multi-Criteria Decision** (`pantheon_jev_decide`).
|
|
15
|
+
- **Autonomous & Low-Latency:** Multi-turn debates and rebuttals are avoided unless an unverified factual contradiction exists. Zeus concludes decisively.
|
|
16
|
+
|
|
17
|
+
Dispatch, specialist selection, and synthesis follow the canonical `## Zeus Council Synthesis` protocol. Send ALL specialist calls in a single message; each specialist returns the `## specialist_response` structure from `## Agent Return Format`.
|
|
13
18
|
|
|
14
19
|
## Question:
|
|
15
20
|
$ARGUMENTS
|
package/package.json
CHANGED
package/plugin.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pantheon",
|
|
3
3
|
"publisher": "ils15",
|
|
4
|
-
"version": "2.0.0-
|
|
4
|
+
"version": "2.0.0-rc.1",
|
|
5
5
|
"displayName": "Pantheon",
|
|
6
|
-
"description": "Conductor-Delegate orchestration platform with 14 specialized agents,
|
|
6
|
+
"description": "Conductor-Delegate orchestration platform with 14 specialized agents, 25 skills, and OpenCode support.",
|
|
7
7
|
"agents": "./src/agents",
|
|
8
8
|
"skills": "./src/skills",
|
|
9
9
|
"instructions": "./src/instructions",
|