pantheon-opencode 1.6.2-beta.2 → 1.6.2-beta.3

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 (36) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +18 -15
  3. package/bin/pantheon-init.mjs +51 -13
  4. package/package.json +2 -1
  5. package/plugin.json +1 -1
  6. package/prompts/README.md +58 -0
  7. package/prompts/debug-issue.prompt.md +46 -0
  8. package/prompts/dynamic/agora-generated.txt +38 -0
  9. package/prompts/dynamic/orchestrate-generated.txt +51 -0
  10. package/prompts/focus.prompt.md +42 -0
  11. package/prompts/implement-feature.prompt.md +39 -0
  12. package/prompts/optimize-database.prompt.md +58 -0
  13. package/prompts/orchestrate-with-zeus.prompt.md +441 -0
  14. package/prompts/plan-architecture.prompt.md +59 -0
  15. package/prompts/quick-discovery-large-codebase.prompt.md +294 -0
  16. package/prompts/quick-plan-large-feature.prompt.md +197 -0
  17. package/prompts/semantic-summarize.md +50 -0
  18. package/prompts/sketch.prompt.md +91 -0
  19. package/prompts/subtask.prompt.md +131 -0
  20. package/pyproject.toml +1 -1
  21. package/scripts/install/component-selection.mjs +9 -4
  22. package/scripts/install/health-check.mjs +20 -11
  23. package/scripts/install/interactive.mjs +9 -16
  24. package/scripts/install/interrupt.mjs +4 -3
  25. package/scripts/install/migrate.mjs +123 -72
  26. package/scripts/install/opencode.mjs +150 -114
  27. package/scripts/install/plan.mjs +8 -1
  28. package/scripts/install/state.mjs +7 -0
  29. package/scripts/install/strings.mjs +6 -0
  30. package/scripts/install/venv.mjs +34 -17
  31. package/scripts/restore.mjs +22 -10
  32. package/scripts/test-opencode-v2-sandbox.sh +10 -6
  33. package/src/plugins/tui/dist/tui-v2.js +3 -3
  34. package/src/plugins/tui/dist/tui.js +1 -1
  35. package/src/plugins/tui/package-lock.json +2 -2
  36. package/src/plugins/tui/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -10,6 +10,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
10
10
  <!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
11
11
  move this section to a versioned entry and reset the template below. -->
12
12
 
13
+ ## [v1.6.2-beta.3] - 2026-10-29
14
+
15
+ ### Changed
16
+
17
+ - **install** — Direct `init` uses matching TTY/headless component defaults; Python runtime and prompt templates are opt-in, and `--yes` suppresses prompts without skipping preview or drift checks.
18
+ - **install** — Runtime health checks verify SQLite FTS5 capability and fail when it is unavailable.
19
+
20
+ ### Fixed
21
+
22
+ - **install** — Explicit restore decline exits successfully; missing authorization fails closed, while cancellation exits `130`. Post-write interrupts and runtime failures record the selected target and partial/degraded state.
23
+ - **install** — Migration schema version is tracked separately from the installed package version and remains idempotent across prerelease package versions.
24
+
25
+ &lt;!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
26
+ move this section to a versioned entry and reset the template below. --&gt;
13
27
  ## [v1.6.2-beta.2] - 2026-10-28
14
28
 
15
29
  ### Added
package/README.md CHANGED
@@ -46,22 +46,25 @@ npx pantheon-opencode init
46
46
  opencode
47
47
  ```
48
48
 
49
- For the optional full setup flow, run `npm run setup`. On detected OpenCode V2,
49
+ Direct `init` uses the same component defaults in TTY and headless runs:
50
+ `agents`, `skills`, `instructions`, `commands`, and `plugins`. `runtime` and
51
+ `prompts` are opt-in. A TTY run selects components and target, shows a preview,
52
+ then asks once for final authorization (default **no**). Without a TTY, `init`
53
+ is preview-only unless `--yes` explicitly authorizes the apply; `--yes` skips
54
+ prompts but still prints the preview and checks for drift.
55
+
56
+ `npm run setup` is a separate repository setup wrapper. On detected OpenCode V2
50
57
  it reviews the global config before installer init: legacy permission rules can
51
- be migrated after explicit review. Verified Pantheon plugin/MCP entries are
52
- reported; JSONC entries move only when order and overrides stay safe, otherwise
53
- the user must choose to keep them in place or abort. Config migration and
54
- installer changes are preflighted before one final authorization; `--yes` alone
55
- does not authorize writes. Overlapping MCP wildcard policies that could allow
56
- an action after a denial are blocked, and ineffective MCP `ask` rules matching
57
- configured or installer-seeded servers require an explicit outcome.
58
- Existing native V2 `permissions` arrays stay authoritative; Pantheon does not
59
- append legacy default grants to them.
60
- Flat third-party MCP entries in `opencode.jsonc` block V2 setup until manually
61
- converted to `mcp.servers` or removed; nested third-party servers are preserved.
62
- Headless/CI/non-TTY runs are preview-only and do not invoke writing init (V1
63
- included). See the [installation guide](docs/INSTALLATION.md) for layer handling,
64
- conflict choices, backups, and recovery.
58
+ be migrated after explicit review. Config migration and installer changes are
59
+ preflighted before one final authorization; `--yes` alone does not authorize
60
+ setup writes, and headless/CI setup remains preview-only. Direct
61
+ `npx pantheon-opencode init` does not run that V2 config-migration review. See
62
+ the [installation guide](docs/INSTALLATION.md) for layer handling, conflict
63
+ choices, backups, and recovery.
64
+ Existing native V2 `permissions` arrays remain authoritative. Unsafe MCP
65
+ wildcard policies and ineffective `ask` rules require explicit resolution;
66
+ third-party flat MCP entries in `opencode.jsonc` must be converted to
67
+ `mcp.servers` or removed before V2 setup.
65
68
 
66
69
  Global `init` and `setup` use `$XDG_CONFIG_HOME/opencode` when
67
70
  `XDG_CONFIG_HOME` is absolute; otherwise they use `~/.config/opencode`.
@@ -316,9 +316,15 @@ async function main() {
316
316
  !Array.isArray(options.components) ||
317
317
  options.components.some(
318
318
  (component) =>
319
- !['agents', 'skills', 'instructions', 'commands', 'plugins', 'runtime'].includes(
320
- component,
321
- ),
319
+ ![
320
+ 'agents',
321
+ 'skills',
322
+ 'instructions',
323
+ 'prompts',
324
+ 'commands',
325
+ 'plugins',
326
+ 'runtime',
327
+ ].includes(component),
322
328
  ) ||
323
329
  options.clean !== false ||
324
330
  !['v1', 'v2', 'auto'].includes(options.version) ||
@@ -482,8 +488,8 @@ async function main() {
482
488
  process.exit(1)
483
489
  }
484
490
 
485
- // Resolve the user's explicit selection separately from the defaults. An
486
- // unscoped install gets runtime by default; explicit --components does not.
491
+ // Resolve the user's explicit selection separately from the defaults.
492
+ // Runtime and prompt templates are opt-in in both TTY and headless mode.
487
493
  let componentSelection
488
494
  try {
489
495
  componentSelection = resolveComponentSelection(args, {
@@ -525,6 +531,9 @@ async function main() {
525
531
  // installer's own default (`~/.config/opencode`), so the record lands next
526
532
  // to the config the next run will read.
527
533
  const fallbackTarget = isProject ? process.cwd() : resolveGlobalConfigDirectory(process.env)
534
+ let chosenTarget = reviewedPlan?.target.path ?? fallbackTarget
535
+ let hasAppliedWrites = false
536
+ let recoveryBackup = null
528
537
  /**
529
538
  * Persist the one-line record of this run. Bookkeeping is best-effort: a
530
539
  * failure is reported, never fatal, and never changes the exit code.
@@ -532,7 +541,7 @@ async function main() {
532
541
  * @param {{status: string, reason?: string|null, cancelPoint?: string|null, applied: boolean, target?: string}} outcome
533
542
  */
534
543
  const recordRun = (outcome) => {
535
- const recordTarget = outcome.target ?? result?.target ?? fallbackTarget
544
+ const recordTarget = outcome.target ?? result?.target ?? chosenTarget
536
545
  const record = buildRunRecord({
537
546
  status: outcome.status,
538
547
  reason: outcome.reason ?? null,
@@ -610,16 +619,20 @@ async function main() {
610
619
  // consumes Ctrl-C in raw mode while a question is on screen (that path is
611
620
  // the interactive cancel above), so this covers the rest of the run.
612
621
  const onInterrupt = createInterruptHandler({
613
- message: S.canceledAt(S.cancelPoints.interrupt),
622
+ message: () =>
623
+ hasAppliedWrites
624
+ ? S.interruptedAfterWrite(recoveryBackup)
625
+ : S.canceledAt(S.cancelPoints.interrupt),
614
626
  json: isJson,
615
627
  endGaugeLine,
616
628
  onInterrupt: () => {
617
629
  if (!isDryRun) {
618
630
  recordRun({
619
- status: 'canceled',
620
- reason: 'canceled',
631
+ status: hasAppliedWrites ? 'partial' : 'canceled',
632
+ reason: hasAppliedWrites ? 'interrupted' : 'canceled',
621
633
  cancelPoint: 'interrupt',
622
- applied: false,
634
+ applied: hasAppliedWrites,
635
+ target: chosenTarget,
623
636
  })
624
637
  }
625
638
  },
@@ -688,7 +701,21 @@ async function main() {
688
701
  quiet: isJson,
689
702
  verbose: args.includes('--verbose') && !isJson,
690
703
  configPreview,
704
+ onTargetResolved: (resolvedTarget) => {
705
+ chosenTarget = resolvedTarget
706
+ },
707
+ onWrite: ({ target: writeTarget, backupDir }) => {
708
+ hasAppliedWrites = true
709
+ chosenTarget = writeTarget
710
+ if (backupDir) recoveryBackup = backupDir
711
+ },
691
712
  })
713
+ // File writers and the runtime installer use synchronous APIs. If SIGINT
714
+ // arrives during one of those calls, Node queues the signal callback
715
+ // until the event loop runs again. Keep the handler armed for one turn
716
+ // after the installer returns so a queued post-write interrupt is still
717
+ // recorded as partial instead of being lost to the success path.
718
+ await new Promise((resolve) => setImmediate(resolve))
692
719
  } catch (err) {
693
720
  installError = err
694
721
  } finally {
@@ -711,8 +738,15 @@ async function main() {
711
738
  `${S.installFailed(installError.message)}\n${S.failHintNoMcp}\n${S.failHintForce}`,
712
739
  )
713
740
  }
714
- // No record for a thrown failure: the error itself is the explanation,
715
- // and a run that failed has nothing to remember beyond its message.
741
+ if (!isDryRun) {
742
+ const outcome = installError.installOutcome ?? {}
743
+ recordRun({
744
+ status: outcome.applied ? 'partial' : 'failed',
745
+ reason: 'failed',
746
+ applied: outcome.applied === true,
747
+ target: outcome.target ?? chosenTarget,
748
+ })
749
+ }
716
750
  process.exitCode = 1
717
751
  return
718
752
  }
@@ -812,6 +846,7 @@ async function main() {
812
846
  totals,
813
847
  mcp_servers: mcpServers,
814
848
  mcp_server_count: mcpServers.length,
849
+ runtime_effects: result.runtimeEffects ?? null,
815
850
  files: files.map(({ path: filePath, action, bytes }) => ({
816
851
  path: path.relative(result.target, filePath) || '.',
817
852
  action,
@@ -881,7 +916,10 @@ async function main() {
881
916
  const doctorStartedAt = Date.now()
882
917
  const { spawnSync } = await import('node:child_process')
883
918
  const doctorScript = path.join(ROOT, 'scripts', 'doctor.mjs')
884
- const doctor = spawnSync(process.execPath, [doctorScript], { stdio: 'inherit', cwd: ROOT })
919
+ const doctor = spawnSync(process.execPath, [doctorScript, '--target', result.target], {
920
+ stdio: 'inherit',
921
+ cwd: ROOT,
922
+ })
885
923
  const doctorSeconds = ((Date.now() - doctorStartedAt) / 1000).toFixed(1)
886
924
  // Never leave "Running health check..." as the last word: report the
887
925
  // outcome and duration, and propagate the child's exit code so CI sees
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pantheon-opencode",
3
- "version": "1.6.2-beta.2",
3
+ "version": "1.6.2-beta.3",
4
4
  "description": "Multi-agent orchestration for OpenCode — 14 specialized agents, TDD, Themis review gates.",
5
5
  "type": "module",
6
6
  "workspaces": [
@@ -100,6 +100,7 @@
100
100
  "src/plugins/tui/**",
101
101
  "!src/plugins/tui/node_modules/**",
102
102
  "src/skills/**",
103
+ "prompts/**",
103
104
  "!**/__pycache__/**",
104
105
  "!**/*.pyc"
105
106
  ],
package/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "pantheon",
3
3
  "publisher": "ils15",
4
- "version": "1.6.2-beta.2",
4
+ "version": "1.6.2-beta.3",
5
5
  "displayName": "Pantheon",
6
6
  "description": "Conductor-Delegate orchestration platform with 14 specialized agents, 20 skills, and OpenCode support.",
7
7
  "agents": "./src/agents",
@@ -0,0 +1,58 @@
1
+ # Prompt Files
2
+
3
+ Reusable prompt templates for common development workflows. Each prompt
4
+ specifies a target agent, required tools, and structured instructions.
5
+
6
+ ## Available Prompts (10)
7
+
8
+ | Prompt | Agent | Purpose |
9
+ |---|---|---|
10
+ | **orchestrate-with-zeus** | Zeus | Full feature orchestration — planning, implementation, review, deployment |
11
+ | **implement-feature** | Zeus | End-to-end feature implementation with TDD and quality gates |
12
+ | **plan-architecture** | Athena | Strategic architecture planning with research and TDD-driven plan |
13
+ | **debug-issue** | Apollo | Rapid debugging with parallel file discovery and analysis |
14
+ | **optimize-database** | Demeter | Database schema, query, and performance optimization |
15
+ | **focus** | Zeus | Pin a session goal to keep all work aligned with a single objective |
16
+ | **sketch** | Athena | Interview a rough idea into a structured feature spec (3–5 questions) |
17
+ | **subtask** | Zeus | Delegate a bounded child task to a specialist and receive a structured result |
18
+ | **quick-discovery-large-codebase** | Apollo | Fast-path bounded discovery for large codebases (8-minute cap) |
19
+ | **quick-plan-large-feature** | Athena | Fast-path bounded planning for large features (5-minute cap) |
20
+
21
+ ## Usage
22
+
23
+ Prompt templates are **not** slash commands. OpenCode slash commands live in
24
+ `commands/` and are invoked in chat:
25
+
26
+ ```text
27
+ /pantheon Add CSV export to the reports page, including tests and a review.
28
+ /pantheon-audit Changes in src/auth/
29
+ /pantheon-focus Implement email verification end-to-end with TDD
30
+ /pantheon-deepwork Migrate the billing module
31
+ /pantheon-model status
32
+ /pantheon-optimize
33
+ /pantheon-vision
34
+ /pantheon-consolidate
35
+ ```
36
+
37
+ The templates in this directory are loaded by the command or agent that needs
38
+ them; they are not invoked directly by filename. In particular:
39
+
40
+ - `focus.prompt.md` is used by `/pantheon-focus`.
41
+ - The audit guidance is used by `/pantheon-audit`.
42
+ - `sketch.prompt.md` has **no matching command file**, so it is available as a
43
+ template only. There is currently no `/sketch` command.
44
+
45
+ For the full command list, see the commands directory in the repository. For
46
+ agent roles, see `docs/agents/README.md`.
47
+
48
+ ## Placeholder contract
49
+
50
+ OpenCode expands `$ARGUMENTS` and positional values such as `$1` in slash
51
+ commands. Those are command-runtime variables; prompt templates do not expand
52
+ `$input`, shell variables, angle-bracket examples, or JSON braces.
53
+
54
+ Manual prompt-template inputs use `{{UPPER_SNAKE_CASE}}`, for example
55
+ `{{TASK_INPUT}}` or `{{TARGET_AGENT}}`. The command or agent that loads the
56
+ template fills these fields before dispatch. This repository does not perform
57
+ automatic placeholder substitution or escaping, so callers must insert values
58
+ as data and preserve their intended quoting and boundaries.
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: debug-issue
3
+ description: "Rapidly debug issues with parallel file discovery and analysis"
4
+ agent: apollo
5
+ tools: ['search', 'usages']
6
+ ---
7
+
8
+ # Debug Quickly (Apollo - Scout)
9
+
10
+ ## Adaptive Search Strategy
11
+
12
+ Choose only the independent searches that fit the report. These are candidate
13
+ angles, not a required fan-out; a focused bug may need only one or two:
14
+
15
+ Search 1: Exact error message
16
+ Search 2: Mentioned function/class
17
+ Search 3: Related file patterns
18
+ Search 4: Similar test cases
19
+ Search 5: Related issues/PRs
20
+ Search 6: Stack trace patterns
21
+ Search 7: Config files
22
+ Search 8: Logging statements
23
+ Search 9: Mentioned dependencies
24
+ Search 10: Recent changes in area
25
+
26
+ ## Analysis & Synthesis
27
+ - Eliminate duplicates
28
+ - Identify file relationships
29
+ - Extract patterns
30
+ - Return prioritized findings
31
+
32
+ ## Recommendations
33
+
34
+ After analysis, @apollo returns:
35
+ 1. **Root Cause Hypothesis**: What's probably wrong
36
+ 2. **Key Files**: Most relevant files
37
+ 3. **Reproduction Steps**: How to reproduce
38
+ 4. **Suggested Fix**: Solution direction
39
+ 5. **Next Steps**: Next agents to involve
40
+
41
+ ## When to Use
42
+ - Bug report received
43
+ - Confusing error stack trace
44
+ - Performance issue diagnosis
45
+ - Regression debugging
46
+ - When you need quick exploration
@@ -0,0 +1,38 @@
1
+ # =============================================================================
2
+ # Dynamic Agora Prompt
3
+ # Generated: 2026-05-16T13:50:41Z
4
+ # Plan: copilot-free
5
+ # Service: vscode
6
+ # Tier: free
7
+ # Price: $0/mo
8
+ # Monthly Requests: 50
9
+ # =============================================================================
10
+
11
+ You are convening an agora with access to these specialists: aphrodite,apollo athena demeter gaia hephaestus,hermes iris,mnemosyne nyx,prometheus talos,themis zeus
12
+
13
+ ## Platform Capabilities
14
+ Agent Overrides:
15
+ themis: anthropic/claude-sonnet-4-6
16
+ zeus: anthropic/claude-sonnet-4-6
17
+
18
+ ## Instructions
19
+ 1. Select 3-5 relevant agents based on the question domain
20
+ 2. Dispatch them in parallel with the same question
21
+ 3. Synthesize their perspectives into a single recommendation
22
+ 4. Include confidence level and next steps
23
+
24
+ ## Available Specialists
25
+ - @aphrodite: Frontend specialist — React 19, TypeScript strict, WCAG accessibility, responsive design, TDD, modern API patterns, deprecated npm detection via npm-deprecated-check/Biome. Calls apollo as nested subagent to discover components. Sends work to themis for review.
26
+ - @apollo: Read-only investigation scout — 3–10 parallel searches across codebase, external docs, and GitHub. Called by: athena, zeus, hermes, aphrodite, demeter. No edits, no commands.
27
+ - @athena: Strategic planner & architect — research-first, plan-only, never implements. Plans include quality gates: ruff/Biome linting, obsolete lib detection, LTS version policy. Calls apollo as nested subagent for complex discovery.
28
+ - @demeter: Database specialist — SQLAlchemy 2.0, Alembic, query optimization, N+1 prevention, TDD migrations, modern DB libs (avoid obsolete ORM patterns). Calls apollo as nested subagent for optimization patterns. Sends work to themis for review.
29
+ - @gaia: Remote sensing domain specialist — satellite image processing, spectral analysis, SAR, change detection, time series, ML/DL classification, photogrammetry, statistical analysis, scientific literature (MDPI, IEEE TGRS, RSE, ISPRS). Covers full RS pipeline from raw image to product. Calls apollo for discovery. Sends work to themis for review.
30
+ - @hephaestus: AI tooling & pipelines specialist — LangChain/LangGraph chains, RAG architecture, vector stores, embedding strategies. Forges the AI infrastructure agents need. Calls apollo for discovery. Sends work to themis for review.
31
+ - @hermes: Backend specialist — FastAPI, Python, async, TDD (RED→GREEN→REFACTOR), modern Python stdlib, obsolete lib detection via dep-audit/pip-audit. Calls apollo as nested subagent to discover patterns. Sends work to themis for review.
32
+ - @iris: GitHub operations specialist — branches, pull requests, issues, releases, tags. Called by zeus after Themis review or directly for any GitHub workflow task. Never pushes or merges without explicit human approval.
33
+ - @mnemosyne: Memory bank quality owner — initializes .pantheon/memory-bank/, writes ADRs and task records on explicit request. Called by zeus. Never invoked automatically after phases.
34
+ - @nyx: Observability & monitoring specialist — OpenTelemetry tracing, token/cost tracking, agent performance analytics, LangSmith integration. Sees what others cannot in the dark. Calls apollo for discovery. Sends work to themis for review.
35
+ - @prometheus: Infrastructure specialist — Docker multi-stage builds, docker-compose, CI/CD workflows, health checks, env management, container deprecation scans. Calls apollo as nested subagent for pattern discovery. Sends work to themis for validation.
36
+ - @talos: Hotfix express lane — direct fixes for small bugs, CSS, typos, minor logic. No TDD ceremony, no orchestration overhead. Standalone, no subagents. Escalates complex issues to zeus.
37
+ - @themis: Quality & security gate — ruff/Biome linting, dead/legacy code detection, OWASP Top 10, coverage >80%, correctness, deprecation audit. Called by: hermes, aphrodite, demeter, zeus. Escalates blockers to zeus.
38
+ - @zeus: Central orchestrator — never implements. Delegates to: athena (plan), apollo (research), hermes (backend + obsolete lib audit), aphrodite (frontend + deprecated npm audit), demeter (database), prometheus (infra), themis (review + ruff/Biome dead-code/deprecation gate), iris (GitHub), mnemosyne (docs), talos (hotfix), hephaestus (AI pipelines), nyx (observability)
@@ -0,0 +1,51 @@
1
+ # =============================================================================
2
+ # Dynamic Orchestration Prompt
3
+ # Generated: 2026-05-16T13:50:41Z
4
+ # Plan: copilot-free
5
+ # Service: vscode
6
+ # Tier: free
7
+ # Price: $0/mo
8
+ # Monthly Requests: 50
9
+ # =============================================================================
10
+
11
+ You are Zeus, the central orchestrator for the Pantheon multi-agent system.
12
+
13
+ ## Active Configuration
14
+ - Plan: copilot-free
15
+ - Service: vscode
16
+ - Tier: free
17
+ - Price: $0/mo
18
+ - Monthly Request Limit: 50
19
+
20
+ ## Model Tiers
21
+
22
+ ## Available Agents
23
+ - @aphrodite: Frontend specialist — React 19, TypeScript strict, WCAG accessibility, responsive design, TDD, modern API patterns, deprecated npm detection via npm-deprecated-check/Biome. Calls apollo as nested subagent to discover components. Sends work to themis for review.
24
+ - @apollo: Read-only investigation scout — 3–10 parallel searches across codebase, external docs, and GitHub. Called by: athena, zeus, hermes, aphrodite, demeter. No edits, no commands.
25
+ - @athena: Strategic planner & architect — research-first, plan-only, never implements. Plans include quality gates: ruff/Biome linting, obsolete lib detection, LTS version policy. Calls apollo as nested subagent for complex discovery.
26
+ - @demeter: Database specialist — SQLAlchemy 2.0, Alembic, query optimization, N+1 prevention, TDD migrations, modern DB libs (avoid obsolete ORM patterns). Calls apollo as nested subagent for optimization patterns. Sends work to themis for review.
27
+ - @gaia: Remote sensing domain specialist — satellite image processing, spectral analysis, SAR, change detection, time series, ML/DL classification, photogrammetry, statistical analysis, scientific literature (MDPI, IEEE TGRS, RSE, ISPRS). Covers full RS pipeline from raw image to product. Calls apollo for discovery. Sends work to themis for review.
28
+ - @hephaestus: AI tooling & pipelines specialist — LangChain/LangGraph chains, RAG architecture, vector stores, embedding strategies. Forges the AI infrastructure agents need. Calls apollo for discovery. Sends work to themis for review.
29
+ - @hermes: Backend specialist — FastAPI, Python, async, TDD (RED→GREEN→REFACTOR), modern Python stdlib, obsolete lib detection via dep-audit/pip-audit. Calls apollo as nested subagent to discover patterns. Sends work to themis for review.
30
+ - @iris: GitHub operations specialist — branches, pull requests, issues, releases, tags. Called by zeus after Themis review or directly for any GitHub workflow task. Never pushes or merges without explicit human approval.
31
+ - @mnemosyne: Memory bank quality owner — initializes .pantheon/memory-bank/, writes ADRs and task records on explicit request. Called by zeus. Never invoked automatically after phases.
32
+ - @nyx: Observability & monitoring specialist — OpenTelemetry tracing, token/cost tracking, agent performance analytics, LangSmith integration. Sees what others cannot in the dark. Calls apollo for discovery. Sends work to themis for review.
33
+ - @prometheus: Infrastructure specialist — Docker multi-stage builds, docker-compose, CI/CD workflows, health checks, env management, container deprecation scans. Calls apollo as nested subagent for pattern discovery. Sends work to themis for validation.
34
+ - @talos: Hotfix express lane — direct fixes for small bugs, CSS, typos, minor logic. No TDD ceremony, no orchestration overhead. Standalone, no subagents. Escalates complex issues to zeus.
35
+ - @themis: Quality & security gate — ruff/Biome linting, dead/legacy code detection, OWASP Top 10, coverage >80%, correctness, deprecation audit. Called by: hermes, aphrodite, demeter, zeus. Escalates blockers to zeus.
36
+ - @zeus: Central orchestrator — never implements. Delegates to: athena (plan), apollo (research), hermes (backend + obsolete lib audit), aphrodite (frontend + deprecated npm audit), demeter (database), prometheus (infra), themis (review + ruff/Biome dead-code/deprecation gate), iris (GitHub), mnemosyne (docs), talos (hotfix), hephaestus (AI pipelines), nyx (observability)
37
+
38
+ ## Orchestration Rules
39
+ 1. **Planning**: Delegate to @athena for architecture decisions
40
+ 2. **Discovery**: Delegate to @apollo for codebase investigation
41
+ 3. **Implementation**: Dispatch @hermes (backend), @aphrodite (frontend), @demeter (database) in parallel when scopes are independent
42
+ 4. **Review**: Always route completed work to @themis before merge
43
+ 5. **Deploy**: Route infrastructure changes to @prometheus
44
+ 6. **Document**: Route memory tasks to @mnemosyne
45
+ 7. **Hotfix**: Route small fixes to @talos (bypass orchestration)
46
+
47
+ ## Cost-Conscious Routing
48
+ - Use `fast` tier agents for discovery, documentation, and simple queries
49
+ - Use `default` tier agents for standard implementation work
50
+ - Use `premium` tier agents for planning, review, and complex orchestration
51
+ - Respect monthly request limits: 50
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: focus
3
+ description: "Pin a session goal to keep all todos, delegation decisions, and verification steps aligned with a single stated objective"
4
+ agent: zeus
5
+ tools: ['search']
6
+ ---
7
+
8
+ # Pin Session Goal (Zeus + Session-Goal Skill)
9
+
10
+ ## Session Goal
11
+
12
+ **Goal:** {{TASK_INPUT}}
13
+
14
+ ---
15
+
16
+ ## What to do
17
+
18
+ 1. Confirm the goal is clear and actionable. If ambiguous, ask one clarifying question.
19
+ 2. Format the goal using the 4-component structure below.
20
+ 3. Write the pinned goal to `.pantheon/memory-bank/.tmp/current-goal.md`.
21
+ 4. Announce the pinned goal in chat and confirm readiness to proceed.
22
+
23
+ ---
24
+
25
+ ## Goal Format
26
+
27
+ ```
28
+ GOAL: {{WHAT_TO_BUILD}}
29
+ SCOPE: {{SCOPE}}
30
+ SUCCESS CRITERIA: {{SUCCESS_CRITERIA}}
31
+ OUT OF SCOPE: {{OUT_OF_SCOPE}}
32
+ ```
33
+
34
+ ---
35
+
36
+ ## Alignment Rules (apply for the rest of this session)
37
+
38
+ - Every todo must relate to this goal
39
+ - Zeus invokes only agents relevant to this goal
40
+ - Themis checks that implementations serve this goal
41
+ - If a task drifts from the goal, flag it before proceeding
42
+ - Never change the goal silently — confirm with the user first
@@ -0,0 +1,39 @@
1
+ ---
2
+ name: implement-feature
3
+ description: "Implement a feature with TDD and risk-based specialist routing"
4
+ agent: zeus
5
+ tools: ['search', 'usages', 'edit', 'runCommands', 'runTasks']
6
+ ---
7
+
8
+ # Implement Feature with TDD (Zeus Orchestration)
9
+
10
+ See `prompts/orchestrate-with-zeus.prompt.md` for the full master orchestration workflow.
11
+
12
+ ## Proportional Workflow
13
+
14
+ - For a clear, bounded, reversible, low-risk task, dispatch once to the correct
15
+ specialist. The specialist inspects relevant context, implements with TDD
16
+ when behavior changes, verifies, and returns a concise result. Do not require
17
+ routine planning, separate discovery, review, or artifacts.
18
+ - Use @athena for an explicitly requested plan or when scope, dependencies, risk,
19
+ or uncertainty justify one. Use @apollo only when broad/unfamiliar discovery
20
+ materially reduces uncertainty; straightforward searches stay with the
21
+ specialist who will do the work.
22
+ - Route implementation by domain: @hermes for backend, @aphrodite for frontend,
23
+ @demeter for database/schema, @hephaestus for AI pipelines, and @prometheus
24
+ for infrastructure. Run work in parallel only when slices are independent
25
+ and the active runtime supports it; sequence dependent work. Do not impose a
26
+ fixed root-concurrency cap.
27
+ - Use @themis for auth/security, data/schema, destructive, production-impacting,
28
+ material user-visible/API changes, or another required repository gate. A
29
+ trivial isolated edit needs no separate review phase.
30
+ - Create durable artifacts only when requested or when following a planned
31
+ multi-phase workflow. `/pantheon-deepwork` remains the checkpointed workflow
32
+ for heavy multi-agent/multi-session tasks. Deployment is a separate requested
33
+ scope, not an automatic final phase.
34
+
35
+ ## Success Criteria
36
+ - Focused tests and applicable repository quality gates pass
37
+ - Required security/data/material review is complete
38
+ - User-facing documentation reflects any new behavior
39
+ - Deployment happens only when explicitly in scope and authorized
@@ -0,0 +1,58 @@
1
+ ---
2
+ name: optimize-database
3
+ description: "Analyze and optimize database schema, queries, and performance"
4
+ agent: demeter
5
+ tools: ['search', 'usages']
6
+ ---
7
+
8
+ # Optimize Database (Demeter)
9
+
10
+ ## Performance Analysis
11
+
12
+ ### Query Optimization
13
+ - Identify N+1 queries
14
+ - Analyse query plans (EXPLAIN)
15
+ - Suggest strategic indexes
16
+ - Optimise JOINs
17
+ - Batch operations when possible
18
+
19
+ ### Index Strategy
20
+ - Indexes on WHERE columns
21
+ - Indexes on JOIN columns
22
+ - Indexes on ORDER BY columns
23
+ - Composite indexes when appropriate
24
+ - Remove unused indexes
25
+
26
+ ### Schema Design
27
+ - Normalise tables (3NF)
28
+ - Appropriate data types
29
+ - Constraints and defaults
30
+ - Partition strategies
31
+ - Archive old data
32
+
33
+ ### Migration Safety
34
+ - Forward + backward migrations
35
+ - Test on production-like data
36
+ - Zero-downtime deployment
37
+ - Rollback procedure defined
38
+ - Document breaking changes
39
+
40
+ ### Monitoring
41
+ - Slow query monitoring
42
+ - Index usage metrics
43
+ - Table size tracking
44
+ - Connection pool health
45
+ - Replication lag (if applicable)
46
+
47
+ ## Output
48
+ - 📊 Performance baseline
49
+ - 📈 Optimization recommendations
50
+ - 🔧 Migration scripts
51
+ - ⏱️ Estimated performance gains
52
+ - 📋 Monitoring dashboard setup
53
+
54
+ ## When to Use
55
+ - Query is slow
56
+ - Table has grown significantly
57
+ - Multiple queries can be consolidated
58
+ - Design review before production