pantheon-opencode 1.1.0 → 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.
package/AGENTS.md CHANGED
@@ -25,7 +25,7 @@ This project uses the Pantheon multi-agent framework with 14 specialized agents.
25
25
 
26
26
  See [INSTALLATION.md](docs/INSTALLATION.md) for setup instructions.
27
27
 
28
- - Build: `npm run build`
28
+ - Build: `npm test`
29
29
  - Test: `npm test`
30
30
  - Lint: `npm run lint`
31
31
 
package/README.md CHANGED
@@ -1,19 +1,13 @@
1
- <p align="center">
2
- <img src="images/logo.png" alt="Pantheon Logo" width="500"/>
3
- </p>
4
1
 
5
2
  <h1 align="center">Pantheon</h1>
6
3
 
7
4
  <p align="center">
8
5
  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-v1.0.0-blue" alt="Version"></a>
9
6
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
10
- <a href="docs/platforms/"><img src="https://img.shields.io/badge/platforms-opencode-green" alt="Platforms"></a>
11
- <a href="agents/README.md"><img src="https://img.shields.io/badge/agents-14-purple" alt="Agents"></a>
12
- <a href="skills/README.md"><img src="https://img.shields.io/badge/skills-14-orange" alt="Skills"></a>
13
- <a href="commands/"><img src="https://img.shields.io/badge/commands-14-red" alt="Commands"></a>
14
- <a href="docs/platforms/"><img src="https://img.shields.io/badge/built%20with-opencode-8250DF" alt="Built with"></a>
7
+ <a href="src/agents/README.md"><img src="https://img.shields.io/badge/agents-14-purple" alt="Agents"></a>
8
+ <a href="src/skills/README.md"><img src="https://img.shields.io/badge/skills-21-orange" alt="Skills"></a>
9
+ <a href="commands/"><img src="https://img.shields.io/badge/commands-11-red" alt="Commands"></a>
15
10
  <a href="https://github.com/ils15/pantheon/actions"><img src="https://img.shields.io/github/actions/workflow/status/ils15/pantheon/ci.yml?branch=main&label=CI" alt="CI"></a>
16
- <a href="https://github.com/ils15/pantheon/actions"><img src="https://img.shields.io/github/actions/workflow/status/ils15/pantheon/release.yml?branch=main&label=release" alt="Release"></a>
17
11
  </p>
18
12
 
19
13
  **14 specialized AI agents** that plan, build, review, and deploy features through enforced TDD, persistent project memory, and human approval at every gate.
@@ -24,34 +18,18 @@ Supports **OpenCode** — multi-agent orchestration for your editor.
24
18
 
25
19
  ---
26
20
 
27
- ## 📋 v1.0 Changelog
28
-
29
- | Sprint | Feature |
30
- |--------|--------|
31
- | 1 | Memory Commands (/pantheon-remember, search, consolidate, forget) |
32
- | 2 | @pantheon/cli npm package |
33
- | 3 | Themis 2.0 (3-layer review + IntentGate) |
34
- | 4 | Background Agents + TODO Enforcer + Hash Edits |
35
- | 5 | Memory Simplification (agents read-only, WAL) |
36
- | 6 | YAGNI + Anti-overengineering (12 patterns) |
37
-
38
- **🏆 Themis audit: 100/100**
39
- **🗑️ 9 commands removed:** ping, stop-continuation, subtask, manifest, forge, mirrordeps, praxis, metamorphosis, reflect
40
- **✨ 14 commands total** — all `/pantheon-*`
41
-
42
21
  ## Quick Links
43
22
 
44
23
  | Resource | Link |
45
24
  |----------|------|
46
- | 📖 **Agent Reference** | [agents/README.md](agents/README.md) — all 14 agents |
47
- | 📖 **Skills Reference** | [skills/README.md](skills/README.md) — all 14 skills |
25
+ | 📖 **Agent Reference** | [src/agents/README.md](src/agents/README.md) — all 14 agents |
26
+ | 📖 **Skills Reference** | [src/skills/README.md](src/skills/README.md) — all 21 skills |
48
27
  | 🚀 **Installation Guide** | [docs/INSTALLATION.md](docs/INSTALLATION.md) |
49
- | 🔌 **MCP Servers** | [docs/mcp-recommendations.md](docs/mcp-recommendations.md) — recommended MCP servers for each project type |
28
+ | 🔌 **MCP Server Guide** | [docs/mcp-recommendations.md](docs/mcp-recommendations.md) — recommended MCP servers for each project type |
50
29
  | 🔌 **MCP Tool Registry** | [docs/mcp-tools.md](docs/mcp-tools.md) — canonical MCP tool reference |
51
30
  | 🔌 **MCP User Guide** | [docs/mcp-user-guide.md](docs/mcp-user-guide.md) — adding custom MCP servers |
52
- | 🗂️ **MCP Tiers** | `.pantheon/tiers.json` — 4-tier MCP selection (none/essential/recommended/full) |
53
31
  | ⚡ **Quick Start** | [docs/QUICKSTART.md](docs/QUICKSTART.md) |
54
- | ⚡ **OpenCode** | [docs/platforms/opencode.md](docs/platforms/opencode.md) |
32
+ | ⚡ **OpenCode Guide** | [docs/platforms/opencode.md](docs/platforms/opencode.md) |
55
33
 
56
34
  ---
57
35
 
@@ -316,7 +294,7 @@ Domain Specialist
316
294
  └── Gaia — remote sensing: LULC analysis, scientific literature
317
295
  ```
318
296
 
319
- > See [agents/README.md](agents/README.md) for the complete reference — each agent's
297
+ > See [src/agents/README.md](src/agents/README.md) for the complete reference — each agent's
320
298
  > tools, model assignment, behavioral rules, and invocation patterns.
321
299
 
322
300
  ### Architecture Diagram
@@ -384,60 +362,38 @@ graph TB
384
362
  style T4 fill:#1a1a1a,stroke:#2d3748,stroke-width:1px
385
363
  style T5 fill:#1a1a1a,stroke:#2d3748,stroke-width:1px
386
364
  ```
365
+ ## Memory System
387
366
 
388
- <p align="center">
389
- <img src="images/Schema.png" alt="Pantheon System Architecture" width="100%"/>
390
- </p>
391
-
392
- ---
393
-
394
- ## 🧠 Level 3 Vector Memory (v4.0)
395
-
396
- Pantheon v1.0.0 introduces a persistent two-tier memory system with semantic retrieval:
367
+ Pantheon uses a two-tier memory architecture to maintain context across sessions:
397
368
 
398
- ### Tier 1 — Auto-Indexed Memory (`/memories/repo/`)
399
- Agent memory is automatically indexed at zero token cost. Every agent writes atomic facts on discovery:
400
- - Tech stack, conventions, build commands
401
- - Architectural decisions and patterns
402
- - Cross-component relationships
369
+ | Tier | Description | Content |
370
+ |------|-------------|---------|
371
+ | **Tier 1 — Session** | Auto-managed by Zeus via agent subtask summaries | Current plans, work-in-progress, agent outputs |
372
+ | **Tier 2 — Reference** | Instruction files in `src/instructions/` | Domain standards, communication rules, protocol definitions |
403
373
 
404
- ### Tier 2 — Compressed Context (`.pantheon/memory-bank/`)
405
- On-demand compression pipeline archives completed phases into structured context:
406
- - **Priority scoring** — CRITICAL/HIGH/LOW budget allocation (deterministic, no LLM)
407
- - **ZZ artifacts** — compressed phase context for agent-to-agent handoff
408
- - **Cross-reference index** (`_xref/index.md`) — entity/decision lookup
374
+ Agent memory is automatically indexed at zero token cost — every agent writes atomic facts
375
+ on discovery (tech stack, conventions, architectural decisions). Zeus persists all agent
376
+ returns via write-ahead log, ensuring no context is lost between phases.
409
377
 
410
- ### Usage
411
- ```bash
412
- @mnemosyne Recall "<feature description>" --top-k 5 # Retrieve past decisions
413
- @mnemosyne Close sprint: "<summary>" # Archive and compress
414
- ```
415
-
416
- ### Benefits
417
- - 🚫 No more lost context between phases
418
- - 🧩 Past decisions surface automatically before planning
419
- - 💾 Zero manual memory management — agents self-index
420
- - 🔄 Lossless recovery via git
378
+ Architectural decisions are recorded as ADRs in `.pantheon/memory-bank/_notes/` and are
379
+ permanently committed to the repository.
421
380
 
422
381
  ---
423
382
 
424
383
  ## Skill Ecosystem
425
384
 
426
- Pantheon bundles **14 cross-platform skills** — modular instruction sets that agents load
385
+ Pantheon bundles **21 cross-platform skills** — modular instruction sets that agents load
427
386
  on demand to perform specialized tasks. Skills are organized into domains:
428
387
 
429
388
  | Domain | Skills |
430
389
  |---|---|
431
- | **Orchestration** | agent-coordination, artifact-management, tdd-with-agents, auto-continue, session-goal, task-system, handoff, orchestration-workflow |
432
- | **Backend & API** | api-design-patterns, fastapi-async-patterns, database-migration, database-optimization |
433
- | **Frontend** | frontend-analyzer, nextjs-seo-optimization |
434
- | **Infrastructure** | docker-best-practices, streaming-patterns, cache-strategy |
435
- | **Planning & Design** | plan-architecture, codemap, init-deep, interview, metis-gap-analysis |
436
- | **Memory & Context** | memory-bank, file-prompts, context-compression |
437
- | **Domain** | remote-sensing-analysis, internet-search |
438
- | **Utilities** | prompt-improver, agent-evaluation, agent-observability, wisdom-accumulation, simplify, test-architecture, token-audit |
439
-
440
- > See [skills/README.md](skills/README.md) for the complete reference with descriptions
390
+ | **Orchestration & Workflow** | agent-coordination, artifact-management, auto-continue, context-compression, memory-bank, orchestration-workflow, session-goal |
391
+ | **Development Tools** | clonedeps, git-workflow-and-versioning, incremental-implementation, loop-engineering, reflect, simplify, worktrees |
392
+ | **Quality & Security** | code-review-checklist, security-hardening, tdd-with-agents |
393
+ | **Planning** | codemap, spec-driven-development, verification-planning |
394
+ | **Frontend Development** | visual-review-pipeline |
395
+
396
+ > See [src/skills/README.md](src/skills/README.md) for the complete reference with descriptions
441
397
  > and usage patterns.
442
398
 
443
399
  ---
@@ -455,42 +411,6 @@ subscription (OpenCode Go, Copilot Pro, Claude Pro, etc.).
455
411
  | `coding` | Heavy coding tasks | Hermes, Aphrodite, Demeter, Prometheus, Hephaestus, Talos | DeepSeek V4 Flash, Claude Sonnet |
456
412
  | `fast` | Quick, cheap ops | Apollo, Iris, Mnemosyne, Talos, Nyx | DeepSeek V4 Flash, MiniMax M2.7, Gemini Flash |
457
413
 
458
- ### /forge — Model Presets
459
-
460
- Pantheon ships with **`/forge`** — a model configuration command that applies named presets from
461
- `built-in presets`. Each preset maps 4 tiers to concrete models across all 14 agents.
462
-
463
- **Usage:**
464
- ```
465
- /forge opencode-go ← Apply a preset (12 available)
466
- /forge default ← Reset to account defaults (no models set)
467
- /forge list ← List all available presets
468
- /forge status ← Show current model configuration
469
- /forge deepseek-flash ← Single model for all agents
470
- /forge --zeus anthropic/claude-opus-4-6 ← Override a single agent
471
- ```
472
-
473
- **Available presets:**
474
-
475
- | Preset | Premium | Default | Coding | Fast | Requires |
476
- |--------|---------|---------|--------|------|----------|
477
- | `default` | — | — | — | — | Account defaults |
478
- | `opencode-go` | DeepSeek V4 Pro | Kimi K2.6 | DeepSeek V4 Flash | MiniMax M2.7 | OpenCode Go |
479
- | `deepseek-flash` | DeepSeek V4 Flash | DeepSeek V4 Flash | DeepSeek V4 Flash | DeepSeek V4 Flash | OpenCode Go |
480
- | `kimi` | Kimi K2.6 | Kimi K2.5 | Kimi K2.6 | MiniMax M2.7 | OpenCode Go |
481
- | `qwen` | Qwen3.6 Plus | Qwen3.5 Plus | Qwen3.6 Plus | DeepSeek V4 Flash | OpenCode Go |
482
- | `opencode-co` | DeepSeek V4 Pro | Kimi K2.6 | Kimi K2.6 | MiniMax M2.7 | OpenCode Go |
483
- | `claude-pro` | Claude Opus-4 🤔 | Claude Sonnet-4 🤔 | Claude Sonnet-4 🤔 | Claude Haiku-4 🤔 | Anthropic key |
484
- | `openai` | o3 (high) | GPT-4o | GPT-4o | GPT-4o-mini | OpenAI key |
485
- | `gemini` | Gemini 3.5 Flash | Gemini 2.5 Flash | Gemini 2.5 Flash | Gemini 3.1 Flash-Lite | Google AI key |
486
- | `github-copilot` | Claude Opus-4 | GPT-4o | GPT-4o | GPT-4o-mini | Copilot ($10/m) |
487
- | `byok-best` | Claude Opus-4 🤔 | GPT-4o | GPT-4o | GPT-4o-mini | Anthropic + OpenAI |
488
- | `together-moe` | DeepSeek V4 | Llama 4 Scout | Llama 4 Scout | Llama 3.2 3B | Together key |
489
-
490
- > 🤔 = thinking habilitado
491
-
492
- Built-in presets available (opencode-go, deepseek-flash, etc.) and `docs/platforms/` for per-platform setup guides.
493
-
494
414
  ---
495
415
 
496
416
  ## Quick Start
@@ -538,25 +458,17 @@ Type these in the OpenCode chat:
538
458
 
539
459
  | Command | Description |
540
460
  |---------|-------------|
541
- | `/pantheon` | Multi-perspective synthesis (Council) via inline agents |
461
+ | `/pantheon` | Multi-perspective synthesis (Council) |
542
462
  | `/pantheon-audit` | Code review + security audit |
543
- | `/pantheon-bg` | List background tasks |
544
- | `/pantheon-consolidate` | Consolidate memory |
545
- | `/pantheon-deepwork` | Heavy multi-phase task with persisted checkpoints |
546
- | `/pantheon-doc` | Generate documentation |
463
+ | `/pantheon-deepwork` | Heavy multi-phase task |
547
464
  | `/pantheon-focus` | Pin a session goal |
548
465
  | `/pantheon-forget` | Compress/consolidate memories |
549
- | `/pantheon-hash` | Hash edit verification |
550
- | `/pantheon-optimize` | Context optimization & token audit |
466
+ | `/pantheon-optimize` | Context optimization |
467
+ | `/pantheon-reflect` | Reflect on workflow friction |
551
468
  | `/pantheon-remember` | Store in memory |
552
469
  | `/pantheon-search` | Search memory |
553
- | `/pantheon-status` | Show system health and agent status |
554
- | `/pantheon-todo` | Create and maintain task list |
555
-
556
-
557
- ### TUI Sidebar Plugin (OpenCode) — Temporarily Disabled
558
-
559
- The TUI Sidebar Plugin is currently disabled. It will be re-enabled in a future release once the TUI package compatibility is resolved. For agent discovery, use `AGENTS.md`, `agents/README.md`, or `/pantheon-status` to list all agents.
470
+ | `/pantheon-status` | System health and agent status |
471
+ | `/pantheon-verify` | Hash edit verification |
560
472
 
561
473
  ---
562
474
 
@@ -564,175 +476,74 @@ The TUI Sidebar Plugin is currently disabled. It will be re-enabled in a future
564
476
 
565
477
  ```
566
478
  pantheon/
567
- ├── README.md — this file
568
- ├── AGENTS.md — full agent reference
569
- ├── CHANGELOG.md — release history
570
- ├── CONTRIBUTING.md — how to extend
571
- ├── LICENSE — MIT
572
- ├── package.json — sync & install tooling
573
- ├── opencode.json — OpenCode platform config
574
- ├── plugin.json — marketplace plugin manifest
575
- │
576
- ├── agents/ — 14 agent definitions (.agent.md)
577
- │ ├── zeus.agent.md — orchestrator
578
- │ ├── athena.agent.md — strategic planner
579
-
580
- │ ├── apollo.agent.md — codebase & web discovery
581
- │ ├── nyx.agent.md — observability
582
- │ ├── hermes.agent.md — backend APIs
583
- │ ├── aphrodite.agent.md — frontend UI
584
- │ ├── demeter.agent.md — database
585
- │ ├── themis.agent.md — quality & security review
586
- │ ├── prometheus.agent.md — infrastructure
587
- │ ├── iris.agent.md — GitHub operations
588
- │ ├── mnemosyne.agent.md — memory & documentation
589
- │ ├── talos.agent.md — hotfixes
590
- │ ├── gaia.agent.md — remote sensing
591
- │ ├── hephaestus.agent.md — AI pipelines
592
- │ └── README.md
593
- │
594
- ├── skills/ — 14 cross-platform skill modules
595
- │ ├── README.md
596
- │ ├── agent-coordination/ * orchestration & coordination
597
- │ ├── artifact-management/
598
- │ ├── auto-continue/
599
- │ ├── handoff/
600
- │ ├── orchestration-workflow/
601
- │ ├── session-goal/
602
- │ ├── task-system/
603
- │ ├── tdd-with-agents/
604
- │ ├── api-design-patterns/ * backend & API
605
- │ ├── fastapi-async-patterns/
606
- │ ├── database-migration/
607
- │ ├── database-optimization/
608
- │ ├── frontend-analyzer/ * frontend
609
- │ ├── nextjs-seo-optimization/
610
- │ ├── rag-pipelines/ * AI pipelines
611
- │ ├── mcp-server-development/
612
- │ ├── docker-best-practices/ * infrastructure
613
- │ ├── streaming-patterns/
614
- │ ├── cache-strategy/
615
- │ ├── security-audit-pro/ * security & quality
616
- │ ├── code-review-checklist/
617
- │ ├── mcp-security/
618
- │ ├── quality-gate/
619
- │ ├── memory-bank/ * memory & context
620
- │ ├── codemap/
621
- │ ├── init-deep/
622
- │ ├── file-prompts/
623
- │ ├── context-compression/
624
- │ ├── plan-architecture/ * planning & design
625
- │ ├── interview/
626
- │ ├── metis-gap-analysis/
627
- │ ├── remote-sensing-analysis/ * domain
628
- │ ├── internet-search/
629
- │ ├── prompt-improver/ * utilities
630
- │ ├── agent-evaluation/
631
- │ ├── agent-observability/
632
- │ ├── simplify/
633
- │ ├── test-architecture/
634
- │ ├── token-audit/
635
- │ ├── wisdom-accumulation/
636
- │ └── */SKILL.md
479
+ ├── README.md
480
+ ├── AGENTS.md
481
+ ├── CHANGELOG.md
482
+ ├── CONTRIBUTING.md
483
+ ├── LICENSE
484
+ ├── package.json
485
+ ├── opencode.json
486
+ ├── plugin.json
487
+ ├── tsconfig.json
637
488
  │
638
- ├── instructions/ — 10 domain coding standards
639
- │ ├── agent-return-format.instructions.md
640
- │ ├── backend-standards.instructions.md
641
- │ ├── code-quality-checks.instructions.md
642
- │ ├── database-standards.instructions.md
643
- │ ├── documentation-standards.instructions.md
644
- │ ├── frontend-standards.instructions.md
645
- │ ├── infra-standards.instructions.md
646
- │ ├── zeus-anti-stall.instructions.md
647
- │ ├── zeus-communication-rules.instructions.md
648
- │ ├── zeus-council-synthesis.instructions.md
649
- │ └── zeus-timeout-retry.instructions.md
489
+ ├── src/
490
+ │ ├── agents/ — 14 agent definitions (.md)
491
+ │ ├── instructions/ — 9 instruction files
492
+ │ ├── skills/ — 21 skill modules (SKILL.md)
493
+ │ ├── pantheon/ — BackgroundJobBoard, auto-wake, persistence
494
+ │ ├── mcp/ — MCP server implementations
495
+ │ ├── plugins/ — OpenCode plugin integrations
496
+ │ ├── plugin.ts — OpenCode plugin entry
497
+ │ └── routing.yml — canonical routing config
650
498
  │
651
- ├── prompts/ — 13 agent invocation prompts
652
- │ ├── implement-feature.prompt.md
653
- │ ├── orchestrate-with-zeus.prompt.md
654
- │ ├── debug-issue.prompt.md
655
- │ ├── plan-architecture.prompt.md
656
- │ ├── optimize-database.prompt.md
657
- │ ├── sketch.prompt.md
658
- │ ├── focus.prompt.md
659
- │ ├── quick-discovery-large-codebase.prompt.md
660
- │ ├── quick-plan-large-feature.prompt.md
661
- │ ├── semantic-summarize.md
662
- │ ├── README.md
663
- │ └── dynamic/ * generated prompts
499
+ ├── tests/
500
+ │ ├── pantheon/ — BackgroundJobBoard + persistence tests
501
+ │ ├── integration/ — integration tests
502
+ │ └── *.py / *.mjs — pytest + Vitest test suites
664
503
  │
665
- ├── platform/ — OpenCode-only configuration
666
- │ ├── optimize-context.sh * context optimization script
667
- │ └── opencode/ * OpenCode configs
668
- │
669
- ├── scripts/ — tooling, automation & lifecycle hooks
670
- │ ├── postinstall.mjs * npm post-install hook
671
- │ ├── doctor.mjs * health check CLI
672
- │
673
- │ ├── validate-sync.mjs * sync integrity check
674
- │ └── hooks/ * agent lifecycle hooks (10 .sh scripts)
675
- │ ├── audit-imports.sh
676
- │ ├── format-multi-language.sh
677
- │ ├── log-session-start.sh
678
- │ ├── on-subagent-delegation-start.sh
679
- │ ├── on-subagent-delegation-stop.sh
680
- │ ├── run-type-check.sh
681
- │ ├── scan-secrets.sh
682
- │ ├── validate-post-conditions.sh
683
- │ ├── validate-talos-scope.sh
684
- │ └── validate-tool-safety.sh
685
- │
686
- ├── commands/ # 14 interaction commands
687
- │ ├── cancel.md
504
+ ├── commands/ — 11 interaction commands
505
+ │ ├── pantheon.md
688
506
  │ ├── pantheon-audit.md
689
507
  │ ├── pantheon-deepwork.md
690
508
  │ ├── pantheon-focus.md
691
- │ ├── pantheon-install.md
692
- │ ├── pantheon-metamorphosis.md
509
+ │ ├── pantheon-forget.md
693
510
  │ ├── pantheon-optimize.md
694
511
  │ ├── pantheon-reflect.md
695
- │ ├── pantheon-sketch.md
512
+ │ ├── pantheon-remember.md
513
+ │ ├── pantheon-search.md
696
514
  │ ├── pantheon-status.md
697
- │ ├── pantheon-update.md
698
- │ ├── pantheon.md
515
+ │ └── pantheon-verify.md
699
516
  │
700
- ├── docs/
701
- │ ├── INSTALLATION.md — generic installation guide
702
- │ ├── SETUP.md — step-by-step tutorial
703
- │ ├── PLATFORMS.md — platform comparison
704
- │ ├── RELEASING.md — versioning & release process
705
- │ ├── INDEX.md — documentation index
706
- │ ├── platforms/ — OpenCode configuration guide
707
- │ │ └── opencode.md
708
- │ └── memory-bank/ — project memory (Mnemosyne's domain)
709
- │ ├── 00-project.md * project overview
710
- │ ├── 01-active-context.md * current sprint focus (priority file)
711
- │ ├── 02-progress-log.md * completed milestones (append-only)
712
- │ ├── _notes/ * architectural decisions (ADRs)
713
- │ └── _tasks/ * sprint task records
517
+ ├── scripts/
518
+ │ ├── hooks/ — 10 agent lifecycle hooks
519
+ │ ├── vector_memory/ — Level 3 vector memory system
520
+ │ ├── versioning.mjs — release versioning
521
+ │ ├── validate-routing.mjs — routing validation
522
+ │ ├── doctor.mjs — health check CLI
523
+ │ └── ...
714
524
  │
715
- ├── template/ — project templates
716
-
717
- │ └── README.md
525
+ ├── docs/
526
+ │ ├── INSTALLATION.md
527
+ │ ├── SETUP.md
528
+ │ ├── QUICKSTART.md
529
+ │ ├── RELEASING.md
530
+ │ ├── platforms/
531
+ │ └── ...
718
532
  │
719
- ├── logs/ — agent session audit logs
533
+ ├── prompts/ — 12 invocation prompts
720
534
  │
721
535
  ├── .github/
722
536
  │ ├── copilot-instructions.md
723
- │ └── workflows/ * CI/CD workflows (9 workflows)
724
- │ ├── ci.yml * main CI pipeline
725
- │ ├── conformance-matrix.yml * automated release creation
726
- │ ├── release.yml * release workflow
727
- │ ├── release-gate.yml * version sync enforcement
728
- │ ├── pr.yml * pull request checks
729
- │ ├── commit-lint.yml * conventional commit enforcement
730
- │ ├── docs.yml * documentation build
731
- │ ├── codeql.yml * security scanning
732
- │ └── sync-check.yml * platform sync integrity
537
+ │ └── workflows/ — 7 CI/CD workflows
538
+ │ ├── ci.yml
539
+ │ ├── beta-release.yml
540
+ │ ├── auto-release.yml
541
+ │ ├── commit-lint.yml
542
+ │ ├── codeql.yml
543
+ │ ├── docs.yml
544
+ │ └── hotfix.yml
733
545
  │
734
- ├── .vscode/ — VS Code workspace settings
735
- └── node_modules/ — npm dependencies
546
+ └── .vscode/ — VS Code workspace settings
736
547
  ```
737
548
 
738
549
  ---
@@ -781,25 +592,6 @@ For trivial fixes (CSS typos, simple logic bugs), bypass the full orchestration:
781
592
 
782
593
  ---
783
594
 
784
- ## Memory System
785
-
786
- Pantheon uses a two-tier memory architecture to maintain context across sessions:
787
-
788
- | Tier | Location | Content | Access Cost |
789
- |---|---|---|---|
790
- | **Tier 1 — Native** | `/memories/repo/` | Atomic facts (stack, conventions, commands) | Zero (auto-loaded) |
791
- | **Tier 2 — Reference** | `.pantheon/memory-bank/` | Project overview, architecture, active sprint, decisions | Read cost per file |
792
- | **Session** | `/memories/session/` | Current conversation plans, work-in-progress | One read per session |
793
-
794
- `01-active-context.md` is the priority file. Agents read it first when starting any task.
795
- It contains the current sprint focus, the most recent architectural decision, active
796
- blockers, and next steps.
797
-
798
- Architectural decisions are recorded as ADRs in `.pantheon/memory-bank/_notes/` and are
799
- permanently committed to the repository.
800
-
801
- ---
802
-
803
595
  ## Documentation Maintenance
804
596
 
805
597
  **Mnemosyne is the documentation owner.** She maintains the README, CHANGELOG, memory
@@ -813,15 +605,15 @@ to Mnemosyne so counts stay accurate and consistent.
813
605
  | Agent added or removed | `@mnemosyne Update README agent count and tier overview` |
814
606
  | Skill added or removed | `@mnemosyne Update README skills table and count` |
815
607
  | Version bump | `@mnemosyne Update README version badge and CHANGELOG` |
816
- | Sprint close | `@mnemosyne Update 01-active-context.md and append to 02-progress-log.md` |
608
+ | Sprint close | `@mnemosyne Archive and compress current sprint context` |
817
609
  | Architectural decision | `@mnemosyne Document decision: [topic]` |
818
610
  | Task record needed | `@mnemosyne Create task record: [feature] complete` |
819
611
 
820
612
  ### What CI enforces automatically
821
613
 
822
- `release-gate.yml` validates that the version number is consistent across all manifests
823
- (`package.json`, `plugin.json`, `CHANGELOG.md`, and the README badge) on every release.
824
- If they diverge, the release is blocked until Mnemosyne reconciles them.
614
+ `auto-release.yml` validates version consistency across all manifests (`package.json`,
615
+ `plugin.json`, `CHANGELOG.md`, and the README badge) before publishing. If they diverge,
616
+ the release is blocked until Mnemosyne reconciles them.
825
617
 
826
618
  ### Anti-patterns
827
619
 
@@ -833,21 +625,13 @@ Edit README.md line 11: agents-17 → agents-18
833
625
  @mnemosyne Update README: added @ares agent, increment agent count to 18
834
626
  ```
835
627
 
836
- ```
837
- # Wrong — session output as files
838
- Create IMPLEMENTATION_SUMMARY.md with what we did
839
-
840
- # Right — use the memory bank
841
- @mnemosyne Append to 02-progress-log.md: [summary of what was completed]
842
- ```
843
-
844
628
  ---
845
629
 
846
630
  ## Extending the Framework
847
631
 
848
632
  ### Adding a new agent
849
633
 
850
- 1. Create `agents/<name>.agent.md` with YAML frontmatter (tools, model, handoffs)
634
+ 1. Create `src/agents/<name>.agent.md` with YAML frontmatter (tools, model, handoffs)
851
635
  2. Define behavioral rules and context boundaries
852
636
  3. Register with Zeus by adding it to his delegation list
853
637
  4. Test with a sample task
@@ -855,7 +639,7 @@ Create IMPLEMENTATION_SUMMARY.md with what we did
855
639
 
856
640
  ### Adding a new skill
857
641
 
858
- 1. Create `skills/<name>/SKILL.md` with YAML frontmatter
642
+ 1. Create `src/skills/<name>/SKILL.md` with YAML frontmatter
859
643
  2. Include 2–3 sentence overview, usage conditions, step-by-step examples
860
644
  3. Reference relevant agents in the skill body
861
645
  4. Invoke `@mnemosyne Update README skills table and count`
@@ -884,6 +668,8 @@ Create IMPLEMENTATION_SUMMARY.md with what we did
884
668
  - `log-session-start.sh` — audit trail of sessions (PostToolUse)
885
669
  - `on-subagent-delegation-stop.sh` — delegation cleanup (PostToolUse)
886
670
  - `validate-post-conditions.sh` — post-condition validation (event)
671
+ - `audit-imports.sh` — detects wildcard imports and suspicious patterns (PostToolUse)
672
+ - `run-type-check.sh` — runs mypy/tsc if config exists (PostToolUse)
887
673
 
888
674
  The `.opencode/plugins/pantheon-hooks.ts` plugin bridges these shell scripts to OpenCode events. OpenCode auto-discovers plugins from `.opencode/plugins/` when running from the project directory.
889
675
 
@@ -909,8 +695,8 @@ Simple endpoints: 2–4 hours. Full features (backend + frontend + DB): 6–8 ho
909
695
  systems: 20–30 hours across multiple sprint sessions.
910
696
 
911
697
  **What happens if my editor session is interrupted?**
912
- Open phases pause. The memory bank captures the last committed state. Resume by reading
913
- `01-active-context.md` at the start of the next session.
698
+ Open phases pause. The memory bank captures the last committed state. Resume by
699
+ invoking `@mnemosyne Recall` to retrieve the previous session context.
914
700
 
915
701
  ---
916
702
 
@@ -943,23 +729,17 @@ Pantheon draws from the broader multi-agent landscape while diverging in key way
943
729
  | [AGENTS.md](AGENTS.md) | Full agent reference — behavior, tools, constraints |
944
730
  | [CONTRIBUTING.md](CONTRIBUTING.md) | How to extend the framework |
945
731
  | [CHANGELOG.md](CHANGELOG.md) | Release history |
946
- | [docs/INSTALLATION.md](docs/INSTALLATION.md) | Generic installation guide |
947
- | [docs/platforms/](docs/platforms/) | Platform-specific setup guides (OpenCode) |
732
+ | [docs/INSTALLATION.md](docs/INSTALLATION.md) | Installation guide |
948
733
  | [docs/platforms/opencode.md](docs/platforms/opencode.md) | OpenCode setup guide |
949
- | [agents/README.md](agents/README.md) | Agent directory |
950
- | [skills/README.md](skills/README.md) | Skill directory |
734
+ | [src/agents/README.md](src/agents/README.md) | Agent directory |
735
+ | [src/skills/README.md](src/skills/README.md) | Skill directory |
951
736
  | [docs/mcp-tools.md](docs/mcp-tools.md) | Canonical MCP tool registry |
952
737
  | [docs/mcp-user-guide.md](docs/mcp-user-guide.md) | Adding custom MCP servers |
953
738
  | [docs/mcp-recommendations.md](docs/mcp-recommendations.md) | Recommended MCP servers per project type |
954
739
  | [scripts/hooks/](scripts/hooks/) | Agent lifecycle hooks |
955
- | [skills/agent-coordination/SKILL.md](skills/agent-coordination/SKILL.md) | When to use which agent |
956
- | [skills/tdd-with-agents/SKILL.md](skills/tdd-with-agents/SKILL.md) | TDD standards and rules |
957
740
 
958
741
  ---
959
742
 
960
743
  **License:** MIT
961
744
  **Architecture Pattern:** Conductor-Delegate
962
745
  **Mythology:** Greek (Zeus, Athena, Apollo, Hermes, Aphrodite, Talos, Themis, Mnemosyne, Gaia, Hephaestus, Nyx, Prometheus, Demeter, Iris)
963
-
964
- ---
965
-
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pantheon-opencode",
3
- "version": "1.1.0",
3
+ "version": "1.1.1-beta.0",
4
4
  "description": "Multi-agent orchestration for OpenCode — 14 specialized agents, TDD, Themis review gates.",
5
5
  "publishConfig": {
6
6
  "access": "public",
@@ -48,10 +48,10 @@
48
48
  "src/instructions/*.instructions.md",
49
49
  "src/mcp/*.mjs",
50
50
  "scripts/*.mjs",
51
- "src/plugins/tui/**",
52
51
  "src/mcp/*.sh",
53
52
  "src/routing.yml",
54
53
  "src/mcp/requirements*",
54
+ "src/plugins/tui/**",
55
55
  "src/skills/**"
56
56
  ],
57
57
  "dependencies": {
@@ -264,6 +264,14 @@ export function installOpenCode(
264
264
  writeIfChanged(join(dstPluginDir, "package.json"), readFileSync(pkgSrc, "utf8"), dryRun)
265
265
  stats.created++
266
266
  }
267
+ // Install plugin dependencies (@opentui/core, @opentui/solid, solid-js)
268
+ if (!dryRun) {
269
+ try {
270
+ execSync('npm install --production --no-audit --no-fund', { cwd: dstPluginDir, stdio: 'pipe' })
271
+ } catch (e) {
272
+ console.warn(' ⚠️ Failed to install TUI plugin dependencies:', e.message)
273
+ }
274
+ }
267
275
 
268
276
  }
269
277
 
@@ -60,7 +60,7 @@ console.log(` Agents in routing.yml: ${routingAgents.length}`)
60
60
  // Get canonical agent files
61
61
  const agentsDir = join(ROOT, 'src', 'agents')
62
62
  const canonicalFiles = readdirSync(agentsDir)
63
- .filter((f) => f.endsWith('.md'))
63
+ .filter((f) => f.endsWith('.md') && f.toLowerCase() !== 'readme.md')
64
64
  .map((f) => f.replace('.md', ''))
65
65
  .sort()
66
66
 
@@ -0,0 +1,26 @@
1
+ # Agent Reference — Pantheon
2
+
3
+ This directory contains the definitions for all 14 Pantheon agents. Each agent is defined in a `.agent.md` file with YAML frontmatter specifying tools, model tier, capabilities, and delegation rules.
4
+
5
+ ## Agents
6
+
7
+ | Agent | File | Role |
8
+ |-------|------|------|
9
+ | @zeus | [zeus.agent.md](zeus.agent.md) | Central orchestrator |
10
+ | @athena | [athena.agent.md](athena.agent.md) | Strategic planner |
11
+ | @apollo | [apollo.agent.md](apollo.agent.md) | Investigation scout |
12
+ | @hermes | [hermes.agent.md](hermes.agent.md) | Backend specialist |
13
+ | @aphrodite | [aphrodite.agent.md](aphrodite.agent.md) | Frontend specialist |
14
+ | @demeter | [demeter.agent.md](demeter.agent.md) | Database specialist |
15
+ | @themis | [themis.agent.md](themis.agent.md) | Quality & security gate |
16
+ | @prometheus | [prometheus.agent.md](prometheus.agent.md) | Infrastructure specialist |
17
+ | @hephaestus | [hephaestus.agent.md](hephaestus.agent.md) | AI pipelines |
18
+ | @nyx | [nyx.agent.md](nyx.agent.md) | Observability |
19
+ | @gaia | [gaia.agent.md](gaia.agent.md) | Remote sensing |
20
+ | @iris | [iris.agent.md](iris.agent.md) | GitHub operations |
21
+ | @mnemosyne | [mnemosyne.agent.md](mnemosyne.agent.md) | Memory bank |
22
+ | @talos | [talos.agent.md](talos.agent.md) | Hotfix agent |
23
+
24
+ ## Full Reference
25
+
26
+ See [AGENTS.md](../../AGENTS.md) for the complete agent reference with roles, capabilities, and invocation patterns.
@@ -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