openhermes 2.8.0 → 4.0.1

package/CONTEXT.md

@@ -0,0 +1,18 @@
+# OpenHermes — Shared Language
+
+## Terms
+**OpenHermes** — OpenCode-native orchestration layer for this package.
+**Skill** — A `SKILL.md` loaded on demand through OpenCode's skill tool.
+**Command** — A slash command backed by package-local markdown in `harness/commands/`.
+**Agent** — A primary or subagent definition loaded through OpenCode config.
+**Instruction** — Markdown loaded through `AGENTS.md` or `opencode.json` instructions.
+**Bootstrap** — The first-message context injected by the OpenHermes plugin.
+
+## Relationships
+- OpenHermes contains many Skills, Commands, Agents, and Instructions.
+- Skills are invoked on demand.
+- Commands are entry points.
+- OpenHermes is the default primary Agent.
+
+## Flagged Ambiguities
+- Durable state is deferred for now and not a domain term for this pass.

package/ETHOS.md

@@ -0,0 +1,15 @@
+# OpenHermes Ethos
+
+Four immutable principles. Every skill, every command, every session.
+
+## Native First
+OpenCode-native loading over manual copying or hidden state.
+
+## Small Surface
+Every file earns its keep. Prefer markdown when behavior is declarative.
+
+## Skills Over Glue
+Behavior lives in `SKILL.md`, `commands/*.md`, and `agents/*.md`.
+
+## Delegate Hard Work
+Subagents for substantive work. Main context orchestrates and verifies.

package/README.md

@@ -1,292 +1,135 @@
-<p align="center">
-  <h1 align="center">&#9764; OpenHermes</h1>
-  <p align="center"><i>The Constitutional Router for <a href="https://opencode.ai">OpenCode</a></i></p>
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/openhermes"><img src="https://img.shields.io/npm/v/openhermes?style=for-the-badge&label=version&color=FFD700" alt="npm version"></a>
-  <a href="https://github.com/nathwn12/openhermes/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" alt="License: MIT"></a>
-  <a href="https://opencode.ai"><img src="https://img.shields.io/badge/runs%20on-OpenCode-6366f1?style=for-the-badge" alt="Runs on OpenCode"></a>
-  <a href="https://github.com/nathwn12/openhermes/issues"><img src="https://img.shields.io/badge/issues-welcome-orange?style=for-the-badge" alt="Issues welcome"></a>
-</p>
-
----
-
-```json
-{ "plugin": ["openhermes"] }
-```
-
-**One line. Your agent gains a personality, memory, 25 specialist subagents, 28 commands, structured handoff protocol, and the discipline to self-improve.**
-
-No Python. No Docker. No cron. No database. Just Node.js and your existing OpenCode runtime.
-
----
-
-## What OpenHermes Does For Your Agent
-
-<table>
-<tr><td width="180"><b>&#129302; Constitutional Spine</b></td><td>A 14-principle constitution (<code>CONSTITUTION.md</code>) injected into every session — pragmatic, concise, subagent-first, verify-don't-claim, adaptive. Your agent stops rambling and starts delivering.</td></tr>
-<tr><td><b>&#128204; Structured Handoff Protocol</b></td><td>Every agent knows its permission tier and handoff triggers. Review agents never edit. Builders never approve their own work. Security reports only. Tasks are complexity-graded (easy → very-large) and routed to the right specialist automatically.</td></tr>
-<tr><td><b>&#128190; 9-Class Durable Memory</b></td><td>Checkpoints, decisions, constraints, instincts, mistakes, backlog items, audit reports, verification receipts, and session recall — all schema-validated, fingerprint-aware, persisted to disk. Retrieval is gated and precision-first.</td></tr>
-<tr><td><b>&#128260; Closed Learning Loop</b></td><td>Mistakes are logged with root cause + prevention rule. Complex sessions auto-generate skill-candidate backlogs. Strike tracking escalates repeat failures into structural fixes. The agent gets better — you don't teach it twice.</td></tr>
-<tr><td><b>&#128736; 10 Bundled Procedural Skills</b></td><td>Pre-built skills for API design, backend patterns, coding standards, E2E testing, frontend patterns, frontend slides, security reviews, strategic compaction, TDD workflow, and verification loops. Auto-discovered — use <code>skill</code> to list and load.</td></tr>
-<tr><td><b>&#128270; Context Pruner</b></td><td>Agent-controlled compression via <code>ohc.json</code> + <code>compress</code> tool. Progressive nudges at 70/85/95%. No token claims — reports message count only.</td></tr>
-<tr><td><b>&#129513; Zero Infrastructure</b></td><td>No Python. No uv. No Docker. No PostgreSQL. No gateway. No cron daemon. No MCP server. Just Node.js and your existing OpenCode runtime.</td></tr>
-</table>
-
----
-
-## Agent Handoff Protocol
-
-The reason most agent sessions descend into chaos: every agent thinks it can do everything. OpenHermes fixes that with a **structured handoff system** baked into every subagent prompt.
-
-**Coverage:** All 25 subagents now include standard Permissions and Handoff sections. Each agent knows its tier (1/2/3), what actions it can take, when to delegate, and how to format a handoff request.
-
-**Complexity-gated routing:**
-
-| Level | Criteria | Strategy |
-|-------|----------|----------|
-| **Easy** | 1-2 files, well-known pattern, single change | Handle directly |
-| **Medium** | 3-10 files, new feature, needs exploration | 2-5 subagents, sequential or fan-out |
-| **Hard** | 10+ files, cross-cutting change | Sequential: planner → executor → reviewers |
-| **Very Large** | 50+ files, massive refactor | Fan-out: split into chunks, parallel, consolidate |
-
-**Permission tiers:**
-
-| Tier | Agents | Can edit? | Can exec? | Can review? |
-|------|--------|-----------|-----------|-------------|
-| 1 | planners, architects, reviewers, explore | ❌ | ❌ | ✅ |
-| 2 | builders, doc-updaters, refactor-cleaners | ✅ | ✅ | ❌ (own work) |
-| 3 | primary agent, loop-operator, e2e-runner | ✅ | ✅ | ✅ |
-
-**Built library** — `lib/handoff.mjs` (136 lines, 5 exports): `handoffRequest`, `parseHandoffResult`, `assessComplexity`, `suggestAgent`, `canAgent`. Simple enough to audit. Sophisticated enough to govern 25 agents.
-
----
-
-## Setup
-
-Add one line to your `opencode.json`:
-
-### Published Release (stable)
-```json
-{ "plugin": ["openhermes"] }
-```
-
-### Git-Backed (latest pushed changes)
-```json
-{ "plugin": ["openhermes@git+https://github.com/nathwn12/openhermes.git"] }
-```
-
-Either way, **no other config needed.** The plugin auto-registers:
-
-| What | Details |
-|------|---------|
-| **25 subagents** | 7 core (architect, planner, build-error-resolver, code-reviewer, security-reviewer, e2e-runner, explore) + 18 specialist (tdd-guide, docs-lookup, doc-updater, refactor-cleaner, loop-operator, harness-optimizer, 9 language-specific build/review pairs, review-database) |
-| **28 slash commands** | `/build-fix`, `/checkpoint`, `/code-review`, `/doctor`, `/eval`, `/go-build`, `/go-review`, `/harness-audit`, `/learn`, `/loop-start`, `/loop-status`, `/memory-search`, `/model-route`, `/ohc`, `/orchestrate`, `/plan`, `/quality-gate`, `/refactor-clean`, `/rust-build`, `/rust-review`, `/security`, `/setup-pm`, `/skill-create`, `/test-coverage`, `/update-codemaps`, `/update-docs`, `/update-me`, `/verify` |
-| **6 native memory tools** | `ohc_save`, `ohc_get`, `ohc_list`, `ohc_latest`, `ohc_search`, `ohc_archive` — in-process, no MCP server |
-| **10 procedural skills** | API design, backend patterns, coding standards, E2E testing, frontend patterns, frontend slides, security review, strategic compaction, TDD workflow, verification loop |
-| **6 lifecycle plugins** | bootstrap, curator, autorecall, skill-builder, memory-tools, ohc |
-
-> **&#128260; Force update:** Run `/update-me` anytime to clear stale cache and reload from source. Works with both git-backed and npm installs.
-
-<details>
-<summary><b>What happens on your next session</b></summary>
-
-1. **Config hook** — BootstrapPlugin registers 25 subagents, 28 commands, 10 skill paths
-2. **Chat transform** — Constitution + Runtime + Router injected into first user message
-3. **Session created** — AutorecallPlugin builds recall cache from prior session memory
-4. **Tools execute** — SkillBuilderPlugin watches calls; MemoryToolsPlugin provides 6 native tools immediately
-5. **Session idle** — CuratorPlugin snapshots checkpoint + verification receipt
-6. **Session error** — CuratorPlugin logs mistake with root cause + prevention rule
-7. **Compaction** — CuratorPlugin force-writes pre-compaction checkpoint and injects state into compaction buffer
-
-No polling. No cron. Six plugins, 20+ hooks, one runtime.
-</details>
-
----
-
-## Memory Architecture
-
-Nine schema-validated classes. All scrubbed of proto-poison, secrets, and overflow before hitting disk.
-
-| Class | Format | Layer | Purpose |
-|-------|--------|-------|---------|
-| `checkpoint` | JSON | 🧠 State | Pre-compaction snapshots: mission, state, next actions, blockers |
-| `constraint` | JSON | 🧠 State | Hard limits, env realities, safety rules |
-| `decision` | JSON | 🧠 State | Durable project choices shaping all future behavior |
-| `instinct` | JSON | 📈 Learning | Reusable trigger→action patterns with hit tracking |
-| `backlog` | JSON | 📈 Learning | Evidence-backed self-improvement items with acceptance criteria |
-| `mistake` | JSONL | 📈 Learning | Failure registry: type, root cause, fix, prevention, strike count |
-| `audit` | JSON | ✅ Integrity | Structured quality evaluations with health scores |
-| `verification_receipt` | JSON | ✅ Integrity | Cached verification results keyed by artifact fingerprint |
-| `recall` | JSON | ✅ Integrity | Session-start cache for compaction buffer injection |
-
-**Storage:** `~/.local/share/opencode/openhermes/` for durable memory, `~/.cache/opencode/openhermes/recall/` for derived cache, `~/.config/opencode/ohc.json` for pruner config.
-
-**Retrieval ladder:** `ohc_latest` → `ohc_search` → `ohc_get` → `ohc_list`. Anti-spam: no obvious facts, no one-off prefs, no low-risk mistakes. Memory stays lean or it gets archived.
-
-**Hardening:** Every record is sanitized, redacted, truncated, and validated before write. Proto-poison (`__proto__`, `constructor`, `prototype`) stripped. Bearer tokens / API keys / passwords redacted. Fields capped by schema limits.
-
----
-
-## Self-Healing Escalation
-
-A mistake is not a failure — it's a signal. OpenHermes escalates through four tiers before it ever reaches you.
-
-```
-T0 ── Any mistake
-      Observe → log mistake record → smallest safe correction → verify
-
-T1 ── Same mistake repeats within 7 days
-      Add prevention rule → targeted verification
-
-T2 ── Prevention failed / systemic issue
-      Delegate to specialist → deep audit → backlog item → structural fix
-
-T3 ── Cascading failures
-      Constrained safe mode: narrow claims, preserve receipts, produce handoff
-```
-
-No self-termination. No grandstanding. The agent gets better — you don't teach it twice.
-
----
-
-## Session Lifecycle
-
-Three phases. Six plugins coordinate across 20+ OpenCode hooks.
-
-```
-▶️  Warmup
-    config hook          BootstrapPlugin registers harness/skills/, skills auto-discover
-    session.created      BootstrapPlugin injects constitution → router → runtime
-                         AutorecallPlugin loads disk memory → writes recall cache
-                         SkillBuilderPlugin resets counters
-
-⚙️  Execution
-    tool.execute.*       SkillBuilderPlugin counts calls + spawns
-
-⏹️  Cooldown
-    session.idle         CuratorPlugin: checkpoint snapshot + verification receipt
-                         SkillBuilderPlugin: complexity check → backlog candidate
-    session.compacting   CuratorPlugin: force-writes pre-compaction checkpoint
-                         Injects harness state + recall context → compaction buffer
-    session.compacted    CuratorPlugin: updates loop-state to "compacted"
-    session.error        CuratorPlugin: logs mistake (type, root cause, fix, prevention)
-    permission.replied   CuratorPlugin: writes audit record for every permission decision
-```
-
----
-
-## Verification Discipline
-
-One core habit — **verify before claiming success.**
-
-| Rule | Why |
-|------|-----|
-| 🕵️ Read before editing | Don't fix what you haven't seen |
-| 🧪 Run before announcing | Don't claim what you haven't tested |
-| 🧬 Cache by fingerprint | Same file, same receipt — skip re-verify |
-| 🔄 Re-verify on change | Stale receipt is worse than no receipt |
-| 🚩 Flag contradictions | Silence is consent to bugs |
-
-Verification receipts are a first-class memory type — keyed by artifact identity + fingerprint (path, mtime, hash). This is not an afterthought. It's the difference between "I think it works" and "I know it works."
-
----
-
-## Bundled Harness
-
-The full operational doctrine ships inside the package. Six directories, zero dependencies outside Node.js.
-
-| Directory | Contents | Purpose |
-|-----------|----------|---------|
-| `codex/` | `CONSTITUTION.md` — 14 immutable principles | Your agent's behavior, frozen per session |
-| `instructions/` | Runtime workflow + coding conventions | The playbook every session runs on |
-| `rules/` | 17 files: retrieval, verification, audit, self-heal, delegation, handoff | The legal framework — no ambiguity |
-| `skills/` | 10 procedural SKILL.md files | Domain expertise discovered automatically |
-| `prompts/` | 25 subagent prompt templates | Language specialists, docs lookup, loop drivers — all on tap |
-| `commands/` | 26 slash command templates | From `/verify` to `/review-go` — full toolbelt |
-
-OpenHermes is not a runtime shim. The doctrine ships with the package — every subagent and every command follows the same constitution, rules, and conventions.
-
----
-
-## The Six Plugins
-
-| Plugin | Hook Points | Job |
-|--------|-------------|-----|
-| **Bootstrap** | `config`, `chat.transform` | Registers agents/commands/skills; injects constitution + router + runtime |
-| **MemoryTools** | (tool registration) | Provides 6 `ohc_*` tools — no MCP server, no network |
-| **Curator** | `session.idle`, `.error`, `.compacted`, `.compacting`, `permission.replied` | Snapshots state, logs mistakes, records decisions, injects into compaction |
-| **Autorecall** | `session.created` | Loads prior session memory into recall cache at startup |
-| **SkillBuilder** | `session.created`, `.idle`, `tool.execute.after` | Auto-detects complex sessions (8+ calls or 2+ spawns) → backlog candidates |
-| **OhcPlugin** | `config`, all transform/command hooks | Silent context pruner; injects budget; progressive nudges; `/ohc` command + `compress` tool |
-
----
-
-## Architecture — Three Layers, One Dependency
-
-```
-openhermes/
-│
-├── ⚡ index.mjs              # Plugin exports (all 5)
-├── ⚡ bootstrap.mjs          # Config hook + chat.transform
-├── ⚡ autorecall.mjs         # Memory → recall cache
-├── ⚡ curator.mjs            # Lifecycle hooks engine
-├── ⚡ skill-builder.mjs      # Complexity detection
-│
-├── ⚡ lib/
-│   ├── memory-tools-plugin.mjs   # 5 hm_* tools
-│   ├── handoff.mjs               # Structured delegation protocol
-│   ├── hardening.mjs             # sanitize, redact, atomic write
-│   ├── paths.mjs                 # storage root resolver
-│   ├── schema-validator.mjs      # Draft-07 validation
-│   └── ohc/                      # context pruner
-│
-├── ⚡ schemas/               # 9 Draft-07 memory schemas
-│
-├── 📦 harness/
-│   ├── codex/                # CONSTITUTION.md — 14 principles
-│   ├── instructions/         # runtime + conventions
-│   ├── rules/                # 17 files (handoff.md + 16 existing)
-│   ├── skills/               # 10 procedural skills
-│   ├── prompts/              # 25 subagent templates
-│   └── commands/             # 26 slash command templates
-│
-└── 📦 package.json           # one dependency: @opencode-ai/plugin
-```
-
-**Dependency footprint:** `@opencode-ai/plugin` only. No postinstall scripts. No native compilation. No Docker. No Python. Your entire agent OS in a single `npm install`.
-
----
-
-## Why OpenHermes ≠ Hermes Agent
-
-Same messenger emoji. Entirely different mediums.
-
-| | Hermes Agent | OpenHermes |
-|-|------------|------------|
-| Platform | Standalone agent — TUI + gateway + cron | OpenCode-native plugin — lives *inside* your editor |
-| Installation | Python 3.11 + uv + 30+ deps — 5-15 min | `npm i` — 3 seconds |
-| Infrastructure | Long-running gateway, cron daemon, 20 platform adapters, 7 terminal backends, SQLite+FTS5 | Zero sidecars — everything is a plugin hook |
-| Memory | MEMORY.md + USER.md files + optional Honcho | 9-class schema-validated, fingerprint-aware, in-process tools |
-| Skills | agentskills.io standard, auto-creation + self-improvement | SKILL.md progressive disclosure, auto-detected |
-| Subagents | N/A | 25 specialists with handoff protocol, permission tiers, phase management |
-| Philosophy | "The self-improving agent" — feature-rich, platform-expansive | **"The constitutional router"** — discipline-first, precision-only |
-
-Both are &#9764; messengers. Different mediums.
-
----
-
-## Contributing
-
-Problems, ideas, improvements? [Open an issue](https://github.com/nathwn12/openhermes/issues). PRs welcome.
-
----
-
-## License
-
-MIT — see [LICENSE](LICENSE). All credited inspirations are independent implementations — no code copied. ECC and Hermes Agent are MIT. DCP is AGPL-3.0 but shared concepts (compress, dedup, purge) are uncopyrightable ideas (17 U.S.C. § 102(b); *Computer Assocs. v. Altai*, 982 F.2d 693). AGPL copyleft requires copying or adapting the work (§ 0) — independent implementation does not trigger it.
-
-<p align="center">
-  <sub><b>&#9764;</b> Built with discipline. Inspired by <a href="https://github.com/NousResearch/hermes-agent">Hermes Agent</a> (MIT), <a href="https://github.com/affaan-m/everything-claude-code">ECC</a> (MIT), and <a href="https://github.com/Opencode-DCP/opencode-dynamic-context-pruning">DCP</a> (AGPL-3.0). Built for <a href="https://opencode.ai">OpenCode</a>.</sub>
-</p>
+<p align="center">
+  <h1 align="center">&#9764; OpenHermes</h1>
+  <p align="center"><i>Plan. Build. Ship. One plugin.</i></p>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/openhermes"><img src="https://img.shields.io/npm/v/openhermes?style=for-the-badge&label=version&color=FFD700" alt="npm version"></a>
+  <a href="https://github.com/nathwn12/openhermes/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" alt="License: MIT"></a>
+  <a href="https://opencode.ai"><img src="https://img.shields.io/badge/runs%20on-OpenCode-6366f1?style=for-the-badge" alt="Runs on OpenCode"></a>
+</p>
+
+---
+
+OpenHermes is an OpenCode plugin that gives your agent a complete skill system out of the box. Add one line to `opencode.json`, get 25 skills, a primary orchestrator, and a shared operating model.
+
+```json
+{ "plugin": ["openhermes@git+https://github.com/nathwn12/openhermes.git"] }
+```
+
+No setup. No file copying. No extra dependencies.
+
+---
+
+## What you get
+
+### Seven core skills
+
+| Skill | What it does |
+|---|---|
+| **oh-planner** | Brainstorm, analyze architecture, run strategy reviews, auto-decide 90% of questions with gstack decision principles. Produces a consumable plan artifact. |
+| **oh-builder** | Prototype, TDD red-green-refactor, design interfaces in parallel sub-agents, implement from plan. Vertical tracer bullets, one test at a time. |
+| **oh-manifest** | Full build loop: planner → builder → verify → loop until done or a real blocker is surfaced. Auto-resolves intermediate questions; only interrupts you for genuine blockers. |
+| **oh-gauntlet** | Multi-axis testing gauntlet: unit tests, dual-axis review (Standards + Spec in parallel sub-agents), edge case sweep, QA tier, canary post-deploy. |
+
+These seven form a pipeline: **think → plan → build → test → ship → secure → monitor**. Each produces artifacts the next consumes.
+
+### Twenty-five skills total
+
+| Skill | Purpose |
+|---|---|
+| oh-planner, oh-builder, oh-manifest, oh-gauntlet | Core pipeline (above) |
+| oh-expert | AI self-diagnosis vocabulary — sycophancy, hallucination type, attention degradation |
+| oh-grill | Stress-test plans through Socratic questioning; optionally updates CONTEXT.md, ADRs, and extracts ubiquitous language |
+| oh-plan-review | Multi-lens plan review: Engineering, Design, DX, Strategy |
+| oh-security | Security audit: secrets archaeology, supply chain, CI/CD, OWASP, STRIDE, LLM security |
+| oh-health | Code quality dashboard: wraps tools, composite score, trend tracking |
+| oh-investigate | Systematic bug diagnosis |
+| oh-handoff | Compact session into structured handoff artifact for another agent |
+| oh-skill-craft | Create new skills for the harness (meta-skill) |
+| oh-init | Initialize project: scaffold CONTEXT.md, AGENTS.md, ADRs, issue tracker config, triage labels |
+| oh-retro | Retrospective after shipping |
+| oh-review | Two-axis review (Standards + Spec) in parallel sub-agents + architecture deepening |
+| oh-ship | PR, version bump, changelog, post-ship docs sync |
+| oh-triage | Issue triage state machine |
+| oh-issue | Break plans into vertical-slice issues |
+| oh-prd | Write structured PRDs |
+| oh-caveman | Ultra-compressed response mode |
+| oh-freeze | Freeze dependencies |
+| oh-learn | Learn patterns from the codebase |
+| oh-guard | Safety confirmations for destructive operations |
+| oh-skills-link | Verify skills discovery |
+| oh-skills-list | List available skills |
+
+### One orchestrator agent
+
+OpenHermes is the default primary agent — a hub-and-spoke commander that delegates to skills, spawns sub-agents for isolated context, and surfaces blockers instead of silently retrying.
+
+### One diagnostic command
+
+`/oh-doctor` — inspect plugin load, skills discovery, command/agent registration, and config safety.
+
+---
+
+## How it works
+
+OpenHermes loads through OpenCode's native plugin system. On install:
+
+1. `config.skills.paths` is pointed at the package-local `harness/skills/` — skills load on demand through the `skill` tool, no preloading
+2. Commands from `harness/commands/` register as slash commands
+3. The agent manifest in `harness/agents/` sets OpenHermes as the primary orchestrator
+4. Instructions from `CONSTITUTION.md`, `RUNTIME.md`, `CONTEXT.md`, and `ETHOS.md` are injected into every session
+
+Everything is package-local. Nothing is copied into your global config.
+
+---
+
+## OptiRoute: Smart Auto-Routing Protocol
+
+Every skill routes to the next based on outcome — pass, fail, or blocker. OptiRoute is a guard layer on top of that graph. Three rules:
+
+**Loop guard.** Tracks routing depth. If the same skill is visited 3+ times in one chain, or 5+ hops pass without measurable progress (new artifact, changed target), routing stops. No infinite loops.
+
+**Question gate.** Before each routing hop, the protocol checks whether the next skill's inputs are satisfied. If the task is underspecified or information is missing, it asks the user instead of routing into uncertainty.
+
+**Auto-handoff.** When the loop guard triggers, it writes an OptiRoute report into `plan.md` — the routing chain, the trigger threshold, current state, and the blocker. Then it surfaces the blocker and awaits direction.
+
+```md
+OPTIROUTE STOP: 5-hop ceiling reached, no progress
+Chain: planner → grill → planner → builder → gauntlet → planner
+See .opencode/plan.md for full report
+```
+
+No loops. No guessing. No silent death.
+
+---
+
+## Layout
+
+```
+openhermes-pkg/
+├── AGENTS.md              # Skill/command/agent inventory
+├── CONTEXT.md             # Shared language
+├── ETHOS.md               # Operating principles
+├── bootstrap.mjs          # Plugin loader — registers everything
+├── index.mjs              # Package entrypoint
+├── harness/
+│   ├── agents/            # Agent manifests (OpenHermes)
+│   ├── codex/             # CONSTITUTION.md
+│   ├── commands/          # Slash command manifests (/oh-doctor)
+│   ├── instructions/      # RUNTIME.md, CONVENTIONS.md
+│       └── skills/            # 25 skill SKILL.md files
+└── test/
+```
+
+---
+
+## Inspiration
+
+OpenHermes merges high-signal patterns from:
+
+- **superpowers** — skill loading model (config.skills.paths + bootstrap injection)
+- **dictionary-of-ai-coding** — shared vocabulary for agent self-diagnosis
+- **skills (mattpocock)** — TDD discipline, write-a-skill meta, design-an-interface parallel sub-agents, dual-axis review
+- **gstack** — preamble-tier seniority, artifact-chain pipeline, decision principles
+- **opencode-orchestrator** — hub-and-spoke delegation, session pool discipline, pipelined verification