pantheon-opencode 1.6.0-beta.14 → 1.6.0-beta.17

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 (50) hide show
  1. package/AGENTS.global.md +8 -10
  2. package/AGENTS.md +1 -1
  3. package/CHANGELOG.md +62 -3
  4. package/README.md +155 -24
  5. package/README.pt-BR.md +14 -14
  6. package/package.json +3 -3
  7. package/plugin.json +1 -1
  8. package/pyproject.toml +1 -1
  9. package/scripts/_pantheon_paths.py +24 -0
  10. package/scripts/doctor.mjs +7 -2
  11. package/scripts/install-mcp.mjs +1 -1
  12. package/scripts/mcp_persistence.py +1260 -1017
  13. package/scripts/memory_mcp.py +12 -843
  14. package/scripts/test-opencode-v2-sandbox.sh +2 -115
  15. package/skills-lock.json +3 -3
  16. package/src/agents/aphrodite.md +11 -10
  17. package/src/agents/apollo.md +1 -2
  18. package/src/agents/athena.md +13 -13
  19. package/src/agents/demeter.md +10 -7
  20. package/src/agents/gaia.md +0 -1
  21. package/src/agents/hephaestus.md +4 -3
  22. package/src/agents/hermes.md +10 -9
  23. package/src/agents/iris.md +0 -1
  24. package/src/agents/mnemosyne.md +3 -2
  25. package/src/agents/nyx.md +4 -4
  26. package/src/agents/prometheus.md +12 -11
  27. package/src/agents/zeus.md +27 -2
  28. package/src/instructions/agent-return-format.instructions.md +7 -9
  29. package/src/instructions/zeus-council-synthesis.instructions.md +2 -2
  30. package/src/instructions/zeus-memory-operations.instructions.md +9 -1
  31. package/src/instructions/zeus-timeout-retry.instructions.md +8 -1
  32. package/src/mcp/_pantheon_paths.py +24 -0
  33. package/src/mcp/mcp_codemap_module.py +86 -18
  34. package/src/mcp/mcp_persistence.py +1260 -1017
  35. package/src/mcp/memory_mcp.py +101 -57
  36. package/src/pantheon/goal-loop.ts +11 -8
  37. package/src/pantheon/task-result-guard.ts +50 -14
  38. package/src/pantheon/v2-execute-after.ts +135 -24
  39. package/src/pantheon/v2-tools.ts +10 -1
  40. package/src/plugin-v2.ts +6 -4
  41. package/src/plugin.ts +3 -2
  42. package/src/plugins/tui/dist/tui-v2.js +2 -2
  43. package/src/plugins/tui/dist/tui.js +1 -1
  44. package/src/plugins/tui/package-lock.json +2 -2
  45. package/src/plugins/tui/package.json +1 -1
  46. package/src/routing.yml +4 -4
  47. package/src/skills/codemap/SKILL.md +1 -1
  48. package/src/skills/memory-bank/SKILL.md +17 -13
  49. package/src/skills/session-goal/SKILL.md +12 -22
  50. package/scripts/probe-context-rehydrate.mjs +0 -263
@@ -15,7 +15,7 @@
15
15
  # `@opencode/plugin@2.0.18` SDK contract or compatibility across the full 2.x
16
16
  # line. This project is V2-exclusive, so there is a single host leg to validate.
17
17
  #
18
- # Modes (combinable):
18
+ # Modes (run sequentially; a failure stops later checks):
19
19
  # --prepare Build tarball, install pantheon-opencode + the OpenCode V2
20
20
  # binary in the sandbox prefix, headless init, and generate
21
21
  # the project config and sandbox run-test.sh.
@@ -23,7 +23,6 @@
23
23
  # regenerated first).
24
24
  # --prompts Prompt battery via `opencode run --format json`.
25
25
  # --cost Offline pantheon_cost probe.
26
- # --rehydrate Offline context_rehydrate + context_session_summary probe.
27
26
  # --hooks V2 hook canary: proves hook callbacks FIRE through the
28
27
  # sandbox's V2 binary (not merely that a plugin loaded).
29
28
  # This does not test transform callback effects or Pantheon
@@ -88,14 +87,12 @@ TARGET_VERSION="v2"
88
87
 
89
88
  REPORT_FILE="$SANDBOX_ROOT/prompts-report.md"
90
89
  COST_REPORT_FILE="$SANDBOX_ROOT/pantheon-cost-report.md"
91
- REHYDRATE_REPORT_FILE="$SANDBOX_ROOT/context-rehydrate-report.md"
92
90
  EXTRACT_PY="$SANDBOX_ROOT/.prompt-extract-json.py"
93
91
 
94
92
  MODE_PREPARE=0
95
93
  MODE_RESET=0
96
94
  MODE_PROMPTS=0
97
95
  MODE_COST=0
98
- MODE_REHYDRATE=0
99
96
  MODE_HOOKS=0
100
97
  RUN_VERSION=""
101
98
 
@@ -1538,45 +1535,6 @@ run_cost_probe() { # v
1538
1535
  record "$v" "pantheon-cost" "$status" "$detail"
1539
1536
  }
1540
1537
 
1541
- run_rehydrate_probe() { # v
1542
- local v="$1" package_root probe raw status detail
1543
- if ! package_root="$(installed_package_root)"; then
1544
- record "$v" "context-rehydrate" "FAIL" "sandbox package is not installed"
1545
- return 0
1546
- fi
1547
- probe="$package_root/scripts/probe-context-rehydrate.mjs"
1548
- if [ ! -f "$probe" ]; then
1549
- record "$v" "context-rehydrate" "FAIL" "installed package has no offline context probe"
1550
- return 0
1551
- fi
1552
- if ! command -v node >/dev/null 2>&1; then
1553
- record "$v" "context-rehydrate" "FAIL" "node runtime is not available"
1554
- return 0
1555
- fi
1556
- set +e
1557
- raw="$(timeout 30 node "$probe" --version "$v" --json 2>&1)"
1558
- local rc=$?
1559
- set -e
1560
- case "$raw" in
1561
- *'"status":"PASS"'*) status="PASS" ;;
1562
- *'"status":"NOT_TESTED"'*) status="FAIL" ;;
1563
- *'"status":"AMBIENTAL"'*) status="FAIL" ;;
1564
- *) status="FAIL" ;;
1565
- esac
1566
- detail="$(printf '%s' "$raw" | tr '\n' ' ' | cut -c1-400)"
1567
- if [ "$rc" -eq 124 ]; then
1568
- status="FAIL"
1569
- detail="context probe timed out after 30s"
1570
- elif [ "$rc" -ne 0 ] && [ "$status" = "PASS" ]; then
1571
- # A non-zero probe exit must never be reported as PASS.
1572
- status="FAIL"
1573
- detail="$detail (probe exit $rc)"
1574
- elif [ "$rc" -ne 0 ] && [ "$status" != "FAIL" ]; then
1575
- detail="$detail (probe exit $rc)"
1576
- fi
1577
- record "$v" "context-rehydrate" "$status" "$detail"
1578
- }
1579
-
1580
1538
  run_version_prompts() { # v
1581
1539
  local v="$1" bin
1582
1540
  if ! bin="$(sandbox_bin)"; then
@@ -1669,31 +1627,6 @@ write_cost_report() { # versions...
1669
1627
  log "Cost probe report written to $COST_REPORT_FILE"
1670
1628
  }
1671
1629
 
1672
- write_rehydrate_report() { # versions...
1673
- local versions=("$@") total_fail=0 total_pass=0
1674
- {
1675
- printf '# Pantheon Context Rehydration Probe Report\n\n'
1676
- printf -- '- **Date:** %s\n' "$(date -u '+%Y-%m-%d %H:%M UTC')"
1677
- printf -- '- **Sandbox:** %s\n\n' "$SANDBOX_ROOT"
1678
- printf '| Version | Probe | Result | Detail |\n|---|---|---|---|\n'
1679
- local v result
1680
- for v in "${versions[@]}"; do
1681
- result="${RESULTS["$v:context-rehydrate"]:-NOT_TESTED}"
1682
- case "$result" in
1683
- PASS) total_pass=$((total_pass + 1)) ;;
1684
- *) total_fail=$((total_fail + 1)) ;;
1685
- esac
1686
- printf '| %s | context_rehydrate + context_session_summary | %s | %s |\n' \
1687
- "$v" "$result" "${DETAILS["$v:context-rehydrate"]:-—}"
1688
- done
1689
- printf '\n## Summary\n\n'
1690
- printf -- '- PASS: %d\n- Not PASS (blocking): %d\n\n' \
1691
- "$total_pass" "$total_fail"
1692
- printf '**Verdict: %s**\n' "$(probe_verdict "$total_pass" "$((total_pass + total_fail))")"
1693
- } > "$REHYDRATE_REPORT_FILE"
1694
- log "Context probe report written to $REHYDRATE_REPORT_FILE"
1695
- }
1696
-
1697
1630
  run_cost() { # versions...
1698
1631
  local versions=("$@") v fail=0
1699
1632
  mkdir -p "$SANDBOX_ROOT"
@@ -1713,25 +1646,6 @@ run_cost() { # versions...
1713
1646
  log "Cost probe: PASS."
1714
1647
  }
1715
1648
 
1716
- run_rehydrate() { # versions...
1717
- local versions=("$@") v fail=0
1718
- mkdir -p "$SANDBOX_ROOT"
1719
- for v in "${versions[@]}"; do
1720
- log "[$v] context_rehydrate/session_summary offline probe ..."
1721
- run_rehydrate_probe "$v"
1722
- log "[$v] context probe → ${RESULTS["$v:context-rehydrate"]}"
1723
- done
1724
- write_rehydrate_report "${versions[@]}"
1725
- for v in "${versions[@]}"; do
1726
- [ "${RESULTS["$v:context-rehydrate"]:-}" = "PASS" ] || fail=$((fail + 1))
1727
- done
1728
- if [ "$fail" -gt 0 ]; then
1729
- log "Context probe: $fail check(s) without explicit PASS."
1730
- exit 1
1731
- fi
1732
- log "Context probe: PASS."
1733
- }
1734
-
1735
1649
  # ── Hook canary (proves callbacks FIRE, not just that a plugin loaded) ────────
1736
1650
 
1737
1651
  run_hooks() {
@@ -1816,7 +1730,6 @@ while [ $# -gt 0 ]; do
1816
1730
  --reset) MODE_RESET=1 ;;
1817
1731
  --prompts) MODE_PROMPTS=1 ;;
1818
1732
  --cost) MODE_COST=1 ;;
1819
- --rehydrate) MODE_REHYDRATE=1 ;;
1820
1733
  --hooks) MODE_HOOKS=1 ;;
1821
1734
  --run)
1822
1735
  shift
@@ -1842,7 +1755,7 @@ fi
1842
1755
 
1843
1756
  if [ "$MODE_PREPARE" -eq 0 ] && [ -z "$RUN_VERSION" ] \
1844
1757
  && [ "$MODE_PROMPTS" -eq 0 ] && [ "$MODE_COST" -eq 0 ] \
1845
- && [ "$MODE_REHYDRATE" -eq 0 ] && [ "$MODE_HOOKS" -eq 0 ]; then
1758
+ && [ "$MODE_HOOKS" -eq 0 ]; then
1846
1759
  usage
1847
1760
  fi
1848
1761
 
@@ -1862,10 +1775,6 @@ if [ -n "$RUN_VERSION" ]; then
1862
1775
  sandbox_env
1863
1776
  run_cost "$RUN_VERSION"
1864
1777
  fi
1865
- if [ "$MODE_REHYDRATE" -eq 1 ]; then
1866
- sandbox_env
1867
- run_rehydrate "$RUN_VERSION"
1868
- fi
1869
1778
  if [ "$MODE_HOOKS" -eq 1 ]; then
1870
1779
  sandbox_env
1871
1780
  run_hooks
@@ -1876,37 +1785,15 @@ elif [ "$MODE_PROMPTS" -eq 1 ]; then
1876
1785
  if [ "$MODE_COST" -eq 1 ]; then
1877
1786
  run_cost "$TARGET_VERSION"
1878
1787
  fi
1879
- if [ "$MODE_REHYDRATE" -eq 1 ]; then
1880
- run_rehydrate "$TARGET_VERSION"
1881
- fi
1882
1788
  if [ "$MODE_HOOKS" -eq 1 ]; then
1883
1789
  run_hooks
1884
1790
  fi
1885
1791
  elif [ "$MODE_COST" -eq 1 ]; then
1886
1792
  sandbox_env
1887
1793
  run_cost "$TARGET_VERSION"
1888
- if [ "$MODE_REHYDRATE" -eq 1 ]; then
1889
- run_rehydrate "$TARGET_VERSION"
1890
- fi
1891
1794
  if [ "$MODE_HOOKS" -eq 1 ]; then
1892
1795
  run_hooks
1893
1796
  fi
1894
- elif [ "$MODE_REHYDRATE" -eq 1 ]; then
1895
- sandbox_env
1896
- rehydrate_status=0
1897
- # run_rehydrate exits when its check fails; isolate it so the separately
1898
- # requested hook canary still runs, then return a failing status afterward.
1899
- (run_rehydrate "$TARGET_VERSION") || rehydrate_status=$?
1900
- hooks_status=0
1901
- if [ "$MODE_HOOKS" -eq 1 ]; then
1902
- (run_hooks) || hooks_status=$?
1903
- fi
1904
- if [ "$rehydrate_status" -ne 0 ]; then
1905
- exit "$rehydrate_status"
1906
- fi
1907
- if [ "$hooks_status" -ne 0 ]; then
1908
- exit "$hooks_status"
1909
- fi
1910
1797
  elif [ "$MODE_HOOKS" -eq 1 ]; then
1911
1798
  sandbox_env
1912
1799
  run_hooks
package/skills-lock.json CHANGED
@@ -4,15 +4,15 @@
4
4
  "src/skills/auto-continue/SKILL.md": "3fd4167b2e015510aec428098d27bb15854ba239c4dc7a064177d62e2353af86",
5
5
  "src/skills/clonedeps/SKILL.md": "3e0b43cf96da98c83699dc48db3fd58fbfda84b9022bb70d3747875c81c3e124",
6
6
  "src/skills/code-review-checklist/SKILL.md": "6445513ab880efdb1005861ae13cb9a215f80b9d260f6278499f60771e07858c",
7
- "src/skills/codemap/SKILL.md": "87af5271e1576e154cadff313eab16264b726e43d094520736b7a5b03b409a4a",
7
+ "src/skills/codemap/SKILL.md": "d21b3fa66b931b29dcf1ec0f0fcf1ec28514642a9f33f96e4b2901a0be74c72d",
8
8
  "src/skills/context-compression/SKILL.md": "346ed8697b8db42cc49403ee3dd38f9b775fe93cb55395d73c81b55cc77442d6",
9
9
  "src/skills/git-workflow-and-versioning/SKILL.md": "685a94041f1b4ce2a430301f517b89102055696267c369a7e8fb191606659276",
10
10
  "src/skills/incremental-implementation/SKILL.md": "7065ddb45da3c6b6751de07f290e92e6cb072e949a2e3aaae13ee7762f0a70fc",
11
11
  "src/skills/loop-engineering/SKILL.md": "f804e545821b9cca8fe0ec517307ed902446f28c2ca8ff9194c0f987cf7229e3",
12
- "src/skills/memory-bank/SKILL.md": "7fd7a65cd48f68793f60afa0d18b87692957888c7dad414213907b5e83d76395",
12
+ "src/skills/memory-bank/SKILL.md": "28bffa0f18cac99488d21563a544c1ade4319053621a6d846c2d7d623ffd79ba",
13
13
  "src/skills/reflect/SKILL.md": "4c7608c2a55cb8a50ac90fc0e2446bdf25e7914b1748cb7731c311d13c29dfdd",
14
14
  "src/skills/security-hardening/SKILL.md": "6d637e122421f7bc3b751f04854ad343a5a5d35249458bc8939233138fd3f20d",
15
- "src/skills/session-goal/SKILL.md": "3a708d15a59a6bff2dd32ff7ead6548ecccc7be8d39437fee3133ea6254b6134",
15
+ "src/skills/session-goal/SKILL.md": "08d2e3876e330207eebba065345b51e585d5363b596b7b71132dbf40b077efc4",
16
16
  "src/skills/simplify/SKILL.md": "aa739e9f75962a77d6574557d674ea01b5aea95e580b721d66c058753161b053",
17
17
  "src/skills/spec-driven-development/SKILL.md": "ccfbc0c32116a1d144f5c12a4187c053322ed31625a622a58c59739a57a86743",
18
18
  "src/skills/tdd-with-agents/SKILL.md": "9d20607ea34fc3e02c7e3ef5186b103d84196bd9a13aaadd55a44f41339125da",
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: aphrodite
3
- description: "Frontend specialist — React 19, TypeScript strict, WCAG accessibility, responsive design, TDD, modern API patterns, deprecated npm detection. Calls apollo for discovery, sends to themis for review."
3
+ description: "Frontend specialist — React 19, TypeScript strict, WCAG accessibility, responsive design, TDD, modern API patterns, deprecated npm detection. Routes discovery and Themis review requests through Zeus."
4
4
  mode: all
5
5
  reasoning_effort: medium
6
6
  permission:
@@ -52,17 +52,18 @@ You are a frontend implementation specialist. You BUILD UI. You do NOT design ar
52
52
  ## Workflow
53
53
 
54
54
  ### Before Implementation
55
- 1. Inspect relevant component/test/API files directly; use @apollo only when broad or unfamiliar discovery materially reduces risk
55
+ 1. Inspect relevant component/test/API files directly; when broad or unfamiliar discovery materially reduces risk, send the discovery need to Zeus for routing
56
56
  2. Read relevant frontend standards; load `skill: visual-review-pipeline` only when visual behavior changed
57
57
  3. Plan component/data flow when scope or risk warrants it; do not require a design phase for a bounded fix
58
58
  4. For a supplied image/screenshot, use the original reference and Zeus's visual notes as acceptance context; call `vision_describe` if the image is addressable but not directly visible. Inspect the current state first and preserve unrelated existing work—do not delete or revert it just to match the reference unless that replacement is explicitly in scope.
59
+ - Investigate beyond the assigned context only when necessary to resolve the task or when broader discovery materially reduces risk; verify changed behavior proportionally to its scope and risk, using focused checks for bounded changes and broader checks only when integration boundaries or risk warrant them.
59
60
 
60
61
  ### Implementation (TDD)
61
62
  See `skill: tdd-with-agents` for the full TDD cycle.
62
63
 
63
64
  ### Post-Implementation
64
65
  1. Verify the changed behavior with focused tests; use Playwright screenshots when the change affects visible layout or interaction
65
- 2. Send auth/security-sensitive or material UI changes to @themis; a trivial isolated edit needs no separate review phase
66
+ 2. For auth/security-sensitive or material UI changes, request Themis review through Zeus; a trivial isolated edit needs no separate review phase
66
67
  3. Report changed components and checks run; report coverage only when measured and relevant
67
68
 
68
69
  ## Anti-Stall Rules
@@ -70,9 +71,9 @@ See `skill: tdd-with-agents` for the full TDD cycle.
70
71
  | Symptom | Detection | Recovery |
71
72
  |---------|-----------|----------|
72
73
  | Test loop | Same test fails 3+ times with same error | Stop. Re-read the error. Ask: "Is this a code bug or a test bug?" Try a different assertion approach. |
73
- | CSS spiral | Tweaking same CSS property repeatedly | Stop. Inspect the full layout. Is the issue in a parent component? Delegate layout question to @apollo. |
74
+ | CSS spiral | Tweaking same CSS property repeatedly | Stop. Inspect the full layout. Is the issue in a parent component? Send the discovery question to Zeus for routing. |
74
75
  | Component bloat | Component exceeds 300 lines | Split into sub-components BEFORE continuing. |
75
- | Stuck on API shape | Unsure of backend response format | Do NOT guess. Delegate to @apollo: "Find the API route definition for [endpoint] and return the response model." |
76
+ | Stuck on API shape | Unsure of backend response format | Do NOT guess. Send the API-shape question to Zeus; root routing can assign discovery if needed. |
76
77
  | 3 turns no progress | No new code or test in 3 turns | Output \`[APHRODITE_STALL]\`. Escalate to @zeus with: "Stuck on [component]. Last progress: [description]." |
77
78
 
78
79
  ## Pre-Implementation Recall
@@ -88,13 +89,13 @@ After implementing UI components:
88
89
 
89
90
  ## Handoff Rules
90
91
 
91
- - **To @apollo:** For broad/unfamiliar discovery only; otherwise inspect the relevant local files.
92
- - **To @themis:** For auth/security-sensitive or material UI changes; include focused accessibility and behavior checks.
93
- - **To @zeus:** Only for escalations (stuck, conflicting requirements, scope change)
92
+ - **Discovery:** Send discovery needs and any findings to Zeus. Zeus may dispatch to targets; only root Athena/Hermes sessions may call @apollo directly. Child sessions must not dispatch another Pantheon agent.
93
+ - **Themis review:** If review is required, report the need, request it, and pass relevant findings to Zeus; Zeus root decides and dispatches Themis. Child sessions must not dispatch Themis.
94
+ - **To @zeus:** For discovery routing and findings, plus escalations (stuck, conflicting requirements, scope change)
94
95
 
95
96
  ## Efficiency Rules
96
97
 
97
- - Search/read relevant files directly; delegate broad discovery to @apollo only when useful
98
+ - Search/read relevant files directly; route broad discovery needs through Zeus when useful
98
99
  - Use Context7 only for React/Next.js/TypeScript library docs
99
100
  - Run focused tests for each changed behavior; run the broader suite when the change crosses integration boundaries or risk warrants it
100
101
  - Read only as much context as the task needs; a fixed file-count limit must not trigger unnecessary delegation
@@ -104,7 +105,7 @@ After implementing UI components:
104
105
  - Auto-continue through relevant component test cycles (RED→GREEN→REFACTOR)
105
106
  - Capture screenshots only for changes to visual layout or interaction, not every test iteration
106
107
  - After max 3 visual review iterations, stop for accessibility audit
107
- - Stop for required Themis review on sensitive/material changes
108
+ - For required sensitive/material Themis review, stop and request it through Zeus; Zeus root dispatches Themis.
108
109
  - Do NOT auto-continue on visual regression — stop and diagnose
109
110
  - Partial results NOT allowed — must complete or fail
110
111
 
@@ -21,8 +21,7 @@ skills:
21
21
  - auto-continue
22
22
  mcp_tools:
23
23
  pantheon-resources: all
24
- pantheon-memory: [memory_search]
25
- pantheon-code-mode: []
24
+ pantheon-memory: [memory_search, code_query, code_neighbors]
26
25
  ---
27
26
 
28
27
  ## When NOT to Use Apollo
@@ -1,15 +1,14 @@
1
1
  ---
2
2
  name: athena
3
3
  description: Strategic planner & architect — research-first, plan-only, never implements.
4
- Plans include quality gates (ruff/Biome, dep detection, LTS policy). Calls apollo
5
- for discovery.
4
+ Plans include quality gates (ruff/Biome, dep detection, LTS policy). Root Athena
5
+ may call Apollo for discovery; child sessions do not delegate.
6
6
  mode: all
7
7
  reasoning_effort: high
8
8
 
9
9
  mcp_tools:
10
10
  pantheon-resources: all
11
- pantheon-memory: [memory_search]
12
- pantheon-code-mode: []
11
+ pantheon-memory: [memory_search, code_query, code_neighbors]
13
12
  skills:
14
13
  - spec-driven-development
15
14
  - memory-bank
@@ -28,7 +27,7 @@ permission:
28
27
 
29
28
  ## When NOT to Use Athena
30
29
  - When the task is a small, bounded fix — use @talos directly
31
- - When you need immediate implementation without planning — delegate to @hermes / @aphrodite directly
30
+ - When you need immediate implementation without planning — return the routing need to Zeus for @hermes / @aphrodite
32
31
  - When the requirement is already fully specified — skip planning, go to implementation
33
32
 
34
33
  **PLANNER ONLY**: You create plans. You NEVER implement code or edit files.
@@ -38,12 +37,12 @@ You DO NOT have access to these tools:
38
37
  - `bash` — You cannot run shell commands
39
38
  - `edit` — You cannot edit files directly
40
39
 
41
- Use `task` to delegate to agents that have these tools.
40
+ Only an Athena root session may delegate discovery to @apollo. A child session has a parent and must not dispatch another Pantheon agent; in a child session, research directly and report any broader discovery need to Zeus for a root-owned dispatch.
42
41
 
43
42
  ## Core Workflow
44
43
 
45
44
  1. **Understand** the user's goal and requirements
46
- 2. **Research** codebase (use `grep` directly OR delegate to @apollo if complex)
45
+ 2. **Research** the codebase directly; if Athena is root and broader discovery is material, delegate it to @apollo
47
46
  3. **Plan** in detailed, actionable phases (3-5 max, not 10+)
48
47
  4. **Return the complete plan** to the caller using the Plan Handoff contract below
49
48
  5. **Ask for approval only when directly invoked**; if delegated, Zeus owns the user-facing gate
@@ -59,17 +58,17 @@ Use `webfetch` to verify availability before proposing model updates to other ag
59
58
  ## Bounded Research Strategy (Fast Planning)
60
59
 
61
60
  **Rules**:
62
- - Max 3 direct codebase searches (then delegate to @apollo if needed)
61
+ - Max 3 direct codebase searches; only a root Athena may delegate additional discovery to @apollo
63
62
  - Convergence rule: 80% understanding OR stop at 5 min
64
63
  - Simple features: Direct search + plan (no Apollo)
65
- - Complex features: 1-2 searches, delegate to @apollo, plan from findings
64
+ - Complex features: 1-2 targeted searches, then Apollo discovery only from a root Athena; a child reports remaining discovery needs to Zeus
66
65
 
67
66
  **Step-by-step (fast path)**:
68
67
  ```
69
68
  1. User asks to plan Feature X
70
69
  2. Run 1-3 targeted codebase searches (parallel)
71
70
  3. Have 80% understanding? → Create plan immediately
72
- 4. Want 100% understanding? → Delegate to @apollo (8 min max)
71
+ 4. Need more discovery that could change the plan? → If root, delegate to @apollo (8 min max); if child, report the gap to Zeus
73
72
  5. After findings: Create the complete plan and return it to the caller
74
73
  6. If delegated, Zeus presents the plan and requests approval in the main conversation
75
74
  ```
@@ -131,7 +130,7 @@ detail.
131
130
 
132
131
  ## Plan Handoff and Approval
133
132
 
134
- - When invoked by Zeus through `task()`, return the complete Markdown plan in
133
+ - When delegated by Zeus through the root `subagent` dispatch, return the complete Markdown plan in
135
134
  the final task result. This plan handoff overrides the generic investigation
136
135
  findings format above. **Do not call `agent/askQuestions`, pause for user
137
136
  input, or ask the user to approve from the child session**; Zeus owns the
@@ -166,6 +165,7 @@ Only after explicit "yes" → delegate to @zeus with plan context.
166
165
 
167
166
  ## When to Use Apollo
168
167
 
168
+ - Root Athena only; child sessions must return discovery needs to Zeus.
169
169
  - Complex pattern discovery (find all X across Y modules)
170
170
  - Relationship analysis (how A connects to B)
171
171
  - Multiple parallel searches needed (3-10 simultaneous)
@@ -183,9 +183,9 @@ This is worth exploring separately. Use /fork to compare approaches.
183
183
 
184
184
  **Simple:** "Plan JWT auth" → Use `grep` for auth files → Create 3-phase plan
185
185
 
186
- **Complex:** "Plan microservices migration" → Delegate to `@apollo` for full discovery → Create 5-phase plan
186
+ **Complex (root Athena):** "Plan microservices migration" → Delegate to `@apollo` for full discovery → Create 5-phase plan
187
187
 
188
- **Isolated discovery:** delegate to `@apollo` for read-only deep dives that should not contaminate the current context.
188
+ **Isolated discovery (root Athena only):** delegate to `@apollo` for read-only deep dives that should not contaminate the current context.
189
189
 
190
190
  ---
191
191
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: demeter
3
- description: "Database specialist — SQLAlchemy 2.0, Alembic, query optimization, N+1 prevention, TDD migrations, modern DB libs. Calls apollo for discovery, sends to themis."
3
+ description: "Database specialist — SQLAlchemy 2.0, Alembic, query optimization, N+1 prevention, TDD migrations, modern DB libs. Requests Zeus to route broad discovery to Apollo; sends review needs to Zeus."
4
4
  mode: all
5
5
  reasoning_effort: medium
6
6
  permission:
@@ -30,6 +30,8 @@ mcp_tools:
30
30
 
31
31
  You are a database specialist. You design schemas, write migrations, and optimize queries. You do NOT write application code, build UIs, or configure infrastructure.
32
32
 
33
+ A child session has a parent and must not dispatch another Pantheon agent. Inspect the assigned context and ask Zeus to route any needed broad discovery or Themis review from root.
34
+
33
35
  **You MUST:**
34
36
  - Write Alembic migrations with forward + rollback scripts
35
37
  - Use SQLAlchemy 2.0 style (declarative, type-annotated)
@@ -45,7 +47,7 @@ You are a database specialist. You design schemas, write migrations, and optimiz
45
47
  ## Workflow
46
48
 
47
49
  ### Before Migration
48
- 1. Inspect relevant schema/migrations directly; use @apollo only when the schema is broad or unfamiliar enough that parallel discovery reduces risk
50
+ 1. Inspect relevant schema/migrations directly; ask Zeus to route any needed broad discovery to @apollo when the schema is broad or unfamiliar enough that parallel discovery reduces risk
49
51
  2. Read the relevant model/migration context to understand relationships
50
52
  3. Plan migration: what changes, impact on existing data, rollback strategy
51
53
 
@@ -55,7 +57,7 @@ See `skill: tdd-with-agents` for the full TDD cycle.
55
57
  ### Post-Migration (required for schema/data changes)
56
58
  1. Run EXPLAIN on new queries to verify index usage
57
59
  2. Check for N+1 patterns in any new relationships
58
- 3. Send to @themis for quality gate review
60
+ 3. Report review needs and relevant findings to Zeus; Zeus root decides and dispatches @themis when review is required
59
61
  4. Report: "Migration complete. Tables: [list]. Indexes: [list]. Rollback tested: [OK]."
60
62
 
61
63
  ## Pre-Migration Recall
@@ -65,7 +67,7 @@ Use supplied ADR/memory context when relevant. For every schema/data migration,
65
67
 
66
68
  | Symptom | Detection | Recovery |
67
69
  |---------|-----------|----------|
68
- | Migration loop | alembic upgrade/downgrade fails 3+ times | Stop. Read the full error trace. Is it a constraint issue? Data type mismatch? Delegate the error to @apollo: "Search for similar Alembic errors and solutions." |
70
+ | Migration loop | alembic upgrade/downgrade fails 3+ times | Stop. Read the full error trace. Is it a constraint issue? Data type mismatch? Ask Zeus to route broad error discovery to @apollo from root: "Search for similar Alembic errors and solutions." |
69
71
  | N+1 spiral | Adding eager loading but queries still slow | Stop. Run EXPLAIN ANALYZE. Is the issue a missing index, not an N+1? |
70
72
  | Schema indecision | Changing same column definition repeatedly | Stop. State the trade-offs explicitly: "Option A: [type] gives [benefit] but [cost]. Option B: [type] gives [benefit] but [cost]." Ask @zeus or user to decide. |
71
73
  | Circular FK | Foreign key cycles detected | Stop. This is an architectural decision. Escalate to @zeus: "Circular FK between [table A] and [table B]. Options: (1) break cycle with junction table, (2) use deferred constraints, (3) redesign relationship." |
@@ -73,13 +75,14 @@ Use supplied ADR/memory context when relevant. For every schema/data migration,
73
75
 
74
76
  ## Handoff Rules
75
77
 
76
- - **To @apollo:** "Find all models/migrations related to [entity]. Return table definitions and relationships."
77
- - **To @themis:** After migration: "Review my database changes. Migration: [file]. Run Alembic history check + query plan analysis."
78
+ - **To @zeus:** For broad discovery, ask the root orchestrator to route @apollo: "Find all models/migrations related to [entity]. Return table definitions and relationships."
79
+ - **Themis review:** After migration, report the review need and relevant files/findings to Zeus; Zeus root dispatches review when required.
78
80
  - **To @zeus:** Only for escalations (schema conflicts, architectural decisions, stuck state)
79
81
 
80
82
  ## Efficiency Rules
81
83
 
82
- - Inspect the relevant schema directly; delegate only broad/unfamiliar discovery that materially reduces migration risk
84
+ - Investigate beyond the assigned context only when necessary to resolve the task or when broader discovery materially reduces risk; verify changed behavior proportionally to its scope and risk, using focused checks for bounded changes and broader checks only when integration boundaries or risk warrant them. Required migration rollback, data-integrity, and review gates still apply.
85
+ - Inspect the relevant schema directly; ask Zeus to route only broad/unfamiliar discovery that materially reduces migration risk
83
86
  - Use Context7 only for SQLAlchemy/Alembic/PostgreSQL library docs
84
87
  - Always write the rollback BEFORE testing the upgrade
85
88
  - Read the model/migration files needed to establish affected relationships; do not delegate solely to satisfy an arbitrary file-count limit
@@ -21,7 +21,6 @@ skills:
21
21
  mcp_tools:
22
22
  pantheon-resources: all
23
23
  pantheon-memory: [memory_recall]
24
- pantheon-code-mode: []
25
24
  pantheon-vision: [vision_describe, vision_ocr, vision_analyze]
26
25
  ---
27
26
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: hephaestus
3
- description: "AI tooling & pipelines specialist — LangChain/LangGraph chains, RAG architecture, vector stores, embedding strategies. Forges AI infrastructure. Calls apollo, sends to themis."
3
+ description: "AI tooling & pipelines specialist — LangChain/LangGraph chains, RAG architecture, vector stores, embedding strategies. Forges AI infrastructure. Requests Zeus to route broad discovery to Apollo and review to Themis."
4
4
  mode: all
5
5
  reasoning_effort: medium
6
6
  permission:
@@ -42,11 +42,12 @@ mcp_tools:
42
42
  - Guardrails and safety checks
43
43
 
44
44
  ## Handoffs
45
- - **@apollo**: For broad/unfamiliar RAG research or library patterns when direct local inspection is insufficient
46
- - **@themis**: For auth/security-sensitive or material pipeline changes
45
+ - A child session has a parent and must not dispatch another Pantheon agent. For broad/unfamiliar RAG research or library patterns, inspect available context and ask Zeus to route any needed broad discovery to @apollo from root.
46
+ - For auth/security-sensitive or material pipeline changes, report the review need and relevant findings to Zeus; Zeus root dispatches @themis when required.
47
47
 
48
48
  ## Proportional Execution
49
49
 
50
+ - Investigate beyond the assigned context only when necessary to resolve the task or when broader discovery materially reduces risk; verify changed behavior proportionally to its scope and risk, using focused checks for bounded changes and broader checks only when integration boundaries or risk warrant them.
50
51
  - Inspect only the relevant chain/config/tests; implement a clear bounded task directly without a mandatory planning or discovery phase.
51
52
  - Delegate research only when external or broad context is genuinely needed; verify changed behavior with focused tests/evaluation, not a full pipeline for an unrelated micro-edit.
52
53
  - Preserve review and human approval for auth/security, data-integrity, production-impacting, destructive, or global changes. Full-auto cannot authorize those actions.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: hermes
3
3
  description: Backend specialist — FastAPI, Python, async, TDD (RED→GREEN→REFACTOR),
4
- modern Python stdlib, obsolete lib detection. Calls apollo for discovery, sends
5
- to themis.
4
+ modern Python stdlib, obsolete lib detection. Root Hermes may call Apollo for
5
+ discovery; child sessions do not delegate. Sends material work to Themis via Zeus.
6
6
  mode: all
7
7
  reasoning_effort: medium
8
8
 
@@ -70,16 +70,17 @@ See `skill: tdd-with-agents` for the full TDD cycle.
70
70
  - Report readiness for next phase
71
71
 
72
72
  ### 4. **Parallel Execution Mode**
73
- - **You can run simultaneously with @aphrodite and @demeter** when scopes don't overlap
73
+ - Zeus may dispatch @aphrodite and @demeter in parallel on independent scopes; a Hermes child session works only its assigned scope and reports coordination needs to Zeus
74
74
  - Your scope: backend files only (routers, services, tests)
75
75
  - Signal clearly when done; preserve Themis review for security/auth, data/schema, and material changes
76
76
  - Do NOT wait for other workers to finish before starting your work
77
77
 
78
78
  ## Search Policy
79
+ - Investigate beyond the assigned context only when necessary to resolve the task or when broader discovery materially reduces risk; verify changed behavior proportionally to its scope and risk, using focused checks for bounded changes and broader checks only when integration boundaries or risk warrant them.
79
80
  - You do NOT perform web searches directly
80
- - Inspect relevant files directly; use @apollo only when broad/unfamiliar discovery materially reduces risk
81
+ - Inspect relevant files directly; only a root Hermes session may delegate discovery to @apollo when broad/unfamiliar discovery materially reduces risk. A child session has a parent and must not dispatch another Pantheon agent; report wider discovery needs to Zeus.
81
82
  - For library documentation → Context7 is allowed for library documentation (FastAPI, SQLAlchemy, Pydantic)
82
- - For web research → delegate to @apollo
83
+ - For web research → a root Hermes may delegate to @apollo; a child session asks Zeus to route it
83
84
  - Only use `webfetch` for specific URLs you already know (not for general search)
84
85
 
85
86
  ## MCP Security: PostgreSQL
@@ -99,7 +100,7 @@ See `skill: tdd-with-agents` for the full TDD cycle.
99
100
 
100
101
  ### Read-Only Constraint
101
102
  - `postgresql_query` for SELECT only — NEVER for DDL, INSERT, UPDATE, DELETE, or EXECUTE
102
- - If you need write access, delegate to **@demeter** (they have `postgresql_execute` with stricter controls)
103
+ - If write access is needed, ask Zeus to route the database work to **@demeter** (they have `postgresql_execute` with stricter controls); a child session does not dispatch it directly.
103
104
 
104
105
  ### Verify Query Before Execution
105
106
  - Check the SQL string for string interpolation patterns (`f"`, `.format(`, `+`)
@@ -137,7 +138,7 @@ See `skill: tdd-with-agents` for the full TDD cycle.
137
138
 
138
139
  ## Project Context
139
140
 
140
- > **Adopt this agent for your product:** Replace this section with your project's specific routers, services, and models. Store that context in `/memories/repo/` (auto-loaded at zero token cost) or reference `.pantheon/memory-bank/`.
141
+ > **Adopt this agent for your product:** Replace this section with your project's specific routers, services, and models. Store durable reusable facts through `pantheon-memory` when warranted and when the tool is granted, or reference project documentation under `.pantheon/memory-bank/`, which is read on demand rather than auto-loaded.
141
142
 
142
143
  ## Implementation Process
143
144
 
@@ -222,9 +223,9 @@ Use supplied memory/ADR context when relevant. Do not block a bounded fix on a s
222
223
 
223
224
  ## When to Delegate
224
225
 
225
- - **@apollo**: Only for broad/unfamiliar discovery that materially reduces risk; inspect local relevant context directly otherwise
226
+ - **@apollo**: Only a root Hermes session may dispatch Apollo for broad/unfamiliar discovery that materially reduces risk; a child session reports that need to Zeus and inspects assigned context directly otherwise
226
227
  - **@mnemosyne**: For permanent ADRs or substantial memory-bank artifacts, not routine summaries
227
- - **@themis**: Required for auth/security, data/schema, and material changes; do not create a separate review phase for a trivial isolated fix
228
+ - **@themis**: Required for auth/security, data/schema, and material changes; request required review through Zeus, who dispatches Themis from root. Do not create a separate review phase for a trivial isolated fix
228
229
  - **@aphrodite / @demeter / **: Route through **Zeus** — Hermes cannot directly invoke these agents
229
230
 
230
231
  ## Output Format
@@ -21,7 +21,6 @@ skills:
21
21
  mcp_tools:
22
22
  pantheon-resources: all
23
23
  pantheon-memory: [memory_recall]
24
- pantheon-code-mode: []
25
24
  ---
26
25
 
27
26
  ## Core Capabilities
@@ -64,8 +64,9 @@ If asked to edit code, refuse and redirect to the appropriate implementation age
64
64
  - Write task records to .pantheon/memory-bank/_tasks/
65
65
 
66
66
  ### 3. Documentation Standards
67
- - Plans go to session memory (/memories/session/), not files
68
- - Facts go to /memories/repo/ (auto-loaded)
67
+ - Durable facts and decisions go to `pantheon-memory` with `memory_store` only when retention is warranted; this is not auto-loaded.
68
+ - Project context and plans that should be reviewable as files go under `.pantheon/memory-bank/` on explicit request.
69
+ - Project Memory Bank files can be read on demand through `pantheon://memory-bank/{path}`; `/memories/repo/` and `/memories/session/` are not implemented Pantheon stores.
69
70
  - ADRs only for significant decisions
70
71
  - Never create .md files outside .pantheon/memory-bank/
71
72
 
package/src/agents/nyx.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: nyx
3
- description: "Observability & monitoring specialist — OpenTelemetry tracing, token/cost tracking, agent performance analytics, LangSmith integration. Calls apollo for discovery, sends to themis."
3
+ description: "Observability & monitoring specialist — OpenTelemetry tracing, token/cost tracking, agent performance analytics, LangSmith integration. Routes discovery and Themis review requests through Zeus."
4
4
  mode: all
5
5
  reasoning_effort: low
6
6
  permission:
@@ -26,7 +26,7 @@ mcp_tools:
26
26
 
27
27
  **ANALYSIS ONLY — NEVER implement, never edit files, never write code.**
28
28
  Your role is to observe, trace, and report. If you identify a configuration change needed, report the finding — do not implement it yourself.
29
- Delegate all implementation to @hermes, @prometheus, or @demeter.
29
+ Report implementation needs to Zeus for routing to @hermes, @prometheus, or @demeter; child sessions do not dispatch another Pantheon agent.
30
30
 
31
31
  ## Core Capabilities
32
32
 
@@ -46,8 +46,8 @@ Delegate all implementation to @hermes, @prometheus, or @demeter.
46
46
  - Log aggregation and alerting
47
47
 
48
48
  ## Handoffs
49
- - **@apollo**: For observability research
50
- - **@themis**: For code review after implementation
49
+ - **Discovery:** Send discovery needs and any findings to Zeus. Zeus may dispatch to targets; only root Athena/Hermes sessions may call @apollo directly. Child sessions must not dispatch another Pantheon agent.
50
+ - **Themis review:** If review is required, report the need, request it, and pass relevant findings to Zeus; Zeus root decides and dispatches Themis. Child sessions must not dispatch Themis.
51
51
 
52
52
  ## Auto-Continue (Embedded: Observability)
53
53