pantheon-opencode 1.0.7 → 1.1.1-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/AGENTS.md +1 -1
  2. package/README.md +98 -318
  3. package/bin/pantheon-init.mjs +1 -1
  4. package/opencode.json +13 -5
  5. package/package.json +2 -2
  6. package/scripts/install/opencode.mjs +10 -2
  7. package/scripts/install/venv.mjs +24 -8
  8. package/scripts/validate-routing.mjs +1 -1
  9. package/src/agents/README.md +26 -0
  10. package/src/instructions/agent-return-format.instructions.md +45 -0
  11. package/src/instructions/memory-protocol.instructions.md +52 -0
  12. package/src/instructions/zeus-council-synthesis.instructions.md +245 -26
  13. package/src/plugin.ts +38 -0
  14. package/src/routing.yml +254 -295
  15. package/src/skills/README.md +88 -164
package/src/skills/README.md CHANGED
@@ -4,177 +4,110 @@
4
4
 
5
5
  Skills are reference modules loaded on demand by agents. Each skill provides domain-specific knowledge — architecture patterns, security checklists, optimization strategies, and implementation guides. Agents load skills when their task matches the skill's description, keeping context focused and token-efficient.
6
6
 
7
- There are **37 skills** divided into **9 domains**.
7
+ There are **21 skills** divided into **5 domains**.
8
8
 
9
9
  ## Skills by Domain
10
10
 
11
11
  ### Domain 1: Orchestration & Workflow
12
12
 
13
- 1. **agent-coordination** — `skills/agent-coordination/SKILL.md`
14
- - Master guide to the multi-agent system with category routing, model selection, and sprint management for rapid, TDD-driven feature development.
15
- - Used by: Zeus, Athena
13
+ 1. **agent-coordination** — `agent-coordination/SKILL.md`
14
+ - Multi-agent orchestration with model routing, category delegation, and sprint management.
15
+ - Used by: Zeus
16
16
 
17
- 2. **artifact-management** — `skills/artifact-management/SKILL.md`
18
- - Complete guide to the artifact trail system — plans directory structure, templates, and best practices for documenting feature implementations.
19
- - Used by: Zeus, Mnemosyne
20
-
21
- 3. **memory-bank** — `skills/memory-bank/SKILL.md`
22
- - Complete guide to Pantheon memory bank — structure, rules, optimization, session→active-context graduation, and compression strategies.
23
- - Used by: Mnemosyne, All agents
24
-
25
- - Audit a repository for token waste — find redundant context files, measure baseline, and recommend optimizations.
26
- - Used by: Mnemosyne, Zeus
27
-
28
- - Load prompts from external files with path expansion so prompt content stays version-controlled and reusable.
29
- - Used by: All agents
30
-
31
- ### Domain 2: AI & Machine Learning
17
+ 2. **artifact-management** — `artifact-management/SKILL.md`
18
+ - Structured artifact trail for feature implementations — plans, implementations, reviews, and decisions.
19
+ - Used by: Zeus, Mnemosyne, Iris
32
20
 
33
- 4. **rag-pipelines** — `skills/rag-pipelines/SKILL.md`
34
- - RAG architecture, chunking strategies, embedding models, vector store selection, retrieval optimization, context window management, hallucination mitigation, and evaluation frameworks (faithfulness, answer relevance).
35
- - Used by: Hephaestus
21
+ 3. **auto-continue** — `auto-continue/SKILL.md`
22
+ - Auto-continue through todos with idle detection and safety gates for multi-step orchestration.
23
+ - Used by: Zeus, Apollo, Hephaestus, Nyx, Gaia
36
24
 
37
- 5. **streaming-patterns** — `skills/streaming-patterns/SKILL.md`
38
- - Server-Sent Events (SSE), WebSocket connections, LLM token streaming, chunked transfer encoding, backpressure handling, reconnection strategies, and real-time update patterns for observability pipelines.
39
- - Used by: Nyx
25
+ 4. **context-compression** — `context-compression/SKILL.md`
26
+ - Level 2 — Pantheon-native context compression with priority scoring, semantic summarization, budget allocation, and cross-references.
27
+ - Used by: Zeus, Mnemosyne, Themis
40
28
 
41
- 6. **agent-evaluation** — `skills/agent-evaluation/SKILL.md`
42
- - Hallucination detection (factual consistency, faithfulness), output quality scoring (relevance, coherence, helpfulness), behavioral testing (edge cases, adversarial inputs), automated red-teaming, regression benchmarking, and human-in-the-loop evaluation workflows.
43
- - Used by: Hephaestus, Themis
29
+ 5. **memory-bank** — `memory-bank/SKILL.md`
30
+ - Memory bank rules, structure, and optimization — complete guide to Pantheon memory management.
31
+ - Used by: Mnemosyne, Athena
44
32
 
45
- - Prompt injection attack taxonomy (direct, indirect, jailbreaking, leakage), detection strategies (classifier-based, LLM-as-judge, pattern matching), input sanitization, output guardrails, content filters, rate limiting on LLM calls, and red-teaming methodologies.
46
- - Used by: Themis, Hephaestus
33
+ 6. **orchestration-workflow** — `orchestration-workflow/SKILL.md`
34
+ - Practical step-by-step walkthrough for orchestrating features end-to-end using the multi-agent system, from planning through deployment.
35
+ - Used by: Zeus
47
36
 
48
- - NLU pipeline design (intent classification, entity extraction, slot filling), dialogue state management, Rasa framework integration, multi-turn conversation patterns, context windowing, fallback handling, and conversation testing strategies.
49
- - Used by: Hephaestus
50
-
51
- ### Domain 3: Backend Development
37
+ 7. **session-goal** — `session-goal/SKILL.md`
38
+ - Pin session objectives to prevent scope creep across long multi-agent sessions.
39
+ - Used by: Zeus, Mnemosyne
52
40
 
53
- 12. **fastapi-async-patterns** — `skills/fastapi-async-patterns/SKILL.md`
54
- - Async FastAPI endpoint design, dependency injection, service/repository pattern, Pydantic validation, error handling middleware, rate limiting, background tasks, file uploads, WebSocket support, and Gemini integration.
55
- - Used by: Hermes
41
+ ### Domain 2: Development Tools
56
42
 
57
- 13. **api-design-patterns** — `skills/api-design-patterns/SKILL.md`
58
- - RESTful API design principles, HTTP method semantics, status code selection, pagination strategies (cursor, offset), filtering and sorting, error response formats, OpenAPI/Swagger documentation, versioning, and HATEOAS considerations.
59
- - Used by: Hermes
43
+ 8. **clonedeps** — `clonedeps/SKILL.md`
44
+ - Clones dependency source locally so agents can inspect library internals, understand behavior, and debug integration issues.
45
+ - Used by: Hermes, Hephaestus
60
46
 
61
- ### Domain 4: Frontend Development
47
+ 9. **git-workflow-and-versioning** — `git-workflow-and-versioning/SKILL.md`
48
+ - Atomic commits, conventional commits, trunk-based development workflow.
49
+ - Used by: Hermes, Prometheus, Iris
62
50
 
63
- 14. **frontend-analyzer** — `skills/frontend-analyzer/SKILL.md`
64
- - React/Next.js component architecture analysis, typography system extraction, color palette identification, layout pattern recognition ( flexbox, grid, spacing), responsive breakpoint mapping, font stack detection, and design token inventory.
65
- - Used by: Aphrodite
51
+ 10. **incremental-implementation** — `incremental-implementation/SKILL.md`
52
+ - Implement in thin vertical slices — one commit per task, testable, rollback-safe.
53
+ - Used by: Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos
66
54
 
67
- 15. **nextjs-seo-optimization** — `skills/nextjs-seo-optimization/SKILL.md`
68
- - Next.js App Router metadata API, JSON-LD structured data (schema.org), auto-generated XML sitemaps, Open Graph and Twitter Card tags, canonical URL strategy, dynamic OG image generation, Core Web Vitals optimization for SEO, and i18n SEO patterns.
69
- - Used by: Aphrodite
55
+ 11. **loop-engineering** — `loop-engineering/SKILL.md`
56
+ - Iterative refinement pattern for complex problems — solve, review, improve, repeat in controlled cycles.
57
+ - Used by: All agents
70
58
 
71
- ### Domain 5: Database & Storage
59
+ 12. **reflect** — `reflect/SKILL.md`
60
+ - Turns repeated workflow friction into reusable skills, agents, or configuration improvements.
61
+ - Used by: All agents
72
62
 
73
- 16. **database-migration** — `skills/database-migration/SKILL.md`
74
- - Alembic migration workflows, zero-downtime migration strategies (expand-contract), backward-compatible schema changes, data migration with batch processing, rollback procedures, merge conflict resolution, and migration testing.
75
- - Used by: Demeter
63
+ 13. **simplify** — `simplify/SKILL.md`
64
+ - Behavior-preserving code simplification for readability, maintainability, and reduced complexity.
65
+ - Used by: All agents
76
66
 
77
- 17. **database-optimization** — `skills/database-optimization/SKILL.md`
78
- - Index analysis and recommendation (B-tree, GiST, GIN, BRIN), N+1 query detection using SQLAlchemy event listeners, query execution plan analysis (EXPLAIN ANALYZE), connection pooling configuration, caching layers, materialized views, read replica offloading, async query batching, and profiling.
79
- - Used by: Demeter, Prometheus
67
+ 14. **worktrees** — `worktrees/SKILL.md`
68
+ - Git worktrees as safe, isolated coding lanes for risky or parallel work without affecting the main workspace.
69
+ - Used by: All agents
80
70
 
81
- ### Domain 6: Quality & Security
71
+ ### Domain 3: Quality & Security
82
72
 
83
- 18. **code-review-checklist** — `skills/code-review-checklist/SKILL.md`
84
- - Systematic code review process with quality gates (trailing whitespace, hard tabs, wild imports), SOLID principles validation, error handling patterns (explicit vs silent), test coverage analysis, type safety verification, and structured feedback with severity levels.
73
+ 15. **code-review-checklist** — `code-review-checklist/SKILL.md`
74
+ - Systematic code review with quality gates, security audit, and parallel checks for structured feedback.
85
75
  - Used by: Themis
86
76
 
87
- 19. **security-audit-pro** — `skills/security-audit-pro/SKILL.md`
88
- - Professional security audit — SAST, SCA, container security, SBOM, PII detection, and compliance (GDPR, LGPD, HIPAA).
89
- - Used by: Themis, Hermes, Demeter
90
-
91
- 20. **tdd-with-agents** — `skills/tdd-with-agents/SKILL.md`
92
- - TDD lifecycle enforcement (RED → GREEN → REFACTOR), test-first development across all layers, advanced testing patterns (E2E, load, mutation, contract, visual regression), coverage thresholds (>80%).
93
- - Used by: Hermes, Aphrodite, Demeter, Themis
94
-
95
- 21. **docker-best-practices** — `skills/docker-best-practices/SKILL.md`
96
- - Multi-stage Docker builds, layer caching optimization, .dockerignore patterns, non-root user execution, health check configuration, GPU container setup (CUDA), memory and CPU limits, secrets management (Docker secrets, not env vars), and docker-compose patterns for dev/prod parity.
97
- - Used by: Prometheus
98
-
99
- 22. **mcp-server-development** — `skills/mcp-server-development/SKILL.md`
100
- - Model Context Protocol (MCP) architecture, server creation with FastMCP/ Python SDK, tool definition and registration, resource exposure, prompt templates, transport layer configuration (stdio, SSE), authentication, error handling, and testing MCP servers.
101
- - Used by: Hephaestus, Prometheus, Nyx
102
-
103
- 23. **agent-observability** — `skills/agent-observability/SKILL.md`
104
- - OpenTelemetry instrumentation (traces, metrics, logs), LangSmith integration for LLM call tracing, Prometheus metric exposition, Grafana dashboard design, cost tracking per agent/feature, token usage attribution, structured JSON logging with correlation IDs, and alerting rules.
105
- - Used by: Nyx, Prometheus
77
+ 16. **security-hardening** — `security-hardening/SKILL.md`
78
+ - Security gate — OWASP, SAST, secrets detection, MCP hardening, dependency audit.
79
+ - Used by: Themis, Nyx
106
80
 
107
- 24. **cache-strategy** — `skills/cache-strategy/SKILL.md`
108
- - Cache architecture patterns — Redis (read-through, write-through, write-behind), CDN, TTL strategies, invalidation patterns, session stores.
109
- - Used by: Demeter, Hermes
81
+ 17. **tdd-with-agents** — `tdd-with-agents/SKILL.md`
82
+ - TDD enforcement with RED→GREEN→REFACTOR cycle and advanced testing patterns across all layers.
83
+ - Used by: Hermes, Aphrodite, Demeter, Themis, Hephaestus
110
84
 
111
- ### Domain 8: Domain Specialists
85
+ ### Domain 4: Planning
112
86
 
113
- 25. **remote-sensing-analysis** — `skills/remote-sensing-analysis/SKILL.md`
114
- - Complete remote sensing pipeline: spectral indices (NDVI, EVI, NBR, NDWI, MNDWI), SAR processing, change detection algorithms, time series analysis, land use/land cover (LULC) product inter-comparison (MapBiomas, CGLS, ESRI, GLAD, ESA WorldCover), accuracy metrics (Kappa, OA, F1, Dice), and ML/DL model training for RS imagery.
115
- - Used by: Gaia
116
-
117
- 26. **internet-search** — `skills/internet-search/SKILL.md`
118
- - Web research methodology with source trust hierarchy (official docs > academic > community), structured API patterns for general web (DuckDuckGo, Wikipedia, Jina Reader), tech community (Stack Overflow, Hacker News, Reddit, Dev.to), official vendor docs, academic databases (Semantic Scholar, CrossRef, arXiv), GitHub search, package registries, and remote sensing data sources. All sources free, no API key required.
119
- - Used by: Athena, Apollo, Gaia, Zeus
120
-
121
- 27. **prompt-improver** — `skills/prompt-improver/SKILL.md`
122
- - Prompt analysis and optimization: clarity and specificity evaluation, context window management, output format specification, NLU optimization for intent/entity extraction, chain-of-thought prompting, token efficiency, few-shot example selection, and systematic prompt testing.
123
- - Used by: All agents
124
-
125
- 28. **interview** — `skills/interview/SKILL.md`
126
- - Turn a rough idea into a structured spec through a short Q&A interview. Ask 3–5 targeted questions one at a time, then produce a complete markdown spec with goals, requirements, constraints, and open questions.
127
- - Used by: Athena, Zeus
128
- - Domain: Planning
129
-
130
- 29. **session-goal** — `skills/session-goal/SKILL.md`
131
- - Pin a session objective so all todos, delegation decisions, and verification steps stay aligned with a single stated goal. Prevents scope creep and drift across long multi-agent sessions.
132
- - Used by: Zeus, Athena
133
- - Domain: Orchestration
134
-
135
- 30. **auto-continue** — `skills/auto-continue/SKILL.md`
136
- - Safe auto-continue pattern for multi-step orchestration — how to automatically work through todo lists without unnecessary interruptions while always stopping at mandatory safety gates (plan approval, phase review, git commit).
137
- - Used by: Zeus, Hermes, Aphrodite, Demeter
138
- - Domain: Orchestration
139
-
140
- 31. **metis-gap-analysis** — `skills/metis-gap-analysis/SKILL.md`
141
- - Pre-plan gap analysis — catch hidden intentions, ambiguities, missing acceptance criteria, AI slop patterns, and edge cases before the plan is delivered to the user.
142
- - Used by: Athena, Zeus
143
- - Domain: Planning
144
-
145
- 32. **codemap** — `skills/codemap/SKILL.md`
146
- - Hierarchical codebase map generation — directory trees, entry points, module relationships and dependency analysis.
87
+ 18. **codemap** — `codemap/SKILL.md`
88
+ - Generates hierarchical repository maps so agents understand codebase structure without re-reading every file.
147
89
  - Used by: Apollo, Zeus
148
90
 
149
- 33. **init-deep** — `skills/init-deep/SKILL.md`
150
- - Generate hierarchical AGENTS.md files throughout the project directory tree. Each directory gets context-specific instructions for agents working in that scope.
151
- - Used by: Athena, Prometheus
152
- - Domain: Planning
153
-
154
- 34. **handoff** — `skills/handoff/SKILL.md`
155
- - Generate structured session handoff for continuing work in a new session. Captures current state, what was done, what remains, decisions, and relevant files.
156
- - Used by: All agents
157
- - Domain: Orchestration
91
+ 19. **spec-driven-development** — `spec-driven-development/SKILL.md`
92
+ - Define requirements via spec-first before any code — PRD, edge cases, acceptance criteria.
93
+ - Used by: Athena
158
94
 
159
- 35. **task-system** — `skills/task-system/SKILL.md`
160
- - File-backed task management with dependencies (blockedBy/blocks), automatic parallel execution, and session persistence. For complex work with 3+ interdependent tasks.
161
- - Used by: Zeus, Athena
162
- - Domain: Orchestration
95
+ 20. **verification-planning** — `verification-planning/SKILL.md`
96
+ - Plans an evidence path before non-trivial changes, ensuring changes are testable and verifiable.
97
+ - Used by: Athena, Zeus
163
98
 
164
- - Extract and pass learnings between implementation waves — conventions, successes, failures, gotchas, and commands. Temporary, scoped to feature, deleted after merge.
165
- - Used by: All agents
166
- - Domain: Utilities
99
+ ### Domain 5: Frontend Development
167
100
 
168
- - Plan feature architecture with component breakdown, data flow, and dependency mapping. Use before implementation to define contracts between layers.
169
- - Used by: Athena, Zeus
170
- - Domain: Planning
101
+ 21. **visual-review-pipeline** — `visual-review-pipeline/SKILL.md`
102
+ - Automated visual review pipeline — Playwright screenshots, self-analysis, fix loop, escalation.
103
+ - Used by: Aphrodite
171
104
 
172
105
  ## Skills File Structure
173
106
 
174
107
  Each skill follows a consistent layout:
175
108
 
176
109
  ```
177
- skills/[skill-name]/
110
+ src/skills/[skill-name]/
178
111
  ├── SKILL.md — main reference document (YAML frontmatter + content)
179
112
  ├── scripts/ — optional helper scripts (if any)
180
113
  └── examples/ — optional example files, templates, or configs (if any)
@@ -194,36 +127,27 @@ The `SKILL.md` file contains YAML frontmatter with `name`, `description`, and pl
194
127
 
195
128
  | # | Skill Name | Domain | Used By |
196
129
  |---|------------|--------|---------|
197
- | 1 | agent-coordination | Orchestration & Workflow | Zeus, Athena |
198
- | 2 | artifact-management | Orchestration & Workflow | Zeus, Mnemosyne |
199
- | 3 | memory-bank | Orchestration & Workflow | Mnemosyne, All agents |
200
- | 6 | auto-continue | Orchestration | Zeus, Hermes, Aphrodite, Demeter |
201
- | 7 | session-goal | Orchestration | Zeus, Athena |
202
- | 8 | task-system | Orchestration | Zeus, Athena |
203
- | 9 | rag-pipelines | AI & Machine Learning | Hephaestus |
204
-
205
- | 12 | agent-evaluation | AI & Machine Learning | Hephaestus, Themis |
206
- | 15 | fastapi-async-patterns | Backend Development | Hermes |
207
- | 16 | api-design-patterns | Backend Development | Hermes |
208
- | 17 | frontend-analyzer | Frontend Development | Aphrodite |
209
- | 18 | nextjs-seo-optimization | Frontend Development | Aphrodite |
210
- | 19 | database-migration | Database & Storage | Demeter |
211
- | 20 | database-optimization | Database & Storage | Demeter, Prometheus |
212
- | 21 | cache-strategy | Database & Storage | Demeter, Hermes |
213
- | 22 | code-review-checklist | Quality & Security | Themis |
214
- | 23 | security-audit-pro | Quality & Security | Themis, Hermes, Demeter |
215
- | 24 | tdd-with-agents | Quality & Security | Hermes, Aphrodite, Demeter, Themis |
216
- | 25 | docker-best-practices | Infrastructure & DevOps | Prometheus |
217
- | 26 | mcp-server-development | Infrastructure & DevOps | Hephaestus, Prometheus, Nyx |
218
- | 27 | agent-observability | Infrastructure & DevOps | Nyx, Prometheus |
219
- | 28 | remote-sensing-analysis | Domain Specialists | Gaia |
220
- | 29 | internet-search | Domain Specialists | Athena, Apollo, Gaia, Zeus |
221
- | 30 | prompt-improver | Domain Specialists | All agents |
222
- | 31 | interview | Planning | Athena, Zeus |
223
- | 32 | metis-gap-analysis | Planning | Athena, Zeus |
224
- | 33 | codemap | Planning | Apollo, Zeus |
225
- | 34 | init-deep | Planning | Athena, Prometheus |
226
- | 35 | handoff | Utilities | All agents |
130
+ | 1 | agent-coordination | Orchestration & Workflow | Zeus |
131
+ | 2 | artifact-management | Orchestration & Workflow | Zeus, Mnemosyne, Iris |
132
+ | 3 | auto-continue | Orchestration & Workflow | Zeus, Apollo, Hephaestus, Nyx, Gaia |
133
+ | 4 | context-compression | Orchestration & Workflow | Zeus, Mnemosyne, Themis |
134
+ | 5 | memory-bank | Orchestration & Workflow | Mnemosyne, Athena |
135
+ | 6 | orchestration-workflow | Orchestration & Workflow | Zeus |
136
+ | 7 | session-goal | Orchestration & Workflow | Zeus, Mnemosyne |
137
+ | 8 | clonedeps | Development Tools | Hermes, Hephaestus |
138
+ | 9 | git-workflow-and-versioning | Development Tools | Hermes, Prometheus, Iris |
139
+ | 10 | incremental-implementation | Development Tools | Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos |
140
+ | 11 | loop-engineering | Development Tools | All agents |
141
+ | 12 | reflect | Development Tools | All agents |
142
+ | 13 | simplify | Development Tools | All agents |
143
+ | 14 | worktrees | Development Tools | All agents |
144
+ | 15 | code-review-checklist | Quality & Security | Themis |
145
+ | 16 | security-hardening | Quality & Security | Themis, Nyx |
146
+ | 17 | tdd-with-agents | Quality & Security | Hermes, Aphrodite, Demeter, Themis, Hephaestus |
147
+ | 18 | codemap | Planning | Apollo, Zeus |
148
+ | 19 | spec-driven-development | Planning | Athena |
149
+ | 20 | verification-planning | Planning | Athena, Zeus |
150
+ | 21 | visual-review-pipeline | Frontend Development | Aphrodite |
227
151
 
228
152
  ---
229
153