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.
- package/AGENTS.global.md +8 -10
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +62 -3
- package/README.md +155 -24
- package/README.pt-BR.md +14 -14
- package/package.json +3 -3
- package/plugin.json +1 -1
- package/pyproject.toml +1 -1
- package/scripts/_pantheon_paths.py +24 -0
- package/scripts/doctor.mjs +7 -2
- package/scripts/install-mcp.mjs +1 -1
- package/scripts/mcp_persistence.py +1260 -1017
- package/scripts/memory_mcp.py +12 -843
- package/scripts/test-opencode-v2-sandbox.sh +2 -115
- package/skills-lock.json +3 -3
- package/src/agents/aphrodite.md +11 -10
- package/src/agents/apollo.md +1 -2
- package/src/agents/athena.md +13 -13
- package/src/agents/demeter.md +10 -7
- package/src/agents/gaia.md +0 -1
- package/src/agents/hephaestus.md +4 -3
- package/src/agents/hermes.md +10 -9
- package/src/agents/iris.md +0 -1
- package/src/agents/mnemosyne.md +3 -2
- package/src/agents/nyx.md +4 -4
- package/src/agents/prometheus.md +12 -11
- package/src/agents/zeus.md +27 -2
- package/src/instructions/agent-return-format.instructions.md +7 -9
- package/src/instructions/zeus-council-synthesis.instructions.md +2 -2
- package/src/instructions/zeus-memory-operations.instructions.md +9 -1
- package/src/instructions/zeus-timeout-retry.instructions.md +8 -1
- package/src/mcp/_pantheon_paths.py +24 -0
- package/src/mcp/mcp_codemap_module.py +86 -18
- package/src/mcp/mcp_persistence.py +1260 -1017
- package/src/mcp/memory_mcp.py +101 -57
- package/src/pantheon/goal-loop.ts +11 -8
- package/src/pantheon/task-result-guard.ts +50 -14
- package/src/pantheon/v2-execute-after.ts +135 -24
- package/src/pantheon/v2-tools.ts +10 -1
- package/src/plugin-v2.ts +6 -4
- package/src/plugin.ts +3 -2
- package/src/plugins/tui/dist/tui-v2.js +2 -2
- package/src/plugins/tui/dist/tui.js +1 -1
- package/src/plugins/tui/package-lock.json +2 -2
- package/src/plugins/tui/package.json +1 -1
- package/src/routing.yml +4 -4
- package/src/skills/codemap/SKILL.md +1 -1
- package/src/skills/memory-bank/SKILL.md +17 -13
- package/src/skills/session-goal/SKILL.md +12 -22
- 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 (
|
|
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
|
-
&& [ "$
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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",
|
package/src/agents/aphrodite.md
CHANGED
|
@@ -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.
|
|
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;
|
|
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.
|
|
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?
|
|
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.
|
|
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
|
-
- **
|
|
92
|
-
- **
|
|
93
|
-
- **To @zeus:**
|
|
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;
|
|
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
|
-
-
|
|
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
|
|
package/src/agents/apollo.md
CHANGED
package/src/agents/athena.md
CHANGED
|
@@ -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).
|
|
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 —
|
|
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
|
-
|
|
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
|
|
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
|
|
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,
|
|
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.
|
|
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
|
|
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
|
|
package/src/agents/demeter.md
CHANGED
|
@@ -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.
|
|
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;
|
|
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.
|
|
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?
|
|
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 @
|
|
77
|
-
- **
|
|
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
|
-
-
|
|
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
|
package/src/agents/gaia.md
CHANGED
package/src/agents/hephaestus.md
CHANGED
|
@@ -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.
|
|
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
|
-
-
|
|
46
|
-
-
|
|
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.
|
package/src/agents/hermes.md
CHANGED
|
@@ -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.
|
|
5
|
-
to
|
|
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
|
-
-
|
|
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;
|
|
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
|
|
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
|
|
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;
|
|
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;
|
|
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
|
package/src/agents/iris.md
CHANGED
package/src/agents/mnemosyne.md
CHANGED
|
@@ -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
|
-
-
|
|
68
|
-
-
|
|
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.
|
|
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
|
-
|
|
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
|
-
-
|
|
50
|
-
-
|
|
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
|
|