pantheon-opencode 1.1.0 → 1.1.1-beta.1

package/AGENTS.md

@@ -25,7 +25,7 @@ This project uses the Pantheon multi-agent framework with 14 specialized agents.
 
 See [INSTALLATION.md](docs/INSTALLATION.md) for setup instructions.
 
-- Build: `npm run build`
+- Build: `npm test`
 - Test: `npm test`
 - Lint: `npm run lint`
 

package/README.md

@@ -1,19 +1,13 @@
-<p align="center">
-  <img src="images/logo.png" alt="Pantheon Logo" width="500"/>
-</p>
 
 <h1 align="center">Pantheon</h1>
 
 <p align="center">
   <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-v1.0.0-blue" alt="Version"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
-  <a href="docs/platforms/"><img src="https://img.shields.io/badge/platforms-opencode-green" alt="Platforms"></a>
-  <a href="agents/README.md"><img src="https://img.shields.io/badge/agents-14-purple" alt="Agents"></a>
-  <a href="skills/README.md"><img src="https://img.shields.io/badge/skills-14-orange" alt="Skills"></a>
-  <a href="commands/"><img src="https://img.shields.io/badge/commands-14-red" alt="Commands"></a>
-  <a href="docs/platforms/"><img src="https://img.shields.io/badge/built%20with-opencode-8250DF" alt="Built with"></a>
+  <a href="src/agents/README.md"><img src="https://img.shields.io/badge/agents-14-purple" alt="Agents"></a>
+  <a href="src/skills/README.md"><img src="https://img.shields.io/badge/skills-21-orange" alt="Skills"></a>
+  <a href="commands/"><img src="https://img.shields.io/badge/commands-11-red" alt="Commands"></a>
   <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>
-  <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>
 </p>
 
 **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.
 
 ---
 
-## 📋 v1.0 Changelog
-
-| Sprint | Feature |
-|--------|--------|
-| 1 | Memory Commands (/pantheon-remember, search, consolidate, forget) |
-| 2 | @pantheon/cli npm package |
-| 3 | Themis 2.0 (3-layer review + IntentGate) |
-| 4 | Background Agents + TODO Enforcer + Hash Edits |
-| 5 | Memory Simplification (agents read-only, WAL) |
-| 6 | YAGNI + Anti-overengineering (12 patterns) |
-
-**🏆 Themis audit: 100/100**  
-**🗑️ 9 commands removed:** ping, stop-continuation, subtask, manifest, forge, mirrordeps, praxis, metamorphosis, reflect  
-**✨ 14 commands total** — all `/pantheon-*`
-
 ## Quick Links
 
 | Resource | Link |
 |----------|------|
-| 📖 **Agent Reference** | [agents/README.md](agents/README.md) — all 14 agents |
-| 📖 **Skills Reference** | [skills/README.md](skills/README.md) — all 14 skills |
+| 📖 **Agent Reference** | [src/agents/README.md](src/agents/README.md) — all 14 agents |
+| 📖 **Skills Reference** | [src/skills/README.md](src/skills/README.md) — all 21 skills |
 | 🚀 **Installation Guide** | [docs/INSTALLATION.md](docs/INSTALLATION.md) |
-| 🔌 **MCP Servers** | [docs/mcp-recommendations.md](docs/mcp-recommendations.md) — recommended MCP servers for each project type |
+| 🔌 **MCP Server Guide** | [docs/mcp-recommendations.md](docs/mcp-recommendations.md) — recommended MCP servers for each project type |
 | 🔌 **MCP Tool Registry** | [docs/mcp-tools.md](docs/mcp-tools.md) — canonical MCP tool reference |
 | 🔌 **MCP User Guide** | [docs/mcp-user-guide.md](docs/mcp-user-guide.md) — adding custom MCP servers |
-| 🗂️ **MCP Tiers** | `.pantheon/tiers.json` — 4-tier MCP selection (none/essential/recommended/full) |
 | ⚡ **Quick Start** | [docs/QUICKSTART.md](docs/QUICKSTART.md) |
-| ⚡ **OpenCode** | [docs/platforms/opencode.md](docs/platforms/opencode.md) |
+| ⚡ **OpenCode Guide** | [docs/platforms/opencode.md](docs/platforms/opencode.md) |
 
 ---
 
@@ -316,7 +294,7 @@ Domain Specialist
   └── Gaia — remote sensing: LULC analysis, scientific literature
 ```
 
-> See [agents/README.md](agents/README.md) for the complete reference — each agent's
+> See [src/agents/README.md](src/agents/README.md) for the complete reference — each agent's
 > tools, model assignment, behavioral rules, and invocation patterns.
 
 ### Architecture Diagram
@@ -384,60 +362,38 @@ graph TB
     style T4 fill:#1a1a1a,stroke:#2d3748,stroke-width:1px
     style T5 fill:#1a1a1a,stroke:#2d3748,stroke-width:1px
 ```
+## Memory System
 
-<p align="center">
-  <img src="images/Schema.png" alt="Pantheon System Architecture" width="100%"/>
-</p>
-
----
-
-## 🧠 Level 3 Vector Memory (v4.0)
-
-Pantheon v1.0.0 introduces a persistent two-tier memory system with semantic retrieval:
+Pantheon uses a two-tier memory architecture to maintain context across sessions:
 
-### Tier 1 — Auto-Indexed Memory (`/memories/repo/`)
-Agent memory is automatically indexed at zero token cost. Every agent writes atomic facts on discovery:
-- Tech stack, conventions, build commands
-- Architectural decisions and patterns
-- Cross-component relationships
+| Tier | Description | Content |
+|------|-------------|---------|
+| **Tier 1 — Session** | Auto-managed by Zeus via agent subtask summaries | Current plans, work-in-progress, agent outputs |
+| **Tier 2 — Reference** | Instruction files in `src/instructions/` | Domain standards, communication rules, protocol definitions |
 
-### Tier 2 — Compressed Context (`.pantheon/memory-bank/`)
-On-demand compression pipeline archives completed phases into structured context:
-- **Priority scoring** — CRITICAL/HIGH/LOW budget allocation (deterministic, no LLM)
-- **ZZ artifacts** — compressed phase context for agent-to-agent handoff
-- **Cross-reference index** (`_xref/index.md`) — entity/decision lookup
+Agent memory is automatically indexed at zero token cost — every agent writes atomic facts
+on discovery (tech stack, conventions, architectural decisions). Zeus persists all agent
+returns via write-ahead log, ensuring no context is lost between phases.
 
-### Usage
-```bash
-@mnemosyne Recall "<feature description>" --top-k 5   # Retrieve past decisions
-@mnemosyne Close sprint: "<summary>"                    # Archive and compress
-```
-
-### Benefits
-- 🚫 No more lost context between phases
-- 🧩 Past decisions surface automatically before planning
-- 💾 Zero manual memory management — agents self-index
-- 🔄 Lossless recovery via git
+Architectural decisions are recorded as ADRs in `.pantheon/memory-bank/_notes/` and are
+permanently committed to the repository.
 
 ---
 
 ## Skill Ecosystem
 
-Pantheon bundles **14 cross-platform skills** — modular instruction sets that agents load
+Pantheon bundles **21 cross-platform skills** — modular instruction sets that agents load
 on demand to perform specialized tasks. Skills are organized into domains:
 
 | Domain | Skills |
 |---|---|
-| **Orchestration** | agent-coordination, artifact-management, tdd-with-agents, auto-continue, session-goal, task-system, handoff, orchestration-workflow |
-| **Backend & API** | api-design-patterns, fastapi-async-patterns, database-migration, database-optimization |
-| **Frontend** | frontend-analyzer, nextjs-seo-optimization |
-| **Infrastructure** | docker-best-practices, streaming-patterns, cache-strategy |
-| **Planning & Design** | plan-architecture, codemap, init-deep, interview, metis-gap-analysis |
-| **Memory & Context** | memory-bank, file-prompts, context-compression |
-| **Domain** | remote-sensing-analysis, internet-search |
-| **Utilities** | prompt-improver, agent-evaluation, agent-observability, wisdom-accumulation, simplify, test-architecture, token-audit |
-
-> See [skills/README.md](skills/README.md) for the complete reference with descriptions
+| **Orchestration & Workflow** | agent-coordination, artifact-management, auto-continue, context-compression, memory-bank, orchestration-workflow, session-goal |
+| **Development Tools** | clonedeps, git-workflow-and-versioning, incremental-implementation, loop-engineering, reflect, simplify, worktrees |
+| **Quality & Security** | code-review-checklist, security-hardening, tdd-with-agents |
+| **Planning** | codemap, spec-driven-development, verification-planning |
+| **Frontend Development** | visual-review-pipeline |
+
+> See [src/skills/README.md](src/skills/README.md) for the complete reference with descriptions
 > and usage patterns.
 
 ---
@@ -455,42 +411,6 @@ subscription (OpenCode Go, Copilot Pro, Claude Pro, etc.).
 | `coding` | Heavy coding tasks | Hermes, Aphrodite, Demeter, Prometheus, Hephaestus, Talos | DeepSeek V4 Flash, Claude Sonnet |
 | `fast` | Quick, cheap ops | Apollo, Iris, Mnemosyne, Talos, Nyx | DeepSeek V4 Flash, MiniMax M2.7, Gemini Flash |
 
-### /forge — Model Presets
-
-Pantheon ships with **`/forge`** — a model configuration command that applies named presets from
-`built-in presets`. Each preset maps 4 tiers to concrete models across all 14 agents.
-
-**Usage:**
-```
-/forge opencode-go     ← Apply a preset (12 available)
-/forge default          ← Reset to account defaults (no models set)
-/forge list             ← List all available presets
-/forge status           ← Show current model configuration
-/forge deepseek-flash   ← Single model for all agents
-/forge --zeus anthropic/claude-opus-4-6  ← Override a single agent
-```
-
-**Available presets:**
-
-| Preset | Premium | Default | Coding | Fast | Requires |
-|--------|---------|---------|--------|------|----------|
-| `default` | — | — | — | — | Account defaults |
-| `opencode-go` | DeepSeek V4 Pro | Kimi K2.6 | DeepSeek V4 Flash | MiniMax M2.7 | OpenCode Go |
-| `deepseek-flash` | DeepSeek V4 Flash | DeepSeek V4 Flash | DeepSeek V4 Flash | DeepSeek V4 Flash | OpenCode Go |
-| `kimi` | Kimi K2.6 | Kimi K2.5 | Kimi K2.6 | MiniMax M2.7 | OpenCode Go |
-| `qwen` | Qwen3.6 Plus | Qwen3.5 Plus | Qwen3.6 Plus | DeepSeek V4 Flash | OpenCode Go |
-| `opencode-co` | DeepSeek V4 Pro | Kimi K2.6 | Kimi K2.6 | MiniMax M2.7 | OpenCode Go |
-| `claude-pro` | Claude Opus-4 🤔 | Claude Sonnet-4 🤔 | Claude Sonnet-4 🤔 | Claude Haiku-4 🤔 | Anthropic key |
-| `openai` | o3 (high) | GPT-4o | GPT-4o | GPT-4o-mini | OpenAI key |
-| `gemini` | Gemini 3.5 Flash | Gemini 2.5 Flash | Gemini 2.5 Flash | Gemini 3.1 Flash-Lite | Google AI key |
-| `github-copilot` | Claude Opus-4 | GPT-4o | GPT-4o | GPT-4o-mini | Copilot ($10/m) |
-| `byok-best` | Claude Opus-4 🤔 | GPT-4o | GPT-4o | GPT-4o-mini | Anthropic + OpenAI |
-| `together-moe` | DeepSeek V4 | Llama 4 Scout | Llama 4 Scout | Llama 3.2 3B | Together key |
-
-> 🤔 = thinking habilitado
-
-Built-in presets available (opencode-go, deepseek-flash, etc.) and `docs/platforms/` for per-platform setup guides.
-
 ---
 
 ## Quick Start
@@ -538,25 +458,17 @@ Type these in the OpenCode chat:
 
 | Command | Description |
 |---------|-------------|
-| `/pantheon` | Multi-perspective synthesis (Council) via inline agents |
+| `/pantheon` | Multi-perspective synthesis (Council) |
 | `/pantheon-audit` | Code review + security audit |
-| `/pantheon-bg` | List background tasks |
-| `/pantheon-consolidate` | Consolidate memory |
-| `/pantheon-deepwork` | Heavy multi-phase task with persisted checkpoints |
-| `/pantheon-doc` | Generate documentation |
+| `/pantheon-deepwork` | Heavy multi-phase task |
 | `/pantheon-focus` | Pin a session goal |
 | `/pantheon-forget` | Compress/consolidate memories |
-| `/pantheon-hash` | Hash edit verification |
-| `/pantheon-optimize` | Context optimization & token audit |
+| `/pantheon-optimize` | Context optimization |
+| `/pantheon-reflect` | Reflect on workflow friction |
 | `/pantheon-remember` | Store in memory |
 | `/pantheon-search` | Search memory |
-| `/pantheon-status` | Show system health and agent status |
-| `/pantheon-todo` | Create and maintain task list |
-
-
-### TUI Sidebar Plugin (OpenCode) — Temporarily Disabled
-
-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.
+| `/pantheon-status` | System health and agent status |
+| `/pantheon-verify` | Hash edit verification |
 
 ---
 
@@ -564,175 +476,74 @@ The TUI Sidebar Plugin is currently disabled. It will be re-enabled in a future
 
 ```
 pantheon/
-├── README.md                  — this file
-├── AGENTS.md                  — full agent reference
-├── CHANGELOG.md               — release history
-├── CONTRIBUTING.md            — how to extend
-├── LICENSE                    — MIT
-├── package.json               — sync & install tooling
-├── opencode.json              — OpenCode platform config
-├── plugin.json                — marketplace plugin manifest
-│
-├── agents/                    — 14 agent definitions (.agent.md)
-│   ├── zeus.agent.md          — orchestrator
-│   ├── athena.agent.md        — strategic planner
-
-│   ├── apollo.agent.md        — codebase & web discovery
-│   ├── nyx.agent.md           — observability
-│   ├── hermes.agent.md        — backend APIs
-│   ├── aphrodite.agent.md     — frontend UI
-│   ├── demeter.agent.md       — database
-│   ├── themis.agent.md        — quality & security review
-│   ├── prometheus.agent.md    — infrastructure
-│   ├── iris.agent.md          — GitHub operations
-│   ├── mnemosyne.agent.md     — memory & documentation
-│   ├── talos.agent.md         — hotfixes
-│   ├── gaia.agent.md          — remote sensing
-│   ├── hephaestus.agent.md    — AI pipelines
-│   └── README.md
-│
-├── skills/                    — 14 cross-platform skill modules
-│   ├── README.md
-│   ├── agent-coordination/    * orchestration & coordination
-│   ├── artifact-management/
-│   ├── auto-continue/
-│   ├── handoff/
-│   ├── orchestration-workflow/
-│   ├── session-goal/
-│   ├── task-system/
-│   ├── tdd-with-agents/
-│   ├── api-design-patterns/   * backend & API
-│   ├── fastapi-async-patterns/
-│   ├── database-migration/
-│   ├── database-optimization/
-│   ├── frontend-analyzer/     * frontend
-│   ├── nextjs-seo-optimization/
-│   ├── rag-pipelines/         * AI pipelines
-│   ├── mcp-server-development/
-│   ├── docker-best-practices/ * infrastructure
-│   ├── streaming-patterns/
-│   ├── cache-strategy/
-│   ├── security-audit-pro/    * security & quality
-│   ├── code-review-checklist/
-│   ├── mcp-security/
-│   ├── quality-gate/
-│   ├── memory-bank/           * memory & context
-│   ├── codemap/
-│   ├── init-deep/
-│   ├── file-prompts/
-│   ├── context-compression/
-│   ├── plan-architecture/     * planning & design
-│   ├── interview/
-│   ├── metis-gap-analysis/
-│   ├── remote-sensing-analysis/ * domain
-│   ├── internet-search/
-│   ├── prompt-improver/       * utilities
-│   ├── agent-evaluation/
-│   ├── agent-observability/
-│   ├── simplify/
-│   ├── test-architecture/
-│   ├── token-audit/
-│   ├── wisdom-accumulation/
-│   └── */SKILL.md
+├── README.md
+├── AGENTS.md
+├── CHANGELOG.md
+├── CONTRIBUTING.md
+├── LICENSE
+├── package.json
+├── opencode.json
+├── plugin.json
+├── tsconfig.json
 │
-├── instructions/              — 10 domain coding standards
-│   ├── agent-return-format.instructions.md
-│   ├── backend-standards.instructions.md
-│   ├── code-quality-checks.instructions.md
-│   ├── database-standards.instructions.md
-│   ├── documentation-standards.instructions.md
-│   ├── frontend-standards.instructions.md
-│   ├── infra-standards.instructions.md
-│   ├── zeus-anti-stall.instructions.md
-│   ├── zeus-communication-rules.instructions.md
-│   ├── zeus-council-synthesis.instructions.md
-│   └── zeus-timeout-retry.instructions.md
+├── src/
+│   ├── agents/               — 14 agent definitions (.md)
+│   ├── instructions/         — 9 instruction files
+│   ├── skills/               — 21 skill modules (SKILL.md)
+│   ├── pantheon/             — BackgroundJobBoard, auto-wake, persistence
+│   ├── mcp/                  — MCP server implementations
+│   ├── plugins/              — OpenCode plugin integrations
+│   ├── plugin.ts             — OpenCode plugin entry
+│   └── routing.yml           — canonical routing config
 │
-├── prompts/                   — 13 agent invocation prompts
-│   ├── implement-feature.prompt.md
-│   ├── orchestrate-with-zeus.prompt.md
-│   ├── debug-issue.prompt.md
-│   ├── plan-architecture.prompt.md
-│   ├── optimize-database.prompt.md
-│   ├── sketch.prompt.md
-│   ├── focus.prompt.md
-│   ├── quick-discovery-large-codebase.prompt.md
-│   ├── quick-plan-large-feature.prompt.md
-│   ├── semantic-summarize.md
-│   ├── README.md
-│   └── dynamic/                * generated prompts
+├── tests/
+│   ├── pantheon/             — BackgroundJobBoard + persistence tests
+│   ├── integration/          — integration tests
+│   └── *.py / *.mjs          — pytest + Vitest test suites
 │
-├── platform/                  — OpenCode-only configuration
-│   ├── optimize-context.sh    * context optimization script
-│   └── opencode/              * OpenCode configs
-│
-├── scripts/                   — tooling, automation & lifecycle hooks
-│   ├── postinstall.mjs        * npm post-install hook
-│   ├── doctor.mjs             * health check CLI
-│   
-│   ├── validate-sync.mjs      * sync integrity check
-│       └── hooks/                 * agent lifecycle hooks (10 .sh scripts)
-│       ├── audit-imports.sh
-│       ├── format-multi-language.sh
-│       ├── log-session-start.sh
-│       ├── on-subagent-delegation-start.sh
-│       ├── on-subagent-delegation-stop.sh
-│       ├── run-type-check.sh
-│       ├── scan-secrets.sh
-│       ├── validate-post-conditions.sh
-│       ├── validate-talos-scope.sh
-│       └── validate-tool-safety.sh
-│
-├── commands/                  # 14 interaction commands
-│   ├── cancel.md
+├── commands/                 — 11 interaction commands
+│   ├── pantheon.md
 │   ├── pantheon-audit.md
 │   ├── pantheon-deepwork.md
 │   ├── pantheon-focus.md
-│   ├── pantheon-install.md
-│   ├── pantheon-metamorphosis.md
+│   ├── pantheon-forget.md
 │   ├── pantheon-optimize.md
 │   ├── pantheon-reflect.md
-│   ├── pantheon-sketch.md
+│   ├── pantheon-remember.md
+│   ├── pantheon-search.md
 │   ├── pantheon-status.md
-│   ├── pantheon-update.md
-│   ├── pantheon.md
+│   └── pantheon-verify.md
 │
-├── docs/
-│   ├── INSTALLATION.md        — generic installation guide
-│   ├── SETUP.md               — step-by-step tutorial
-│   ├── PLATFORMS.md           — platform comparison
-│   ├── RELEASING.md           — versioning & release process
-│   ├── INDEX.md               — documentation index
-│   ├── platforms/             — OpenCode configuration guide
-│   │   └── opencode.md
-│   └── memory-bank/           — project memory (Mnemosyne's domain)
-│       ├── 00-project.md      * project overview
-│       ├── 01-active-context.md * current sprint focus (priority file)
-│       ├── 02-progress-log.md * completed milestones (append-only)
-│       ├── _notes/            * architectural decisions (ADRs)
-│       └── _tasks/            * sprint task records
+├── scripts/
+│   ├── hooks/                — 10 agent lifecycle hooks
+│   ├── vector_memory/        — Level 3 vector memory system
+│   ├── versioning.mjs        — release versioning
+│   ├── validate-routing.mjs  — routing validation
+│   ├── doctor.mjs            — health check CLI
+│   └── ...
 │
-├── template/                  — project templates
-
-│   └── README.md
+├── docs/
+│   ├── INSTALLATION.md
+│   ├── SETUP.md
+│   ├── QUICKSTART.md
+│   ├── RELEASING.md
+│   ├── platforms/
+│   └── ...
 │
-├── logs/                      — agent session audit logs
+├── prompts/                  — 12 invocation prompts
 │
 ├── .github/
 │   ├── copilot-instructions.md
-│   └── workflows/             * CI/CD workflows (9 workflows)
-│       ├── ci.yml             * main CI pipeline
-│       ├── conformance-matrix.yml   * automated release creation
-│       ├── release.yml        * release workflow
-│       ├── release-gate.yml   * version sync enforcement
-│       ├── pr.yml             * pull request checks
-│       ├── commit-lint.yml    * conventional commit enforcement
-│       ├── docs.yml           * documentation build
-│       ├── codeql.yml         * security scanning
-│       └── sync-check.yml     * platform sync integrity
+│   └── workflows/            — 7 CI/CD workflows
+│       ├── ci.yml
+│       ├── beta-release.yml
+│       ├── auto-release.yml
+│       ├── commit-lint.yml
+│       ├── codeql.yml
+│       ├── docs.yml
+│       └── hotfix.yml
 │
-├── .vscode/                   — VS Code workspace settings
-└── node_modules/              — npm dependencies
+└── .vscode/                  — VS Code workspace settings
 ```
 
 ---
@@ -781,25 +592,6 @@ For trivial fixes (CSS typos, simple logic bugs), bypass the full orchestration:
 
 ---
 
-## Memory System
-
-Pantheon uses a two-tier memory architecture to maintain context across sessions:
-
-| Tier | Location | Content | Access Cost |
-|---|---|---|---|
-| **Tier 1 — Native** | `/memories/repo/` | Atomic facts (stack, conventions, commands) | Zero (auto-loaded) |
-| **Tier 2 — Reference** | `.pantheon/memory-bank/` | Project overview, architecture, active sprint, decisions | Read cost per file |
-| **Session** | `/memories/session/` | Current conversation plans, work-in-progress | One read per session |
-
-`01-active-context.md` is the priority file. Agents read it first when starting any task.
-It contains the current sprint focus, the most recent architectural decision, active
-blockers, and next steps.
-
-Architectural decisions are recorded as ADRs in `.pantheon/memory-bank/_notes/` and are
-permanently committed to the repository.
-
----
-
 ## Documentation Maintenance
 
 **Mnemosyne is the documentation owner.** She maintains the README, CHANGELOG, memory
@@ -813,15 +605,15 @@ to Mnemosyne so counts stay accurate and consistent.
 | Agent added or removed | `@mnemosyne Update README agent count and tier overview` |
 | Skill added or removed | `@mnemosyne Update README skills table and count` |
 | Version bump | `@mnemosyne Update README version badge and CHANGELOG` |
-| Sprint close | `@mnemosyne Update 01-active-context.md and append to 02-progress-log.md` |
+| Sprint close | `@mnemosyne Archive and compress current sprint context` |
 | Architectural decision | `@mnemosyne Document decision: [topic]` |
 | Task record needed | `@mnemosyne Create task record: [feature] complete` |
 
 ### What CI enforces automatically
 
-`release-gate.yml` validates that the version number is consistent across all manifests
-(`package.json`, `plugin.json`, `CHANGELOG.md`, and the README badge) on every release.
-If they diverge, the release is blocked until Mnemosyne reconciles them.
+`auto-release.yml` validates version consistency across all manifests (`package.json`,
+`plugin.json`, `CHANGELOG.md`, and the README badge) before publishing. If they diverge,
+the release is blocked until Mnemosyne reconciles them.
 
 ### Anti-patterns
 
@@ -833,21 +625,13 @@ Edit README.md line 11: agents-17 → agents-18
 @mnemosyne Update README: added @ares agent, increment agent count to 18
 ```
 
-```
-# Wrong — session output as files
-Create IMPLEMENTATION_SUMMARY.md with what we did
-
-# Right — use the memory bank
-@mnemosyne Append to 02-progress-log.md: [summary of what was completed]
-```
-
 ---
 
 ## Extending the Framework
 
 ### Adding a new agent
 
-1. Create `agents/<name>.agent.md` with YAML frontmatter (tools, model, handoffs)
+1. Create `src/agents/<name>.agent.md` with YAML frontmatter (tools, model, handoffs)
 2. Define behavioral rules and context boundaries
 3. Register with Zeus by adding it to his delegation list
 4. Test with a sample task
@@ -855,7 +639,7 @@ Create IMPLEMENTATION_SUMMARY.md with what we did
 
 ### Adding a new skill
 
-1. Create `skills/<name>/SKILL.md` with YAML frontmatter
+1. Create `src/skills/<name>/SKILL.md` with YAML frontmatter
 2. Include 2–3 sentence overview, usage conditions, step-by-step examples
 3. Reference relevant agents in the skill body
 4. Invoke `@mnemosyne Update README skills table and count`
@@ -884,6 +668,8 @@ Create IMPLEMENTATION_SUMMARY.md with what we did
 - `log-session-start.sh` — audit trail of sessions (PostToolUse)
 - `on-subagent-delegation-stop.sh` — delegation cleanup (PostToolUse)
 - `validate-post-conditions.sh` — post-condition validation (event)
+- `audit-imports.sh` — detects wildcard imports and suspicious patterns (PostToolUse)
+- `run-type-check.sh` — runs mypy/tsc if config exists (PostToolUse)
 
 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.
 
@@ -909,8 +695,8 @@ Simple endpoints: 2–4 hours. Full features (backend + frontend + DB): 6–8 ho
 systems: 20–30 hours across multiple sprint sessions.
 
 **What happens if my editor session is interrupted?**
-Open phases pause. The memory bank captures the last committed state. Resume by reading
-`01-active-context.md` at the start of the next session.
+Open phases pause. The memory bank captures the last committed state. Resume by
+invoking `@mnemosyne Recall` to retrieve the previous session context.
 
 ---
 
@@ -943,23 +729,17 @@ Pantheon draws from the broader multi-agent landscape while diverging in key way
 | [AGENTS.md](AGENTS.md) | Full agent reference — behavior, tools, constraints |
 | [CONTRIBUTING.md](CONTRIBUTING.md) | How to extend the framework |
 | [CHANGELOG.md](CHANGELOG.md) | Release history |
-| [docs/INSTALLATION.md](docs/INSTALLATION.md) | Generic installation guide |
-| [docs/platforms/](docs/platforms/) | Platform-specific setup guides (OpenCode) |
+| [docs/INSTALLATION.md](docs/INSTALLATION.md) | Installation guide |
 | [docs/platforms/opencode.md](docs/platforms/opencode.md) | OpenCode setup guide |
-| [agents/README.md](agents/README.md) | Agent directory |
-| [skills/README.md](skills/README.md) | Skill directory |
+| [src/agents/README.md](src/agents/README.md) | Agent directory |
+| [src/skills/README.md](src/skills/README.md) | Skill directory |
 | [docs/mcp-tools.md](docs/mcp-tools.md) | Canonical MCP tool registry |
 | [docs/mcp-user-guide.md](docs/mcp-user-guide.md) | Adding custom MCP servers |
 | [docs/mcp-recommendations.md](docs/mcp-recommendations.md) | Recommended MCP servers per project type |
 | [scripts/hooks/](scripts/hooks/) | Agent lifecycle hooks |
-| [skills/agent-coordination/SKILL.md](skills/agent-coordination/SKILL.md) | When to use which agent |
-| [skills/tdd-with-agents/SKILL.md](skills/tdd-with-agents/SKILL.md) | TDD standards and rules |
 
 ---
 
 **License:** MIT  
 **Architecture Pattern:** Conductor-Delegate  
 **Mythology:** Greek (Zeus, Athena, Apollo, Hermes, Aphrodite, Talos, Themis, Mnemosyne, Gaia, Hephaestus, Nyx, Prometheus, Demeter, Iris)
-
----
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pantheon-opencode",
-  "version": "1.1.0",
+  "version": "1.1.1-beta.1",
   "description": "Multi-agent orchestration for OpenCode — 14 specialized agents, TDD, Themis review gates.",
   "publishConfig": {
     "access": "public",
@@ -48,10 +48,10 @@
     "src/instructions/*.instructions.md",
     "src/mcp/*.mjs",
     "scripts/*.mjs",
-    "src/plugins/tui/**",
     "src/mcp/*.sh",
     "src/routing.yml",
     "src/mcp/requirements*",
+    "src/plugins/tui/**",
     "src/skills/**"
   ],
   "dependencies": {

package/scripts/install/opencode.mjs

@@ -3,6 +3,7 @@
  * opencode.mjs — OpenCode platform installer
  */
 
+import { execSync } from 'node:child_process'
 import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { join, resolve } from 'node:path'
@@ -264,6 +265,14 @@ export function installOpenCode(
       writeIfChanged(join(dstPluginDir, "package.json"), readFileSync(pkgSrc, "utf8"), dryRun)
       stats.created++
     }
+    // Install plugin dependencies (@opentui/core, @opentui/solid, solid-js)
+    if (!dryRun) {
+      try {
+        execSync('npm install --production --no-audit --no-fund', { cwd: dstPluginDir, stdio: 'pipe' })
+      } catch (e) {
+        console.warn('    ⚠️  Failed to install TUI plugin dependencies:', e.message)
+      }
+    }
 
   }
 

package/scripts/validate-routing.mjs

@@ -60,7 +60,7 @@ console.log(`  Agents in routing.yml: ${routingAgents.length}`)
 // Get canonical agent files
 const agentsDir = join(ROOT, 'src', 'agents')
 const canonicalFiles = readdirSync(agentsDir)
-  .filter((f) => f.endsWith('.md'))
+  .filter((f) => f.endsWith('.md') && f.toLowerCase() !== 'readme.md')
   .map((f) => f.replace('.md', ''))
   .sort()
 

package/src/agents/README.md

@@ -0,0 +1,26 @@
+# Agent Reference — Pantheon
+
+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.
+
+## Agents
+
+| Agent | File | Role |
+|-------|------|------|
+| @zeus | [zeus.agent.md](zeus.agent.md) | Central orchestrator |
+| @athena | [athena.agent.md](athena.agent.md) | Strategic planner |
+| @apollo | [apollo.agent.md](apollo.agent.md) | Investigation scout |
+| @hermes | [hermes.agent.md](hermes.agent.md) | Backend specialist |
+| @aphrodite | [aphrodite.agent.md](aphrodite.agent.md) | Frontend specialist |
+| @demeter | [demeter.agent.md](demeter.agent.md) | Database specialist |
+| @themis | [themis.agent.md](themis.agent.md) | Quality & security gate |
+| @prometheus | [prometheus.agent.md](prometheus.agent.md) | Infrastructure specialist |
+| @hephaestus | [hephaestus.agent.md](hephaestus.agent.md) | AI pipelines |
+| @nyx | [nyx.agent.md](nyx.agent.md) | Observability |
+| @gaia | [gaia.agent.md](gaia.agent.md) | Remote sensing |
+| @iris | [iris.agent.md](iris.agent.md) | GitHub operations |
+| @mnemosyne | [mnemosyne.agent.md](mnemosyne.agent.md) | Memory bank |
+| @talos | [talos.agent.md](talos.agent.md) | Hotfix agent |
+
+## Full Reference
+
+See [AGENTS.md](../../AGENTS.md) for the complete agent reference with roles, capabilities, and invocation patterns.

package/src/skills/README.md

@@ -4,177 +4,110 @@
 
 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.
 
-There are **37 skills** divided into **9 domains**.
+There are **21 skills** divided into **5 domains**.
 
 ## Skills by Domain
 
 ### Domain 1: Orchestration & Workflow
 
-1. **agent-coordination** — `skills/agent-coordination/SKILL.md`
-   - Master guide to the multi-agent system with category routing, model selection, and sprint management for rapid, TDD-driven feature development.
-   - Used by: Zeus, Athena
+1. **agent-coordination** — `agent-coordination/SKILL.md`
+   - Multi-agent orchestration with model routing, category delegation, and sprint management.
+   - Used by: Zeus
 
-2. **artifact-management** — `skills/artifact-management/SKILL.md`
-   - Complete guide to the artifact trail system — plans directory structure, templates, and best practices for documenting feature implementations.
-   - Used by: Zeus, Mnemosyne
-
-3. **memory-bank** — `skills/memory-bank/SKILL.md`
-   - Complete guide to Pantheon memory bank — structure, rules, optimization, session→active-context graduation, and compression strategies.
-   - Used by: Mnemosyne, All agents
-
-   - Audit a repository for token waste — find redundant context files, measure baseline, and recommend optimizations.
-   - Used by: Mnemosyne, Zeus
-
-   - Load prompts from external files with path expansion so prompt content stays version-controlled and reusable.
-   - Used by: All agents
-
-### Domain 2: AI & Machine Learning
+2. **artifact-management** — `artifact-management/SKILL.md`
+   - Structured artifact trail for feature implementations — plans, implementations, reviews, and decisions.
+   - Used by: Zeus, Mnemosyne, Iris
 
-4. **rag-pipelines** — `skills/rag-pipelines/SKILL.md`
-   - RAG architecture, chunking strategies, embedding models, vector store selection, retrieval optimization, context window management, hallucination mitigation, and evaluation frameworks (faithfulness, answer relevance).
-   - Used by: Hephaestus
+3. **auto-continue** — `auto-continue/SKILL.md`
+   - Auto-continue through todos with idle detection and safety gates for multi-step orchestration.
+   - Used by: Zeus, Apollo, Hephaestus, Nyx, Gaia
 
-5. **streaming-patterns** — `skills/streaming-patterns/SKILL.md`
-   - Server-Sent Events (SSE), WebSocket connections, LLM token streaming, chunked transfer encoding, backpressure handling, reconnection strategies, and real-time update patterns for observability pipelines.
-   - Used by: Nyx
+4. **context-compression** — `context-compression/SKILL.md`
+   - Level 2 — Pantheon-native context compression with priority scoring, semantic summarization, budget allocation, and cross-references.
+   - Used by: Zeus, Mnemosyne, Themis
 
-6. **agent-evaluation** — `skills/agent-evaluation/SKILL.md`
-   - 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.
-   - Used by: Hephaestus, Themis
+5. **memory-bank** — `memory-bank/SKILL.md`
+   - Memory bank rules, structure, and optimization — complete guide to Pantheon memory management.
+   - Used by: Mnemosyne, Athena
 
-   - 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.
-   - Used by: Themis, Hephaestus
+6. **orchestration-workflow** — `orchestration-workflow/SKILL.md`
+   - Practical step-by-step walkthrough for orchestrating features end-to-end using the multi-agent system, from planning through deployment.
+   - Used by: Zeus
 
-    - 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.
-    - Used by: Hephaestus
-
-### Domain 3: Backend Development
+7. **session-goal** — `session-goal/SKILL.md`
+   - Pin session objectives to prevent scope creep across long multi-agent sessions.
+   - Used by: Zeus, Mnemosyne
 
-12. **fastapi-async-patterns** — `skills/fastapi-async-patterns/SKILL.md`
-    - 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.
-    - Used by: Hermes
+### Domain 2: Development Tools
 
-13. **api-design-patterns** — `skills/api-design-patterns/SKILL.md`
-    - 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.
-    - Used by: Hermes
+8. **clonedeps** — `clonedeps/SKILL.md`
+   - Clones dependency source locally so agents can inspect library internals, understand behavior, and debug integration issues.
+   - Used by: Hermes, Hephaestus
 
-### Domain 4: Frontend Development
+9. **git-workflow-and-versioning** — `git-workflow-and-versioning/SKILL.md`
+   - Atomic commits, conventional commits, trunk-based development workflow.
+   - Used by: Hermes, Prometheus, Iris
 
-14. **frontend-analyzer** — `skills/frontend-analyzer/SKILL.md`
-    - 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.
-    - Used by: Aphrodite
+10. **incremental-implementation** — `incremental-implementation/SKILL.md`
+    - Implement in thin vertical slices — one commit per task, testable, rollback-safe.
+    - Used by: Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos
 
-15. **nextjs-seo-optimization** — `skills/nextjs-seo-optimization/SKILL.md`
-    - 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.
-    - Used by: Aphrodite
+11. **loop-engineering** — `loop-engineering/SKILL.md`
+    - Iterative refinement pattern for complex problems — solve, review, improve, repeat in controlled cycles.
+    - Used by: All agents
 
-### Domain 5: Database & Storage
+12. **reflect** — `reflect/SKILL.md`
+    - Turns repeated workflow friction into reusable skills, agents, or configuration improvements.
+    - Used by: All agents
 
-16. **database-migration** — `skills/database-migration/SKILL.md`
-    - 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.
-    - Used by: Demeter
+13. **simplify** — `simplify/SKILL.md`
+    - Behavior-preserving code simplification for readability, maintainability, and reduced complexity.
+    - Used by: All agents
 
-17. **database-optimization** — `skills/database-optimization/SKILL.md`
-    - 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.
-    - Used by: Demeter, Prometheus
+14. **worktrees** — `worktrees/SKILL.md`
+    - Git worktrees as safe, isolated coding lanes for risky or parallel work without affecting the main workspace.
+    - Used by: All agents
 
-### Domain 6: Quality & Security
+### Domain 3: Quality & Security
 
-18. **code-review-checklist** — `skills/code-review-checklist/SKILL.md`
-    - 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.
+15. **code-review-checklist** — `code-review-checklist/SKILL.md`
+    - Systematic code review with quality gates, security audit, and parallel checks for structured feedback.
     - Used by: Themis
 
-19. **security-audit-pro** — `skills/security-audit-pro/SKILL.md`
-    - Professional security audit — SAST, SCA, container security, SBOM, PII detection, and compliance (GDPR, LGPD, HIPAA).
-    - Used by: Themis, Hermes, Demeter
-
-20. **tdd-with-agents** — `skills/tdd-with-agents/SKILL.md`
-    - TDD lifecycle enforcement (RED → GREEN → REFACTOR), test-first development across all layers, advanced testing patterns (E2E, load, mutation, contract, visual regression), coverage thresholds (>80%).
-    - Used by: Hermes, Aphrodite, Demeter, Themis
-
-21. **docker-best-practices** — `skills/docker-best-practices/SKILL.md`
-    - 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.
-    - Used by: Prometheus
-
-22. **mcp-server-development** — `skills/mcp-server-development/SKILL.md`
-    - 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.
-    - Used by: Hephaestus, Prometheus, Nyx
-
-23. **agent-observability** — `skills/agent-observability/SKILL.md`
-    - 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.
-    - Used by: Nyx, Prometheus
+16. **security-hardening** — `security-hardening/SKILL.md`
+    - Security gate — OWASP, SAST, secrets detection, MCP hardening, dependency audit.
+    - Used by: Themis, Nyx
 
-24. **cache-strategy** — `skills/cache-strategy/SKILL.md`
-    - Cache architecture patterns — Redis (read-through, write-through, write-behind), CDN, TTL strategies, invalidation patterns, session stores.
-    - Used by: Demeter, Hermes
+17. **tdd-with-agents** — `tdd-with-agents/SKILL.md`
+    - TDD enforcement with RED→GREEN→REFACTOR cycle and advanced testing patterns across all layers.
+    - Used by: Hermes, Aphrodite, Demeter, Themis, Hephaestus
 
-### Domain 8: Domain Specialists
+### Domain 4: Planning
 
-25. **remote-sensing-analysis** — `skills/remote-sensing-analysis/SKILL.md`
-    - 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.
-    - Used by: Gaia
-
-26. **internet-search** — `skills/internet-search/SKILL.md`
-    - 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.
-    - Used by: Athena, Apollo, Gaia, Zeus
-
-27. **prompt-improver** — `skills/prompt-improver/SKILL.md`
-    - 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.
-    - Used by: All agents
-
-28. **interview** — `skills/interview/SKILL.md`
-    - 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.
-    - Used by: Athena, Zeus
-    - Domain: Planning
-
-29. **session-goal** — `skills/session-goal/SKILL.md`
-    - 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.
-    - Used by: Zeus, Athena
-    - Domain: Orchestration
-
-30. **auto-continue** — `skills/auto-continue/SKILL.md`
-    - 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).
-    - Used by: Zeus, Hermes, Aphrodite, Demeter
-    - Domain: Orchestration
-
-31. **metis-gap-analysis** — `skills/metis-gap-analysis/SKILL.md`
-    - 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.
-    - Used by: Athena, Zeus
-    - Domain: Planning
-
-32. **codemap** — `skills/codemap/SKILL.md`
-    - Hierarchical codebase map generation — directory trees, entry points, module relationships and dependency analysis.
+18. **codemap** — `codemap/SKILL.md`
+    - Generates hierarchical repository maps so agents understand codebase structure without re-reading every file.
     - Used by: Apollo, Zeus
 
-33. **init-deep** — `skills/init-deep/SKILL.md`
-    - Generate hierarchical AGENTS.md files throughout the project directory tree. Each directory gets context-specific instructions for agents working in that scope.
-    - Used by: Athena, Prometheus
-    - Domain: Planning
-
-34. **handoff** — `skills/handoff/SKILL.md`
-    - Generate structured session handoff for continuing work in a new session. Captures current state, what was done, what remains, decisions, and relevant files.
-    - Used by: All agents
-    - Domain: Orchestration
+19. **spec-driven-development** — `spec-driven-development/SKILL.md`
+    - Define requirements via spec-first before any code — PRD, edge cases, acceptance criteria.
+    - Used by: Athena
 
-35. **task-system** — `skills/task-system/SKILL.md`
-    - File-backed task management with dependencies (blockedBy/blocks), automatic parallel execution, and session persistence. For complex work with 3+ interdependent tasks.
-    - Used by: Zeus, Athena
-    - Domain: Orchestration
+20. **verification-planning** — `verification-planning/SKILL.md`
+    - Plans an evidence path before non-trivial changes, ensuring changes are testable and verifiable.
+    - Used by: Athena, Zeus
 
-    - Extract and pass learnings between implementation waves — conventions, successes, failures, gotchas, and commands. Temporary, scoped to feature, deleted after merge.
-    - Used by: All agents
-    - Domain: Utilities
+### Domain 5: Frontend Development
 
-    - Plan feature architecture with component breakdown, data flow, and dependency mapping. Use before implementation to define contracts between layers.
-    - Used by: Athena, Zeus
-    - Domain: Planning
+21. **visual-review-pipeline** — `visual-review-pipeline/SKILL.md`
+    - Automated visual review pipeline — Playwright screenshots, self-analysis, fix loop, escalation.
+    - Used by: Aphrodite
 
 ## Skills File Structure
 
 Each skill follows a consistent layout:
 
 ```
-skills/[skill-name]/
+src/skills/[skill-name]/
 ├── SKILL.md          — main reference document (YAML frontmatter + content)
 ├── scripts/          — optional helper scripts (if any)
 └── 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
 
 | # | Skill Name | Domain | Used By |
 |---|------------|--------|---------|
-| 1 | agent-coordination | Orchestration & Workflow | Zeus, Athena |
-| 2 | artifact-management | Orchestration & Workflow | Zeus, Mnemosyne |
-| 3 | memory-bank | Orchestration & Workflow | Mnemosyne, All agents |
-| 6 | auto-continue | Orchestration | Zeus, Hermes, Aphrodite, Demeter |
-| 7 | session-goal | Orchestration | Zeus, Athena |
-| 8 | task-system | Orchestration | Zeus, Athena |
-| 9 | rag-pipelines | AI & Machine Learning | Hephaestus |
-
-| 12 | agent-evaluation | AI & Machine Learning | Hephaestus, Themis |
-| 15 | fastapi-async-patterns | Backend Development | Hermes |
-| 16 | api-design-patterns | Backend Development | Hermes |
-| 17 | frontend-analyzer | Frontend Development | Aphrodite |
-| 18 | nextjs-seo-optimization | Frontend Development | Aphrodite |
-| 19 | database-migration | Database & Storage | Demeter |
-| 20 | database-optimization | Database & Storage | Demeter, Prometheus |
-| 21 | cache-strategy | Database & Storage | Demeter, Hermes |
-| 22 | code-review-checklist | Quality & Security | Themis |
-| 23 | security-audit-pro | Quality & Security | Themis, Hermes, Demeter |
-| 24 | tdd-with-agents | Quality & Security | Hermes, Aphrodite, Demeter, Themis |
-| 25 | docker-best-practices | Infrastructure & DevOps | Prometheus |
-| 26 | mcp-server-development | Infrastructure & DevOps | Hephaestus, Prometheus, Nyx |
-| 27 | agent-observability | Infrastructure & DevOps | Nyx, Prometheus |
-| 28 | remote-sensing-analysis | Domain Specialists | Gaia |
-| 29 | internet-search | Domain Specialists | Athena, Apollo, Gaia, Zeus |
-| 30 | prompt-improver | Domain Specialists | All agents |
-| 31 | interview | Planning | Athena, Zeus |
-| 32 | metis-gap-analysis | Planning | Athena, Zeus |
-| 33 | codemap | Planning | Apollo, Zeus |
-| 34 | init-deep | Planning | Athena, Prometheus |
-| 35 | handoff | Utilities | All agents |
+| 1 | agent-coordination | Orchestration & Workflow | Zeus |
+| 2 | artifact-management | Orchestration & Workflow | Zeus, Mnemosyne, Iris |
+| 3 | auto-continue | Orchestration & Workflow | Zeus, Apollo, Hephaestus, Nyx, Gaia |
+| 4 | context-compression | Orchestration & Workflow | Zeus, Mnemosyne, Themis |
+| 5 | memory-bank | Orchestration & Workflow | Mnemosyne, Athena |
+| 6 | orchestration-workflow | Orchestration & Workflow | Zeus |
+| 7 | session-goal | Orchestration & Workflow | Zeus, Mnemosyne |
+| 8 | clonedeps | Development Tools | Hermes, Hephaestus |
+| 9 | git-workflow-and-versioning | Development Tools | Hermes, Prometheus, Iris |
+| 10 | incremental-implementation | Development Tools | Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos |
+| 11 | loop-engineering | Development Tools | All agents |
+| 12 | reflect | Development Tools | All agents |
+| 13 | simplify | Development Tools | All agents |
+| 14 | worktrees | Development Tools | All agents |
+| 15 | code-review-checklist | Quality & Security | Themis |
+| 16 | security-hardening | Quality & Security | Themis, Nyx |
+| 17 | tdd-with-agents | Quality & Security | Hermes, Aphrodite, Demeter, Themis, Hephaestus |
+| 18 | codemap | Planning | Apollo, Zeus |
+| 19 | spec-driven-development | Planning | Athena |
+| 20 | verification-planning | Planning | Athena, Zeus |
+| 21 | visual-review-pipeline | Frontend Development | Aphrodite |
 
 ---