pantheon-opencode 2.0.0-beta.6 → 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/AGENTS.global.md +7 -2
- package/AGENTS.md +8 -8
- package/CHANGELOG.md +99 -0
- package/README.md +171 -510
- package/README.pt-BR.md +179 -149
- package/bin/pantheon-init.mjs +14 -1
- package/commands/pantheon-audit.md +1 -1
- package/commands/pantheon-deepwork.md +7 -2
- package/commands/pantheon-optimize.md +41 -63
- package/commands/pantheon.md +10 -5
- package/package.json +4 -3
- package/plugin.json +2 -2
- package/prompts/optimize-database.prompt.md +5 -5
- package/prompts/orchestrate-with-zeus.prompt.md +82 -290
- package/prompts/plan-architecture.prompt.md +6 -6
- package/prompts/subtask.prompt.md +1 -1
- package/pyproject.toml +1 -1
- package/scripts/build-agents-md.mjs +10 -10
- package/scripts/build-plugin.mjs +26 -0
- package/scripts/doctor.mjs +27 -11
- package/scripts/hooks/format-multi-language.sh +30 -48
- package/scripts/install/opencode-version.mjs +17 -5
- package/scripts/install/opencode.mjs +8 -1
- package/scripts/jev-live-probe.mjs +1 -1
- package/scripts/optimize.mjs +322 -0
- package/scripts/prune.mjs +105 -14
- package/scripts/release-gates.mjs +19 -5
- package/scripts/skill-search.mjs +27 -3
- package/scripts/test-opencode-sandbox.sh +44 -15
- package/scripts/update.mjs +29 -17
- package/skills-lock.json +15 -13
- package/src/agents/aphrodite.md +17 -14
- package/src/agents/apollo.md +10 -207
- package/src/agents/athena.md +30 -34
- package/src/agents/demeter.md +2 -0
- package/src/agents/hephaestus.md +1 -0
- package/src/agents/hermes.md +21 -95
- package/src/agents/iris.md +3 -0
- package/src/agents/mnemosyne.md +1 -1
- package/src/agents/nyx.md +2 -1
- package/src/agents/prometheus.md +2 -203
- package/src/agents/talos.md +5 -0
- package/src/agents/themis.md +93 -84
- package/src/agents/zeus.md +44 -263
- package/src/instructions/agent-return-format.instructions.md +1 -1
- package/src/instructions/memory-protocol.instructions.md +5 -1
- package/src/instructions/test-economy.instructions.md +1 -0
- package/src/instructions/zeus-anti-stall.instructions.md +3 -3
- package/src/instructions/zeus-communication-rules.instructions.md +1 -1
- package/src/instructions/zeus-council-synthesis.instructions.md +15 -3
- package/src/instructions/zeus-timeout-retry.instructions.md +10 -10
- package/src/pantheon/model-command.ts +12 -12
- package/src/pantheon/pantheon-decision-catalog.ts +8 -0
- package/src/pantheon/skill-search-tool.ts +193 -0
- package/src/pantheon/tools.ts +6 -0
- package/src/pantheon/tui-version-check.ts +1 -1
- package/src/pantheon/update-notifier.ts +13 -8
- package/src/pantheon/vision.ts +20 -20
- package/src/plugin/index.js +14594 -0
- package/src/plugins/tui/dist/tui.d.ts +15 -5
- package/src/plugins/tui/dist/tui.d.ts.map +1 -1
- package/src/plugins/tui/dist/tui.js +1761 -556
- 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 +28 -16
- package/src/plugins/tui/src/context-gauge.ts +64 -5
- package/src/plugins/tui/src/decision-router-state.ts +49 -2
- package/src/plugins/tui/src/index.tsx +69 -26
- package/src/plugins/tui/src/pantheon-settings-state.ts +99 -0
- package/src/plugins/tui/src/pantheon-settings.tsx +771 -125
- package/src/plugins/tui/src/tui-prefs.ts +266 -12
- package/src/plugins/tui/src/update-notice.ts +9 -6
- package/src/plugins/tui/src/update-status.ts +27 -8
- package/src/plugins/tui/src/whats-new-open.ts +4 -4
- package/src/plugins/tui/src/whats-new.tsx +119 -17
- package/src/routing.yml +9 -0
- package/src/skills/README.md +35 -25
- package/src/skills/agent-coordination/SKILL.md +6 -6
- package/src/skills/artifact-management/SKILL.md +43 -39
- package/src/skills/artifact-management/references/artifact-templates.md +103 -48
- package/src/skills/auto-continue/references/auto-continue-details.md +13 -13
- package/src/skills/code-review-checklist/SKILL.md +6 -6
- package/src/skills/fast-path-execution/SKILL.md +54 -0
- package/src/skills/incremental-implementation/SKILL.md +13 -13
- package/src/skills/memory-bank/references/anti-patterns.md +3 -3
- package/src/skills/prompt-refinery/SKILL.md +51 -65
- package/src/skills/spec-driven-development/SKILL.md +12 -14
- package/src/skills/tdd-with-agents/SKILL.md +23 -10
- package/src/skills/test-slicing/SKILL.md +56 -0
- package/src/skills/verification-planning/SKILL.md +4 -3
- package/src/skills/visual-review-pipeline/SKILL.md +1 -1
- package/src/skills/visual-review-pipeline/references/workflow-steps.md +1 -1
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,211 @@ 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.
|
|
187
|
+
- **Overlay Não-Destrutivo e Navegação por Clique:** Abre como diálogo flutuante sobre a sessão ativa mantendo a TUI visível (configurável entre `dialog` e `fullscreen`), com suporte completo a cliques de mouse em abas, menu lateral, linhas, seletores e botões de ação.
|
|
188
|
+
- **Janela de Novidades Modernizada:** Layout em card com bordas arredondadas, paginação visual e botão dedicado `[OK, Entendido]` com confirmação via mouse ou teclado (`Enter`/`Esc`/`Q`).
|
|
182
189
|
|
|
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).
|
|
190
|
+
---
|
|
188
191
|
|
|
189
|
-
|
|
192
|
+
## Documentação
|
|
193
|
+
|
|
194
|
+
| Comece por aqui | Arquitetura e Aprofundamento | Referência e Operações |
|
|
195
|
+
|---|---|---|
|
|
196
|
+
| [Início Rápido](docs/QUICKSTART.md) | [Arquitetura](docs/ARCHITECTURE.md) | [Ferramentas MCP](docs/mcp-tools.md) |
|
|
197
|
+
| [Guia de Instalação](docs/INSTALLATION.md) | [Delegação & Gates](docs/PERMISSIONS-QUALITY-DELEGATION.md) | [Decisões Nativas (Jev)](docs/reference/native-decisions.md) |
|
|
198
|
+
| [Compatibilidade](docs/COMPATIBILITY.md) | [Sistema de Memória](docs/MEMORY.md) | [Roteamento de Modelos](docs/reference/model-routing.md) |
|
|
199
|
+
| [Atualização](docs/UPGRADING.md) | [Integração OpenCode 2.x](docs/opencode.md) | [Changelog](CHANGELOG.md) |
|
|
190
200
|
|
|
191
201
|
---
|
|
192
202
|
|
|
193
|
-
|
|
203
|
+
## O Que Há de Novo na v2.0.0-rc.1
|
|
204
|
+
|
|
205
|
+
- **Inauguração da Série Release Candidate:** Orquestração multi-agente pronta para produção no OpenCode 2.x.
|
|
206
|
+
- **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).
|
|
207
|
+
- **Diretiva de Pragmatismo e Anti-Pedantismo:** Diagnósticos seguros autorizados sem burocracia excessiva, eliminando lentidão e morosidade.
|
|
208
|
+
- **TDD em Lote (Batched Suite) e Test-Slicing:** Implementação coesa de módulos completos e execução de testes em menos de 100ms.
|
|
209
|
+
- **Descoberta Proativa de Skills com Cache:** Buscas de skills cacheadas (TTL 24h) e recomendação proativa de ferramentas pelo Zeus.
|
|
210
|
+
- **Scorecard JEV ao Vivo e App Web no Sandbox:** 16/16 cenários aprovados ($0,0000238/decisão) validados com app real no sandbox.
|
|
211
|
+
|
|
212
|
+
Consulte o [CHANGELOG.md](CHANGELOG.md) para o histórico completo de lançamentos.
|
|
213
|
+
|
|
214
|
+
## Contribuição
|
|
215
|
+
|
|
216
|
+
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.
|
|
217
|
+
|
|
218
|
+
## Citação e Licença
|
|
219
|
+
|
|
220
|
+
O Pantheon é software de código aberto sob a [Licença MIT](LICENSE).
|
|
221
|
+
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).
|
|
222
|
+
|
|
223
|
+
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
|
)
|
|
@@ -114,6 +114,9 @@ function printUsage() {
|
|
|
114
114
|
)
|
|
115
115
|
console.log(' npx pantheon-opencode prune # List legacy artifacts (dry-run)')
|
|
116
116
|
console.log(' npx pantheon-opencode prune --apply # Remove stale backups')
|
|
117
|
+
console.log(
|
|
118
|
+
' npx pantheon-opencode optimize [--apply] # Archive completed deepwork & clean logs',
|
|
119
|
+
)
|
|
117
120
|
console.log(' npx pantheon-opencode doctor [--profile] # Run health check')
|
|
118
121
|
console.log(
|
|
119
122
|
' npx pantheon-opencode restore [--project] [--yes] # Restore an exact installer backup',
|
|
@@ -170,6 +173,16 @@ async function main() {
|
|
|
170
173
|
process.exit(result.status ?? 1)
|
|
171
174
|
}
|
|
172
175
|
|
|
176
|
+
if (command === 'optimize') {
|
|
177
|
+
const { spawnSync } = await import('node:child_process')
|
|
178
|
+
const optimizeScript = path.join(ROOT, 'scripts', 'optimize.mjs')
|
|
179
|
+
const result = spawnSync(process.execPath, [optimizeScript, ...args.slice(1)], {
|
|
180
|
+
stdio: 'inherit',
|
|
181
|
+
cwd: process.cwd(),
|
|
182
|
+
})
|
|
183
|
+
process.exit(result.status ?? 1)
|
|
184
|
+
}
|
|
185
|
+
|
|
173
186
|
if (command === 'uninstall') {
|
|
174
187
|
const { spawnSync } = await import('node:child_process')
|
|
175
188
|
const uninstallScript = path.join(ROOT, 'scripts', 'uninstall.mjs')
|
|
@@ -28,4 +28,4 @@ Zero tokens, <2s. Checks: ruff, biome, anti-pattern slop, anti-overengineering (
|
|
|
28
28
|
~500 tokens. Confidence scoring, regression prediction, OWASP Top 10.
|
|
29
29
|
|
|
30
30
|
### Layer 3 — Verification Planning
|
|
31
|
-
For N>5 file changes.
|
|
31
|
+
For N>5 file changes. Proposes a verification plan before implementing.
|
|
@@ -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
|
|
@@ -51,7 +56,7 @@ Usage: --resume <slug> | --status <slug> | --list
|
|
|
51
56
|
|
|
52
57
|
## Full-Auto Mode (`--full-auto`)
|
|
53
58
|
|
|
54
|
-
>
|
|
59
|
+
> [!WARNING] Automates only eligible review gates. Gate 1 and commit/deploy gates still require approval.
|
|
55
60
|
|
|
56
61
|
`--full-auto` does not hide the plan or skip Gate 1: Zeus still displays the
|
|
57
62
|
complete plan in the main conversation and waits for explicit approval before
|
|
@@ -1,79 +1,57 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "Scan, clean, cache, and archive Pantheon project files. Scans for bloat, archives completed deepwork,
|
|
2
|
+
description: "Scan, clean, cache, and archive Pantheon project files. Scans for bloat, archives completed deepwork, and cleans workspace artifacts. Usage: /pantheon-optimize"
|
|
3
3
|
agent: "zeus"
|
|
4
4
|
---
|
|
5
5
|
# /pantheon-optimize — Pantheon Project Optimizer
|
|
6
6
|
|
|
7
|
-
**What:** Multi-mode optimization:
|
|
7
|
+
**What:** Multi-mode workspace optimization: archives or cleans completed deepwork sessions from `.pantheon/deepwork/`, prunes stale backups and logs, and reports optimization opportunities.
|
|
8
8
|
|
|
9
|
-
## Usage
|
|
9
|
+
## CLI Usage (Deterministic, Zero-Token)
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
/pantheon-optimize → Full scan + compress (default)
|
|
13
|
-
/pantheon-optimize --dry-run → Preview only, no changes
|
|
14
|
-
/pantheon-optimize --archive → Archive completed deepwork sessions
|
|
15
|
-
/pantheon-optimize --cache → Migrate memory-bank to MCP memory
|
|
16
|
-
/pantheon-optimize --path=<dir> → Limit scan to directory
|
|
17
|
-
/pantheon-optimize --all → Run all modes (default)
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
## Modes
|
|
21
|
-
|
|
22
|
-
### `--archive` — Deepwork Archiving
|
|
23
|
-
Archives completed deepwork sessions from `.pantheon/deepwork/<slug>/` to `.pantheon/deepwork/archive/<slug>/`.
|
|
24
|
-
|
|
25
|
-
**Criteria:** A session is "completed" if it has a `REVIEW.md` containing "APPROVED".
|
|
11
|
+
You can run the optimizer directly from the terminal without AI token spend:
|
|
26
12
|
|
|
13
|
+
```bash
|
|
14
|
+
pantheon-opencode optimize # Dry-run inspection (default)
|
|
15
|
+
pantheon-opencode optimize --apply # Archive completed deepworks and clean old logs
|
|
16
|
+
pantheon-opencode optimize --clean --apply # Permanently remove resolved deepworks
|
|
17
|
+
pantheon-opencode optimize --age 5 # Set inactivity threshold (days)
|
|
27
18
|
```
|
|
28
|
-
/pantheon-optimize archive → Interactive (ask per slug)
|
|
29
|
-
/pantheon-optimize archive --dry-run → Preview only
|
|
30
|
-
/pantheon-optimize archive --auto → Archive all completed
|
|
31
|
-
/pantheon-optimize archive --auto --keep=2 → Keep only PLAN.md + REVIEW.md
|
|
32
|
-
/pantheon-optimize archive --auto --compress → Single .md per slug
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
### `--cache` — Memory Bank Migration
|
|
36
|
-
Scans `.pantheon/memory-bank/` for flat `.md` files and migrates them to the FTS5-backed MCP memory server.
|
|
37
19
|
|
|
38
|
-
|
|
39
|
-
1. Reads all `.md` files in `.pantheon/memory-bank/`
|
|
40
|
-
2. Chunks by heading (## sections)
|
|
41
|
-
3. Calls `memory_store()` for each chunk with appropriate namespace
|
|
42
|
-
4. Optionally archives the original files after successful migration
|
|
20
|
+
## Slash Command Usage
|
|
43
21
|
|
|
44
22
|
```
|
|
45
|
-
/pantheon-optimize
|
|
46
|
-
/pantheon-optimize
|
|
47
|
-
/pantheon-optimize
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
### `--dry-run` (global flag)
|
|
51
|
-
Prevents any destructive action. Shows what WOULD be done.
|
|
52
|
-
|
|
53
|
-
### Default mode (no flags)
|
|
54
|
-
Runs bloat scan on all `.md` and `.json` files + compression report.
|
|
55
|
-
|
|
56
|
-
## Output
|
|
57
|
-
|
|
23
|
+
/pantheon-optimize → Full inspection (preview only)
|
|
24
|
+
/pantheon-optimize --archive → Archive completed deepwork sessions
|
|
25
|
+
/pantheon-optimize --clean → Delete completed deepwork sessions
|
|
58
26
|
```
|
|
59
|
-
🧹 Pantheon Optimize Report
|
|
60
|
-
|
|
61
|
-
📦 Bloat Scan: 47 .md + 12 .json files
|
|
62
|
-
→ 3 oversized files found
|
|
63
|
-
→ ~2.4K tokens recoverable
|
|
64
27
|
|
|
65
|
-
|
|
66
|
-
→ 12 completed (REVIEW.md APPROVED)
|
|
67
|
-
→ 3 in progress (skipped)
|
|
68
|
-
→ Run with --archive --auto to archive 12 sessions
|
|
69
|
-
|
|
70
|
-
🗄️ Memory Cache: 24 files in memory-bank/
|
|
71
|
-
→ 18 already in MCP memory (dedup)
|
|
72
|
-
→ 6 candidates for migration (~3.2K tokens)
|
|
73
|
-
→ Run with --cache to migrate
|
|
28
|
+
## Modes
|
|
74
29
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
30
|
+
### Deepwork Optimization
|
|
31
|
+
Completed or inactive deepwork sessions in `.pantheon/deepwork/<slug>/` are identified by:
|
|
32
|
+
1. `REVIEW.md` containing "APPROVED" or "PASS".
|
|
33
|
+
2. `STATUS.md` marked "complete".
|
|
34
|
+
3. Inactivity exceeding the age threshold (default: 7 days).
|
|
35
|
+
|
|
36
|
+
### Output
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
Pantheon Optimizer — Workspace Inspection
|
|
40
|
+
Target: /path/to/project
|
|
41
|
+
Mode: dry-run (preview only)
|
|
42
|
+
────────────────────────────────────────────────────────────
|
|
43
|
+
Deepwork sessions: 5 total
|
|
44
|
+
Resolvable candidates (4):
|
|
45
|
+
- beta10-jev-uplift (inactive for >7 days)
|
|
46
|
+
- decision-layer-v2 (inactive for >7 days)
|
|
47
|
+
- opencode-v2-dual-migration (inactive for >7 days)
|
|
48
|
+
- v2-cycle (inactive for >7 days)
|
|
49
|
+
Active sessions kept (1):
|
|
50
|
+
- 2.0-jev-uplift (in-progress)
|
|
51
|
+
Stale backups: 0 candidates (>14 days, keeping 3 latest)
|
|
52
|
+
Stale logs: 0 candidates (>7 days)
|
|
53
|
+
────────────────────────────────────────────────────────────
|
|
54
|
+
[DRY-RUN] No changes made.
|
|
55
|
+
To archive resolved deepworks: pantheon-opencode optimize --apply
|
|
56
|
+
To permanently delete resolved deepworks: pantheon-opencode optimize --clean --apply
|
|
79
57
|
```
|
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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pantheon-opencode",
|
|
3
|
-
"version": "2.0.0
|
|
3
|
+
"version": "2.0.0",
|
|
4
4
|
"description": "Multi-agent orchestration for OpenCode \u2014 14 specialized agents, TDD, Themis review gates.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"workspaces": [
|
|
@@ -20,6 +20,7 @@
|
|
|
20
20
|
"setup": "node scripts/setup.mjs",
|
|
21
21
|
"build:agents-md": "node scripts/build-agents-md.mjs",
|
|
22
22
|
"build:decision-router": "node scripts/build-decision-router.mjs",
|
|
23
|
+
"build:plugin": "node scripts/build-plugin.mjs",
|
|
23
24
|
"check:decision-router": "node scripts/build-decision-router.mjs --check",
|
|
24
25
|
"skills:lock": "node scripts/update-skills-lock.mjs",
|
|
25
26
|
"setup:lite": "node bin/pantheon-init.mjs init --yes --clean --components agents,skills,instructions",
|
|
@@ -28,8 +29,8 @@
|
|
|
28
29
|
"init": "node bin/pantheon-init.mjs init --yes",
|
|
29
30
|
"opencode": "OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true opencode",
|
|
30
31
|
"start": "OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true opencode",
|
|
31
|
-
"prepack": "npm run check:decision-router",
|
|
32
|
-
"prepublishOnly": "node scripts/validate-routing.mjs && npm run check:decision-router",
|
|
32
|
+
"prepack": "npm run build:plugin && npm run check:decision-router",
|
|
33
|
+
"prepublishOnly": "node scripts/validate-routing.mjs && npm run build:plugin && npm run check:decision-router",
|
|
33
34
|
"postpublish": "node -e \"console.log('\u2705 Published pantheon-opencode v' + require('./package.json').version + ' to npm')\"",
|
|
34
35
|
"version:status": "node scripts/versioning.mjs status",
|
|
35
36
|
"version:apply": "node scripts/versioning.mjs apply",
|
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",
|
|
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",
|