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
|
@@ -32,39 +32,126 @@
|
|
|
32
32
|
* does not show (fail-open, like the rest of the plugin).
|
|
33
33
|
*/
|
|
34
34
|
import type { Context } from '@opencode/plugin/tui/context'
|
|
35
|
-
import { createSignal, For } from 'solid-js'
|
|
35
|
+
import { createSignal, For, Show } from 'solid-js'
|
|
36
36
|
import { readChangelogForBundle, resolveRunningVersion } from './whats-new-highlights.ts'
|
|
37
37
|
import { openWhatsNew, type WhatsNewViewData, wrapWhatsNewLine } from './whats-new-open.ts'
|
|
38
38
|
import { defaultWhatsNewStatePath } from './whats-new-state.ts'
|
|
39
39
|
|
|
40
|
-
/** Window body: title, rule, the current page (wrapped), footer
|
|
40
|
+
/** Window body: title, rule, the current page (wrapped), footer action bar with OK button. */
|
|
41
41
|
export function WhatsNewContent(props: {
|
|
42
42
|
data: WhatsNewViewData
|
|
43
43
|
page: () => number
|
|
44
44
|
pageCount: () => number
|
|
45
45
|
fg?: any
|
|
46
46
|
muted?: any
|
|
47
|
+
warn?: any
|
|
48
|
+
onClose?: () => void
|
|
49
|
+
onNext?: () => void
|
|
50
|
+
onPrev?: () => void
|
|
47
51
|
}) {
|
|
48
52
|
const rows = () => {
|
|
49
53
|
const current = props.data.pages[Math.min(props.page(), props.pageCount() - 1)] ?? []
|
|
50
54
|
const wrapped: string[] = []
|
|
51
|
-
for (const line of current) wrapped.push(...wrapWhatsNewLine(line,
|
|
55
|
+
for (const line of current) wrapped.push(...wrapWhatsNewLine(line, 72))
|
|
52
56
|
return wrapped
|
|
53
57
|
}
|
|
54
58
|
return (
|
|
55
|
-
<box
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
59
|
+
<box
|
|
60
|
+
flexDirection="column"
|
|
61
|
+
borderStyle="rounded"
|
|
62
|
+
borderColor={props.warn ?? '#fba970'}
|
|
63
|
+
paddingLeft={2}
|
|
64
|
+
paddingRight={2}
|
|
65
|
+
paddingTop={1}
|
|
66
|
+
paddingBottom={1}
|
|
67
|
+
>
|
|
68
|
+
{/* Header with Title and close hint */}
|
|
69
|
+
<box flexDirection="row" alignItems="center" justifyContent="space-between">
|
|
70
|
+
<box flexDirection="row" alignItems="center">
|
|
71
|
+
<box
|
|
72
|
+
backgroundColor={props.warn ?? '#fba970'}
|
|
73
|
+
paddingLeft={1}
|
|
74
|
+
paddingRight={1}
|
|
75
|
+
marginRight={1}
|
|
76
|
+
>
|
|
77
|
+
<text fg="#000000" attributes={1}>
|
|
78
|
+
{'NOVIDADES'}
|
|
79
|
+
</text>
|
|
80
|
+
</box>
|
|
81
|
+
<text attributes={1} fg={props.fg}>
|
|
82
|
+
{props.data.title}
|
|
83
|
+
</text>
|
|
84
|
+
</box>
|
|
85
|
+
<box onMouseDown={() => props.onClose?.()}>
|
|
86
|
+
<text fg={props.muted}>{'[ Esc / Q ]'}</text>
|
|
87
|
+
</box>
|
|
88
|
+
</box>
|
|
89
|
+
|
|
90
|
+
{/* Divider */}
|
|
91
|
+
<box flexDirection="row" height={1} marginTop={1} marginBottom={1}>
|
|
92
|
+
<text fg={props.muted}>{'─'.repeat(72)}</text>
|
|
93
|
+
</box>
|
|
94
|
+
|
|
95
|
+
{/* Content items */}
|
|
96
|
+
<box flexDirection="column" minHeight={8}>
|
|
97
|
+
<For each={rows()}>
|
|
98
|
+
{(line: string) => {
|
|
99
|
+
const isBullet = line.startsWith('• ')
|
|
100
|
+
return (
|
|
101
|
+
<text fg={isBullet ? props.fg : props.muted} {...(isBullet ? { attributes: 1 } : {})}>
|
|
102
|
+
{line}
|
|
103
|
+
</text>
|
|
104
|
+
)
|
|
105
|
+
}}
|
|
106
|
+
</For>
|
|
107
|
+
</box>
|
|
108
|
+
|
|
109
|
+
{/* Divider before footer */}
|
|
110
|
+
<box flexDirection="row" height={1} marginTop={1}>
|
|
111
|
+
<text fg={props.muted}>{'─'.repeat(72)}</text>
|
|
112
|
+
</box>
|
|
113
|
+
|
|
114
|
+
{/* Bottom Action Bar: Pagination + Modern OK Button */}
|
|
115
|
+
<box flexDirection="row" alignItems="center" justifyContent="space-between" marginTop={1}>
|
|
116
|
+
<box flexDirection="row" alignItems="center">
|
|
117
|
+
<Show when={props.pageCount() > 1}>
|
|
118
|
+
<box
|
|
119
|
+
backgroundColor="#262626"
|
|
120
|
+
paddingLeft={1}
|
|
121
|
+
paddingRight={1}
|
|
122
|
+
marginRight={1}
|
|
123
|
+
onMouseDown={() => props.onPrev?.()}
|
|
124
|
+
>
|
|
125
|
+
<text fg="#ffffff">{'‹ Prev'}</text>
|
|
126
|
+
</box>
|
|
127
|
+
<text fg={props.muted} marginRight={1}>
|
|
128
|
+
{`${props.page() + 1} / ${props.pageCount()}`}
|
|
129
|
+
</text>
|
|
130
|
+
<box
|
|
131
|
+
backgroundColor="#262626"
|
|
132
|
+
paddingLeft={1}
|
|
133
|
+
paddingRight={1}
|
|
134
|
+
marginRight={1}
|
|
135
|
+
onMouseDown={() => props.onNext?.()}
|
|
136
|
+
>
|
|
137
|
+
<text fg="#ffffff">{'Next ›'}</text>
|
|
138
|
+
</box>
|
|
139
|
+
</Show>
|
|
140
|
+
<text fg={props.muted}>{'Enter / Esc / Q close'}</text>
|
|
141
|
+
</box>
|
|
142
|
+
|
|
143
|
+
{/* Prominent OK Button */}
|
|
144
|
+
<box
|
|
145
|
+
backgroundColor={props.warn ?? '#fba970'}
|
|
146
|
+
paddingLeft={2}
|
|
147
|
+
paddingRight={2}
|
|
148
|
+
onMouseDown={() => props.onClose?.()}
|
|
149
|
+
>
|
|
150
|
+
<text fg="#000000" attributes={1}>
|
|
151
|
+
{'OK, Got it'}
|
|
152
|
+
</text>
|
|
153
|
+
</box>
|
|
154
|
+
</box>
|
|
68
155
|
</box>
|
|
69
156
|
)
|
|
70
157
|
}
|
|
@@ -91,9 +178,19 @@ export async function maybeShowWhatsNewV2(context: Context): Promise<void> {
|
|
|
91
178
|
mode: 'global',
|
|
92
179
|
enabled: () => open(),
|
|
93
180
|
commands: [
|
|
181
|
+
{
|
|
182
|
+
id: 'pantheon.whats-new.confirm',
|
|
183
|
+
title: 'Confirm and close what is new',
|
|
184
|
+
bind: 'enter,space',
|
|
185
|
+
run: () => {
|
|
186
|
+
if (!open()) return false
|
|
187
|
+
dismiss()
|
|
188
|
+
return undefined
|
|
189
|
+
},
|
|
190
|
+
},
|
|
94
191
|
{
|
|
95
192
|
id: 'pantheon.whats-new.close',
|
|
96
|
-
title: '
|
|
193
|
+
title: 'Close what is new',
|
|
97
194
|
bind: 'escape,q',
|
|
98
195
|
run: () => {
|
|
99
196
|
if (!open()) return false
|
|
@@ -149,6 +246,7 @@ export async function maybeShowWhatsNewV2(context: Context): Promise<void> {
|
|
|
149
246
|
setOpen(true)
|
|
150
247
|
try {
|
|
151
248
|
const theme = context.theme?.text ?? {}
|
|
249
|
+
const warn = (theme?.feedback as any)?.warning?.base ?? '#fba970'
|
|
152
250
|
context.ui.dialog.show(
|
|
153
251
|
() => (
|
|
154
252
|
<WhatsNewContent
|
|
@@ -157,6 +255,10 @@ export async function maybeShowWhatsNewV2(context: Context): Promise<void> {
|
|
|
157
255
|
pageCount={pageCount}
|
|
158
256
|
fg={theme.base}
|
|
159
257
|
muted={theme.muted}
|
|
258
|
+
warn={warn}
|
|
259
|
+
onClose={dismiss}
|
|
260
|
+
onNext={() => setPage((current) => Math.min(current + 1, pageCount() - 1))}
|
|
261
|
+
onPrev={() => setPage((current) => Math.max(current - 1, 0))}
|
|
160
262
|
/>
|
|
161
263
|
),
|
|
162
264
|
close,
|
package/src/routing.yml
CHANGED
|
@@ -181,11 +181,13 @@ agents:
|
|
|
181
181
|
- prompt-refinery
|
|
182
182
|
- instruction-forge
|
|
183
183
|
- context-compression
|
|
184
|
+
- fast-path-execution
|
|
184
185
|
- incremental-implementation
|
|
185
186
|
- loop-engineering
|
|
186
187
|
- reflect
|
|
187
188
|
- session-goal
|
|
188
189
|
- simplify
|
|
190
|
+
- test-slicing
|
|
189
191
|
- verification-planning
|
|
190
192
|
- worktrees
|
|
191
193
|
athena:
|
|
@@ -252,12 +254,14 @@ agents:
|
|
|
252
254
|
- pantheon_code_mode
|
|
253
255
|
skills:
|
|
254
256
|
- clonedeps
|
|
257
|
+
- fast-path-execution
|
|
255
258
|
- git-workflow-and-versioning
|
|
256
259
|
- incremental-implementation
|
|
257
260
|
- loop-engineering
|
|
258
261
|
- reflect
|
|
259
262
|
- simplify
|
|
260
263
|
- tdd-with-agents
|
|
264
|
+
- test-slicing
|
|
261
265
|
- worktrees
|
|
262
266
|
aphrodite:
|
|
263
267
|
role: Frontend specialist
|
|
@@ -276,11 +280,13 @@ agents:
|
|
|
276
280
|
- pantheon_resources_memory_bank
|
|
277
281
|
- pantheon_code_mode
|
|
278
282
|
skills:
|
|
283
|
+
- fast-path-execution
|
|
279
284
|
- incremental-implementation
|
|
280
285
|
- loop-engineering
|
|
281
286
|
- reflect
|
|
282
287
|
- simplify
|
|
283
288
|
- tdd-with-agents
|
|
289
|
+
- test-slicing
|
|
284
290
|
- visual-review-pipeline
|
|
285
291
|
- worktrees
|
|
286
292
|
demeter:
|
|
@@ -329,6 +335,7 @@ agents:
|
|
|
329
335
|
- security-hardening
|
|
330
336
|
- simplify
|
|
331
337
|
- tdd-with-agents
|
|
338
|
+
- test-slicing
|
|
332
339
|
- worktrees
|
|
333
340
|
prometheus:
|
|
334
341
|
role: Infrastructure specialist
|
|
@@ -478,10 +485,12 @@ agents:
|
|
|
478
485
|
- pantheon_code_mode
|
|
479
486
|
subagent_can_delegate_to: []
|
|
480
487
|
skills:
|
|
488
|
+
- fast-path-execution
|
|
481
489
|
- incremental-implementation
|
|
482
490
|
- loop-engineering
|
|
483
491
|
- reflect
|
|
484
492
|
- simplify
|
|
493
|
+
- test-slicing
|
|
485
494
|
- worktrees
|
|
486
495
|
auto_continue:
|
|
487
496
|
checkpoint_script: .pantheon/code-mode/checkpoint-session.sh
|
package/src/skills/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
Skills are reference modules loaded on demand by agents. Each skill provides domain-specific knowledge — architecture patterns, security checklists, optimization strategies, and implementation guides. Agents load skills when their task matches the skill's description, keeping context focused and token-efficient.
|
|
6
6
|
|
|
7
|
-
There are **
|
|
7
|
+
There are **25 skills** divided into **6 domains**.
|
|
8
8
|
|
|
9
9
|
## Skills by Domain
|
|
10
10
|
|
|
@@ -14,7 +14,11 @@ There are **23 skills** divided into **6 domains**.
|
|
|
14
14
|
- Multi-agent orchestration with model routing, category delegation, and sprint management.
|
|
15
15
|
- Used by: Zeus
|
|
16
16
|
|
|
17
|
-
2. **
|
|
17
|
+
2. **fast-path-execution** — `fast-path-execution/SKILL.md`
|
|
18
|
+
- Fast-track execution protocol for bounded micro-edits (<= 2 files). Zero council overhead, direct specialist dispatch, inline verification.
|
|
19
|
+
- Used by: Zeus, Talos, Hermes, Aphrodite
|
|
20
|
+
|
|
21
|
+
3. **artifact-management** — `artifact-management/SKILL.md`
|
|
18
22
|
- Structured artifact trail for feature implementations — plans, implementations, reviews, and decisions.
|
|
19
23
|
- Used by: Zeus, Mnemosyne, Iris
|
|
20
24
|
|
|
@@ -74,10 +78,14 @@ There are **23 skills** divided into **6 domains**.
|
|
|
74
78
|
- Security gate — OWASP, SAST, secrets detection, MCP hardening, dependency audit.
|
|
75
79
|
- Used by: Themis, Nyx
|
|
76
80
|
|
|
77
|
-
|
|
81
|
+
17. **tdd-with-agents** — `tdd-with-agents/SKILL.md`
|
|
78
82
|
- TDD enforcement with RED→GREEN→REFACTOR cycle and advanced testing patterns across all layers.
|
|
79
83
|
- Used by: Hermes, Aphrodite, Demeter, Themis, Hephaestus
|
|
80
84
|
|
|
85
|
+
18. **test-slicing** — `test-slicing/SKILL.md`
|
|
86
|
+
- Targeted test execution — map changed files directly to their narrow test slice instead of running full suites.
|
|
87
|
+
- Used by: Talos, Themis, Hermes, Aphrodite, Zeus
|
|
88
|
+
|
|
81
89
|
### Domain 4: Planning
|
|
82
90
|
|
|
83
91
|
17. **codemap** — `codemap/SKILL.md`
|
|
@@ -138,28 +146,30 @@ agent grants, and skill inventory.
|
|
|
138
146
|
| # | Skill Name | Domain | Used By |
|
|
139
147
|
|---|------------|--------|---------|
|
|
140
148
|
| 1 | agent-coordination | Orchestration & Workflow | Zeus |
|
|
141
|
-
| 2 |
|
|
142
|
-
| 3 |
|
|
143
|
-
| 4 |
|
|
144
|
-
| 5 |
|
|
145
|
-
| 6 |
|
|
146
|
-
| 7 |
|
|
147
|
-
| 8 |
|
|
148
|
-
| 9 |
|
|
149
|
-
| 10 |
|
|
150
|
-
| 11 |
|
|
151
|
-
| 12 |
|
|
152
|
-
| 13 |
|
|
153
|
-
| 14 |
|
|
154
|
-
| 15 |
|
|
155
|
-
| 16 |
|
|
156
|
-
| 17 |
|
|
157
|
-
| 18 |
|
|
158
|
-
| 19 |
|
|
159
|
-
| 20 |
|
|
160
|
-
| 21 |
|
|
161
|
-
| 22 |
|
|
162
|
-
| 23 |
|
|
149
|
+
| 2 | fast-path-execution | Orchestration & Workflow | Zeus, Talos, Hermes, Aphrodite |
|
|
150
|
+
| 3 | artifact-management | Orchestration & Workflow | Zeus, Mnemosyne, Iris |
|
|
151
|
+
| 4 | auto-continue | Orchestration & Workflow | Zeus, Apollo, Hephaestus, Nyx, Gaia |
|
|
152
|
+
| 5 | context-compression | Orchestration & Workflow | Zeus, Mnemosyne |
|
|
153
|
+
| 6 | memory-bank | Orchestration & Workflow | Mnemosyne, Athena |
|
|
154
|
+
| 7 | session-goal | Orchestration & Workflow | Zeus, Mnemosyne |
|
|
155
|
+
| 8 | clonedeps | Development Tools | Hermes, Hephaestus |
|
|
156
|
+
| 9 | git-workflow-and-versioning | Development Tools | Hermes, Prometheus, Iris |
|
|
157
|
+
| 10 | incremental-implementation | Development Tools | Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos |
|
|
158
|
+
| 11 | loop-engineering | Development Tools | All agents |
|
|
159
|
+
| 12 | reflect | Development Tools | All agents |
|
|
160
|
+
| 13 | simplify | Development Tools | All agents |
|
|
161
|
+
| 14 | worktrees | Development Tools | All agents |
|
|
162
|
+
| 15 | code-review-checklist | Quality & Security | Themis |
|
|
163
|
+
| 16 | security-hardening | Quality & Security | Themis, Nyx |
|
|
164
|
+
| 17 | tdd-with-agents | Quality & Security | Hermes, Aphrodite, Demeter, Themis, Hephaestus |
|
|
165
|
+
| 18 | test-slicing | Quality & Security | Talos, Themis, Hermes, Aphrodite, Zeus |
|
|
166
|
+
| 19 | codemap | Planning | Apollo, Zeus |
|
|
167
|
+
| 20 | spec-driven-development | Planning | Athena |
|
|
168
|
+
| 21 | verification-planning | Planning | Athena, Zeus |
|
|
169
|
+
| 22 | visual-review-pipeline | Frontend Development | Aphrodite |
|
|
170
|
+
| 23 | agent-forge | Meta | Zeus |
|
|
171
|
+
| 24 | prompt-refinery | Meta | Zeus |
|
|
172
|
+
| 25 | instruction-forge | Meta | Zeus, Athena |
|
|
163
173
|
|
|
164
174
|
---
|
|
165
175
|
|
|
@@ -46,7 +46,7 @@ Route tasks to optimized agents based on category instead of specifying agents m
|
|
|
46
46
|
## Parallel Execution Declaration
|
|
47
47
|
|
|
48
48
|
```
|
|
49
|
-
|
|
49
|
+
PARALLEL EXECUTION — Phase 2
|
|
50
50
|
Running simultaneously:
|
|
51
51
|
- @hermes → backend tests → .tmp/IMPL-phase2-hermes.md
|
|
52
52
|
- @aphrodite → frontend → .tmp/IMPL-phase2-aphrodite.md
|
|
@@ -90,8 +90,8 @@ Model routing is handled by Prometheus and the platform configuration. Zeus dele
|
|
|
90
90
|
|
|
91
91
|
## Anti-Patterns
|
|
92
92
|
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
-
|
|
96
|
-
-
|
|
97
|
-
-
|
|
93
|
+
- Zeus doing implementation work (orchestrates, doesn't code)
|
|
94
|
+
- Skipping TDD cycle (RED → GREEN → REFACTOR)
|
|
95
|
+
- Auto-committing without user approval
|
|
96
|
+
- Parallel phases with dependencies (order matters)
|
|
97
|
+
- Ignoring Themis CRITICAL findings
|
|
@@ -1,62 +1,68 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: artifact-management
|
|
3
|
-
description: "Structured artifacts for
|
|
3
|
+
description: "Structured high-density artifacts for architectural plans, deepwork, executive reports, and ADRs."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Artifact Management
|
|
7
7
|
|
|
8
|
-
Structured
|
|
8
|
+
Structured, high-density visual artifacts for planned, multi-phase, or materially risky implementation work. Artifacts are not a prerequisite for simple bounded fixes or read-only investigation.
|
|
9
9
|
|
|
10
10
|
---
|
|
11
11
|
|
|
12
|
-
## Artifact
|
|
12
|
+
## Artifact Storage Locations
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|--------|----------|------------|-------------|
|
|
16
|
-
| `PLAN-` | `.tmp/` | ✅ | Athena |
|
|
17
|
-
| `IMPL-` | `.tmp/` | ✅ | Hermes/Aphrodite/Demeter |
|
|
18
|
-
| `REVIEW-` | `.tmp/` | ✅ | Themis |
|
|
19
|
-
| `DISC-` | `.tmp/` | ✅ | Apollo |
|
|
20
|
-
| `ADR-` | `_notes/` | ❌ Permanent | Any → Mnemosyne |
|
|
14
|
+
Artifacts must not pollute the project root. The Pantheon ecosystem persists artifacts across three standard destinations:
|
|
21
15
|
|
|
22
|
-
|
|
16
|
+
| Artifact Type | Target Path | Produced By | Lifecycle |
|
|
17
|
+
|---|---|---|---|
|
|
18
|
+
| Architectural Plan & Deepwork | `.pantheon/deepwork/<slug>/PLAN.md` | @athena | Durable across task/sprint |
|
|
19
|
+
| Executive Report & Analysis | `.pantheon/reports/<YYYY-MM-DD>-<topic>.md` | @apollo / @themis | Permanent for audit/history |
|
|
20
|
+
| Architectural Decision Record (ADR) | `docs/adr/<NNN>-<slug>.md` | @mnemosyne | Permanent repository asset |
|
|
23
21
|
|
|
24
|
-
|
|
22
|
+
Note: Files in `.pantheon/deepwork/` are gitignored by default, while `.pantheon/reports/` and `docs/adr/` can be tracked in version control.
|
|
25
23
|
|
|
26
|
-
|
|
27
|
-
|-----------|-------|----------|
|
|
28
|
-
| Planning | Athena | `PLAN-<feature>.md` |
|
|
29
|
-
| Implementation | Worker | `IMPL-phase<N>-<agent>.md` |
|
|
30
|
-
| Review | Themis | `REVIEW-<feature>.md` |
|
|
31
|
-
| Discovery | Apollo | `DISC-<topic>.md` |
|
|
32
|
-
| Decision | Any → Mnemosyne | `ADR-<topic>.md` |
|
|
24
|
+
---
|
|
33
25
|
|
|
34
|
-
|
|
26
|
+
## High-Density Visual Artifact Standard (5 Core Blocks)
|
|
35
27
|
|
|
36
|
-
|
|
28
|
+
When generating plans, executive reports, or ADRs, agents must format documents using high density, visual clarity, and concrete data:
|
|
37
29
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
30
|
+
### 1. GitHub-Flavored Markdown (GFM) Alerts
|
|
31
|
+
Use alerts to highlight background context, efficiency gains, and safety gates:
|
|
32
|
+
- `> [!NOTE]` Background context, technical assumptions, and architecture decisions.
|
|
33
|
+
- `> [!TIP]` Performance optimizations, token footprint savings, and latency wins.
|
|
34
|
+
- `> [!IMPORTANT]` Mandatory requirements, verification gates, and human approval checkpoints.
|
|
35
|
+
- `> [!WARNING]` Potential breaking changes, deprecation notices, or environment constraints.
|
|
42
36
|
|
|
43
|
-
|
|
37
|
+
### 2. Native Mermaid Diagrams
|
|
38
|
+
Include a visual flowchart (`flowchart TD` or `graph LR`) visualizing the execution graph, agent handoffs, and verification gates before code changes begin.
|
|
44
39
|
|
|
45
|
-
|
|
40
|
+
### 3. Quantitative Diagnostics & Comparison Tables
|
|
41
|
+
Provide real metrics rather than vague qualitative statements:
|
|
42
|
+
- Tokens / context footprint (before vs after)
|
|
43
|
+
- Test execution latency (e.g. global vs sliced test)
|
|
44
|
+
- File counts and lines affected
|
|
46
45
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
46
|
+
### 4. Sliced Actionable Phases
|
|
47
|
+
Every implementation phase lists:
|
|
48
|
+
- Assigned specialist (`@hermes`, `@aphrodite`, `@demeter`, etc.)
|
|
49
|
+
- Specific affected files (exact paths, no vague placeholders)
|
|
50
|
+
- Exact verification command (e.g. `node --test tests/foo.test.mjs`, `pytest -k ...`)
|
|
51
|
+
- Clear exit criteria and acceptance checklist
|
|
52
|
+
|
|
53
|
+
### 5. Risk & Contingency Matrix
|
|
54
|
+
Map concrete risks directly to their contingency actions:
|
|
55
|
+
- Specific technical risk -> immediate remediation action.
|
|
50
56
|
|
|
51
57
|
---
|
|
52
58
|
|
|
53
|
-
##
|
|
59
|
+
## Proportional Use
|
|
54
60
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
61
|
+
- Create PLAN/IMPL/REVIEW artifacts for planned multi-phase work or when risk, auditability, or an explicit request needs a durable phase trail.
|
|
62
|
+
- A bounded, reversible fix should be investigated only as far as needed, implemented, verified with focused checks, and returned as a concise summary. Do not create PLAN, IMPL, or REVIEW artifacts for it.
|
|
63
|
+
- Read-only lookup or trivial discovery needs no DISC artifact; use one only when findings are broad enough to be reused or drive a material decision.
|
|
64
|
+
- The absence of an artifact never waives Themis review or human approval for auth/security, data/schema/migrations, production-impacting work, or sensitive actions.
|
|
65
|
+
- Zeus does not implement or write artifacts directly; he coordinates the specialist agents who generate and review them.
|
|
60
66
|
|
|
61
67
|
---
|
|
62
68
|
|
|
@@ -64,6 +70,4 @@ Structured artifact trail for planned, multi-phase, or materially risky implemen
|
|
|
64
70
|
|
|
65
71
|
| Action / trigger | Reference |
|
|
66
72
|
|---|---|
|
|
67
|
-
|
|
|
68
|
-
|
|
69
|
-
A missing reference interrupts the action — read nothing in its place, never improvise from memory.
|
|
73
|
+
| Templates for PLAN, REPORT, and ADR | [references/artifact-templates.md](references/artifact-templates.md) |
|
|
@@ -1,71 +1,126 @@
|
|
|
1
|
-
# Artifact Management — Templates
|
|
1
|
+
# Artifact Management — High-Density Templates
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
you need the `.tmp/` layout or a PLAN/IMPL/REVIEW template. Artifact types,
|
|
5
|
-
who-generates-what, proportional-use rules, pause points, and cleanup stay in
|
|
6
|
-
`SKILL.md`.
|
|
3
|
+
Companion reference for `SKILL.md`. Contains templates for architectural plans, executive reports, and ADRs.
|
|
7
4
|
|
|
8
5
|
---
|
|
9
6
|
|
|
10
|
-
##
|
|
7
|
+
## 1. Architectural Plan (`.pantheon/deepwork/<slug>/PLAN.md`)
|
|
11
8
|
|
|
12
|
-
|
|
9
|
+
Produced by `@athena`. Opens with an immediate Mermaid diagram and follows with dense, actionable phases:
|
|
13
10
|
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
├── .tmp/ ← GITIGNORED — ephemeral artifacts
|
|
17
|
-
│ ├── PLAN-<feature>.md
|
|
18
|
-
│ ├── IMPL-phase1-hermes.md
|
|
19
|
-
│ ├── IMPL-phase1-aphrodite.md
|
|
20
|
-
│ └── REVIEW-<feature>.md
|
|
21
|
-
├── _notes/ ← permanent ADRs; Git tracking follows repository policy
|
|
22
|
-
│ └── ADR-<topic>.md
|
|
23
|
-
├── 01-active-context.md
|
|
24
|
-
└── 02-progress-log.md
|
|
25
|
-
```
|
|
11
|
+
```markdown
|
|
12
|
+
# Architectural Plan: [Feature / Refactor Title]
|
|
26
13
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
or other files being tracked; `_tasks/` may be Git-ignored.
|
|
14
|
+
> [!NOTE]
|
|
15
|
+
> High-level context, background problem, and target outcome.
|
|
30
16
|
|
|
31
|
-
|
|
17
|
+
> [!IMPORTANT]
|
|
18
|
+
> Non-negotiable safety constraints, auth boundaries, or database schema requirements.
|
|
32
19
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
20
|
+
## 1. Visual Execution Flow
|
|
21
|
+
|
|
22
|
+
\`\`\`mermaid
|
|
23
|
+
flowchart TD
|
|
24
|
+
A["Requirement"] --> B["Phase 1: Backend (@hermes)"]
|
|
25
|
+
B --> C{"Lint & Slice Test Gate"}
|
|
26
|
+
C -- PASS --> D["Phase 2: Frontend (@aphrodite)"]
|
|
27
|
+
D --> E["Phase 3: Security & Code Audit (@themis)"]
|
|
28
|
+
\`\`\`
|
|
29
|
+
|
|
30
|
+
## 2. Quantitative Baseline & Impact
|
|
37
31
|
|
|
38
|
-
|
|
39
|
-
|
|
32
|
+
| Dimension | Before | Target | Verification Method |
|
|
33
|
+
|---|---|---|---|
|
|
34
|
+
| Latency | ~150s | < 2s | Sliced test runner |
|
|
35
|
+
| Token Overhead | ~20k | < 8k | Context telemetry |
|
|
36
|
+
| Affected Files | — | 3 files | Git diff check |
|
|
40
37
|
|
|
41
|
-
## Phases
|
|
42
|
-
1. Phase 1 — @hermes
|
|
43
|
-
2. Phase 2 — @aphrodite
|
|
38
|
+
## 3. Implementation Phases
|
|
44
39
|
|
|
45
|
-
|
|
46
|
-
-
|
|
40
|
+
### Phase 1: Core Implementation (@hermes)
|
|
41
|
+
- **Target Files:** `src/server/auth.ts`, `tests/auth.test.ts`
|
|
42
|
+
- **Actions:** RED -> GREEN -> REFACTOR implementation of the auth handler.
|
|
43
|
+
- **Validation Gate:** `node --test tests/auth.test.ts`
|
|
44
|
+
- **Exit Criteria:** All tests green; no Biome/Ruff lint warnings.
|
|
45
|
+
|
|
46
|
+
### Phase 2: Interface & Client (@aphrodite)
|
|
47
|
+
- **Target Files:** `src/ui/login.tsx`
|
|
48
|
+
- **Actions:** Connect UI state to new auth endpoint; ensure WCAG AA keyboard access.
|
|
49
|
+
- **Validation Gate:** `npx biome check src/ui/login.tsx`
|
|
50
|
+
|
|
51
|
+
## 4. Risks & Contingency
|
|
52
|
+
|
|
53
|
+
| Identified Risk | Impact | Contingency / Mitigation |
|
|
54
|
+
|---|---|---|
|
|
55
|
+
| Breaking change to legacy clients | High | Preserve backwards-compatible endpoint alias for 1 release |
|
|
56
|
+
| Token spike in subagent cascade | Medium | Use direct specialist dispatch without intermediate hops |
|
|
47
57
|
```
|
|
48
58
|
|
|
49
|
-
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 2. Executive Report & Analysis (`.pantheon/reports/<YYYY-MM-DD>-<topic>.md`)
|
|
62
|
+
|
|
63
|
+
Produced by `@apollo` (deep discovery) or `@themis` (quality/security audits):
|
|
64
|
+
|
|
50
65
|
```markdown
|
|
51
|
-
#
|
|
52
|
-
**Date:** YYYY-MM-DD **Status:** Awaiting Themis Review
|
|
66
|
+
# Executive Report: [Analysis Topic]
|
|
53
67
|
|
|
54
|
-
|
|
55
|
-
|
|
68
|
+
> [!NOTE]
|
|
69
|
+
> Summary of findings and systemic conclusions.
|
|
56
70
|
|
|
57
|
-
|
|
58
|
-
|
|
71
|
+
> [!TIP]
|
|
72
|
+
> Key optimization opportunities and quick wins.
|
|
73
|
+
|
|
74
|
+
## 1. Architecture / System Topology
|
|
75
|
+
|
|
76
|
+
\`\`\`mermaid
|
|
77
|
+
graph LR
|
|
78
|
+
Client["Client Host"] --> Gateway["Decision Router"]
|
|
79
|
+
Gateway --> Specialist["Domain Specialist"]
|
|
80
|
+
\`\`\`
|
|
81
|
+
|
|
82
|
+
## 2. Metrics & Comparison
|
|
83
|
+
|
|
84
|
+
| Metric | Current State | Target / Proposed | Delta (%) |
|
|
85
|
+
|---|---|---|---|
|
|
86
|
+
| Test Latency | 150.000ms | 50ms | -99.9% |
|
|
87
|
+
| Initial Context | 19.877 tokens | 7.500 tokens | -62.2% |
|
|
88
|
+
|
|
89
|
+
## 3. Findings & Evidence
|
|
90
|
+
- Detailed finding 1 with exact file citations.
|
|
91
|
+
- Detailed finding 2 with reproducible evidence.
|
|
92
|
+
|
|
93
|
+
## 4. Prioritized Recommendations
|
|
94
|
+
1. Actionable item 1 (low effort, high impact)
|
|
95
|
+
2. Actionable item 2 (medium effort)
|
|
59
96
|
```
|
|
60
97
|
|
|
61
|
-
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## 3. Architectural Decision Record (`docs/adr/<NNN>-<slug>.md`)
|
|
101
|
+
|
|
102
|
+
Produced by `@mnemosyne`:
|
|
103
|
+
|
|
62
104
|
```markdown
|
|
63
|
-
#
|
|
64
|
-
|
|
105
|
+
# ADR-[NNN]: [Decision Title]
|
|
106
|
+
|
|
107
|
+
**Date:** YYYY-MM-DD
|
|
108
|
+
**Status:** [Proposed | Accepted | Superseded]
|
|
109
|
+
|
|
110
|
+
> [!IMPORTANT]
|
|
111
|
+
> Decision impacts: [Core systems / architecture / protocols].
|
|
112
|
+
|
|
113
|
+
## Context
|
|
114
|
+
What problem was being solved? What forces or constraints applied?
|
|
115
|
+
|
|
116
|
+
## Decision
|
|
117
|
+
What was decided? Which approach was chosen over the alternatives?
|
|
65
118
|
|
|
66
|
-
##
|
|
67
|
-
|
|
119
|
+
## Alternatives Considered
|
|
120
|
+
- **Alternative A:** [Reason rejected]
|
|
121
|
+
- **Alternative B:** [Reason rejected]
|
|
68
122
|
|
|
69
|
-
##
|
|
70
|
-
-
|
|
123
|
+
## Consequences
|
|
124
|
+
- **Positive:** [Benefits gained]
|
|
125
|
+
- **Negative / Trade-offs:** [Costs or constraints accepted]
|
|
71
126
|
```
|