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.
Files changed (93) hide show
  1. package/AGENTS.global.md +7 -2
  2. package/AGENTS.md +8 -8
  3. package/CHANGELOG.md +99 -0
  4. package/README.md +171 -510
  5. package/README.pt-BR.md +179 -149
  6. package/bin/pantheon-init.mjs +14 -1
  7. package/commands/pantheon-audit.md +1 -1
  8. package/commands/pantheon-deepwork.md +7 -2
  9. package/commands/pantheon-optimize.md +41 -63
  10. package/commands/pantheon.md +10 -5
  11. package/package.json +4 -3
  12. package/plugin.json +2 -2
  13. package/prompts/optimize-database.prompt.md +5 -5
  14. package/prompts/orchestrate-with-zeus.prompt.md +82 -290
  15. package/prompts/plan-architecture.prompt.md +6 -6
  16. package/prompts/subtask.prompt.md +1 -1
  17. package/pyproject.toml +1 -1
  18. package/scripts/build-agents-md.mjs +10 -10
  19. package/scripts/build-plugin.mjs +26 -0
  20. package/scripts/doctor.mjs +27 -11
  21. package/scripts/hooks/format-multi-language.sh +30 -48
  22. package/scripts/install/opencode-version.mjs +17 -5
  23. package/scripts/install/opencode.mjs +8 -1
  24. package/scripts/jev-live-probe.mjs +1 -1
  25. package/scripts/optimize.mjs +322 -0
  26. package/scripts/prune.mjs +105 -14
  27. package/scripts/release-gates.mjs +19 -5
  28. package/scripts/skill-search.mjs +27 -3
  29. package/scripts/test-opencode-sandbox.sh +44 -15
  30. package/scripts/update.mjs +29 -17
  31. package/skills-lock.json +15 -13
  32. package/src/agents/aphrodite.md +17 -14
  33. package/src/agents/apollo.md +10 -207
  34. package/src/agents/athena.md +30 -34
  35. package/src/agents/demeter.md +2 -0
  36. package/src/agents/hephaestus.md +1 -0
  37. package/src/agents/hermes.md +21 -95
  38. package/src/agents/iris.md +3 -0
  39. package/src/agents/mnemosyne.md +1 -1
  40. package/src/agents/nyx.md +2 -1
  41. package/src/agents/prometheus.md +2 -203
  42. package/src/agents/talos.md +5 -0
  43. package/src/agents/themis.md +93 -84
  44. package/src/agents/zeus.md +44 -263
  45. package/src/instructions/agent-return-format.instructions.md +1 -1
  46. package/src/instructions/memory-protocol.instructions.md +5 -1
  47. package/src/instructions/test-economy.instructions.md +1 -0
  48. package/src/instructions/zeus-anti-stall.instructions.md +3 -3
  49. package/src/instructions/zeus-communication-rules.instructions.md +1 -1
  50. package/src/instructions/zeus-council-synthesis.instructions.md +15 -3
  51. package/src/instructions/zeus-timeout-retry.instructions.md +10 -10
  52. package/src/pantheon/model-command.ts +12 -12
  53. package/src/pantheon/pantheon-decision-catalog.ts +8 -0
  54. package/src/pantheon/skill-search-tool.ts +193 -0
  55. package/src/pantheon/tools.ts +6 -0
  56. package/src/pantheon/tui-version-check.ts +1 -1
  57. package/src/pantheon/update-notifier.ts +13 -8
  58. package/src/pantheon/vision.ts +20 -20
  59. package/src/plugin/index.js +14594 -0
  60. package/src/plugins/tui/dist/tui.d.ts +15 -5
  61. package/src/plugins/tui/dist/tui.d.ts.map +1 -1
  62. package/src/plugins/tui/dist/tui.js +1761 -556
  63. package/src/plugins/tui/dist/tui.js.map +1 -1
  64. package/src/plugins/tui/package-lock.json +2 -2
  65. package/src/plugins/tui/package.json +1 -1
  66. package/src/plugins/tui/src/autonomy-state.ts +28 -16
  67. package/src/plugins/tui/src/context-gauge.ts +64 -5
  68. package/src/plugins/tui/src/decision-router-state.ts +49 -2
  69. package/src/plugins/tui/src/index.tsx +69 -26
  70. package/src/plugins/tui/src/pantheon-settings-state.ts +99 -0
  71. package/src/plugins/tui/src/pantheon-settings.tsx +771 -125
  72. package/src/plugins/tui/src/tui-prefs.ts +266 -12
  73. package/src/plugins/tui/src/update-notice.ts +9 -6
  74. package/src/plugins/tui/src/update-status.ts +27 -8
  75. package/src/plugins/tui/src/whats-new-open.ts +4 -4
  76. package/src/plugins/tui/src/whats-new.tsx +119 -17
  77. package/src/routing.yml +9 -0
  78. package/src/skills/README.md +35 -25
  79. package/src/skills/agent-coordination/SKILL.md +6 -6
  80. package/src/skills/artifact-management/SKILL.md +43 -39
  81. package/src/skills/artifact-management/references/artifact-templates.md +103 -48
  82. package/src/skills/auto-continue/references/auto-continue-details.md +13 -13
  83. package/src/skills/code-review-checklist/SKILL.md +6 -6
  84. package/src/skills/fast-path-execution/SKILL.md +54 -0
  85. package/src/skills/incremental-implementation/SKILL.md +13 -13
  86. package/src/skills/memory-bank/references/anti-patterns.md +3 -3
  87. package/src/skills/prompt-refinery/SKILL.md +51 -65
  88. package/src/skills/spec-driven-development/SKILL.md +12 -14
  89. package/src/skills/tdd-with-agents/SKILL.md +23 -10
  90. package/src/skills/test-slicing/SKILL.md +56 -0
  91. package/src/skills/verification-planning/SKILL.md +4 -3
  92. package/src/skills/visual-review-pipeline/SKILL.md +1 -1
  93. 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 hint. */
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, 76))
55
+ for (const line of current) wrapped.push(...wrapWhatsNewLine(line, 72))
52
56
  return wrapped
53
57
  }
54
58
  return (
55
- <box flexDirection="column" paddingLeft={1} paddingRight={1} paddingTop={1}>
56
- <text attributes={1} fg={props.fg}>
57
- {props.data.title}
58
- </text>
59
- <text fg={props.muted}>{'─'.repeat(38)}</text>
60
- <For each={rows()}>
61
- {(line: string) => <text fg={line.startsWith('• ') ? props.fg : props.muted}>{line}</text>}
62
- </For>
63
- <box height={1} />
64
- <text fg={props.muted}>
65
- {props.pageCount() > 1 ? `${props.page() + 1}/${props.pageCount()} · ` : ''}
66
- {props.data.hint}
67
- </text>
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: 'Fechar o que há de novo',
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
@@ -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 **23 skills** divided into **6 domains**.
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. **artifact-management** — `artifact-management/SKILL.md`
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
- 16. **tdd-with-agents** — `tdd-with-agents/SKILL.md`
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 | artifact-management | Orchestration & Workflow | Zeus, Mnemosyne, Iris |
142
- | 3 | auto-continue | Orchestration & Workflow | Zeus, Apollo, Hephaestus, Nyx, Gaia |
143
- | 4 | context-compression | Orchestration & Workflow | Zeus, Mnemosyne |
144
- | 5 | memory-bank | Orchestration & Workflow | Mnemosyne, Athena |
145
- | 6 | session-goal | Orchestration & Workflow | Zeus, Mnemosyne |
146
- | 7 | clonedeps | Development Tools | Hermes, Hephaestus |
147
- | 8 | git-workflow-and-versioning | Development Tools | Hermes, Prometheus, Iris |
148
- | 9 | incremental-implementation | Development Tools | Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos |
149
- | 10 | loop-engineering | Development Tools | All agents |
150
- | 11 | reflect | Development Tools | All agents |
151
- | 12 | simplify | Development Tools | All agents |
152
- | 13 | worktrees | Development Tools | All agents |
153
- | 14 | code-review-checklist | Quality & Security | Themis |
154
- | 15 | security-hardening | Quality & Security | Themis, Nyx |
155
- | 16 | tdd-with-agents | Quality & Security | Hermes, Aphrodite, Demeter, Themis, Hephaestus |
156
- | 17 | codemap | Planning | Apollo, Zeus |
157
- | 18 | spec-driven-development | Planning | Athena |
158
- | 19 | verification-planning | Planning | Athena, Zeus |
159
- | 20 | visual-review-pipeline | Frontend Development | Aphrodite |
160
- | 21 | agent-forge | Meta | Zeus |
161
- | 22 | prompt-refinery | Meta | Zeus |
162
- | 23 | instruction-forge | Meta | Zeus, Athena |
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
- 🔀 PARALLEL EXECUTION — Phase 2
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
- - ❌ 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
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 planned, multi-phase, or materially risky implementation work."
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 artifact trail for planned, multi-phase, or materially risky implementation work. Artifacts are not a prerequisite for simple fixes or read-only investigation.
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 Types
12
+ ## Artifact Storage Locations
13
13
 
14
- | Prefix | Location | Ephemeral? | Produced by |
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
- ## Who Generates
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
- | Situation | Agent | Artifact |
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
- > **Zeus does NOT generate artifacts.** He orchestrates agents that generate them.
26
+ ## High-Density Visual Artifact Standard (5 Core Blocks)
35
27
 
36
- ## Proportional Use
28
+ When generating plans, executive reports, or ADRs, agents must format documents using high density, visual clarity, and concrete data:
37
29
 
38
- - Create PLAN/IMPL/REVIEW artifacts for planned multi-phase work or when risk, auditability, or an explicit request needs a durable phase trail.
39
- - 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.
40
- - 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.
41
- - The absence of an artifact never waives Themis review or human approval for auth/security, data/schema/migrations, production-impacting work, or sensitive actions.
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
- ## Human Pause Points
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
- 1. **After a required PLAN** → pause only when a material scope/risk decision needs approval.
48
- 2. **After required REVIEW** → preserve auth/security/data/schema and other sensitive approval gates.
49
- 3. **Before commit/push/merge/deploy or destructive/global action** → require explicit human approval.
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
- ## Cleanup
59
+ ## Proportional Use
54
60
 
55
- ```
56
- @mnemosyne Close sprint # Wipes entire .tmp/
57
- @mnemosyne Clean tmp # Wipes .tmp/ without closing sprint
58
- @mnemosyne List artifacts # Check what's in .tmp/
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
- | Creating an artifact: the `.tmp/` layout or the PLAN/IMPL/REVIEW templates | [references/artifact-templates.md](references/artifact-templates.md) |
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
- Detail companion for `SKILL.md`. Read on demand when creating an artifact and
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
- ## Temp Folder
7
+ ## 1. Architectural Plan (`.pantheon/deepwork/<slug>/PLAN.md`)
11
8
 
12
- All ephemeral artifacts live in `.pantheon/memory-bank/.tmp/` — gitignored and wiped on sprint close.
9
+ Produced by `@athena`. Opens with an immediate Mermaid diagram and follows with dense, actionable phases:
13
10
 
14
- ```
15
- .pantheon/memory-bank/
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
- Memory Bank files are not automatically versioned or shared across clones.
28
- Check the repository's ignore/commit policy before relying on `_tasks/` records
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
- ### PLAN
34
- ```markdown
35
- # PLAN-<feature>
36
- **Date:** YYYY-MM-DD **Status:** Awaiting Approval
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
- ## Goal
39
- [One sentence]
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
- ## Risks
46
- - [Risk]
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
- ### IMPL
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
- # IMPL-<phase>-<agent>
52
- **Date:** YYYY-MM-DD **Status:** Awaiting Themis Review
66
+ # Executive Report: [Analysis Topic]
53
67
 
54
- ## What Was Implemented
55
- - [file] — [what changed]
68
+ > [!NOTE]
69
+ > Summary of findings and systemic conclusions.
56
70
 
57
- ## Tests
58
- - ✅ X tests / Coverage: Y%
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
- ### REVIEW
98
+ ---
99
+
100
+ ## 3. Architectural Decision Record (`docs/adr/<NNN>-<slug>.md`)
101
+
102
+ Produced by `@mnemosyne`:
103
+
62
104
  ```markdown
63
- # REVIEW-<feature>
64
- **Status:** APPROVED | NEEDS_REVISION | FAILED
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
- ## Verdict
67
- [APPROVED | NEEDS_REVISION | FAILED]
119
+ ## Alternatives Considered
120
+ - **Alternative A:** [Reason rejected]
121
+ - **Alternative B:** [Reason rejected]
68
122
 
69
- ## Issues
70
- - CRITICAL: X / HIGH: Y / MEDIUM: Z
123
+ ## Consequences
124
+ - **Positive:** [Benefits gained]
125
+ - **Negative / Trade-offs:** [Costs or constraints accepted]
71
126
  ```