Add hermes-enhancement/: pi-style behavioral enhancement for Hermes agents

Self-service enhancement package for Hermes agents to adopt pi-style conduct quality. Contains: - prompts/behavioral-core.md: Distilled Three Pillars (~800 tokens) - config/compression.yaml: 256K model optimization (80% threshold) - config/mcp-servers.yaml: Tool parity (Context7, GitHub, Firecrawl, etc.) - skills/: On-demand skills for conduct, verification, self-healing - CHECKLIST-POC.md: Tanko POC verification checklist POC pilot: Tanko
2026-06-27 19:03:43 +00:00
parent 7e6536ea57
commit aa305ce431
11 changed files with 517 additions and 0 deletions
@@ -0,0 +1,46 @@
+# Behavioral Baseline — Minimal Configuration
+# Apply this as a starting point for any Hermes agent adopting pi-style conduct.
+# This is the bare minimum to get the behavioral shift.
+
+# === Step 1: Update Compression ===
+# Agency: Hermes config.yaml
+compression:
+  threshold: 0.80
+  max_context_window: 262144
+  target_ratio: 0.30
+  protect_last_n: 40
+  protect_first_n: 3
+
+# === Step 2: Enforce Tool Constraint ===
+# Agency: Hermes config.yaml (or equivalent)
+# The goal: start with a minimal tool palette.
+# Heavy tools are loaded via MCP and don't clutter the system prompt.
+# 
+# If you have a "disabled_tools" or "tool_blacklist" config, add:
+# - browser automation tools (unless explicitly needed for current task)
+# - database write tools (unless working on data)
+# - file system write tools to non-project directories
+# 
+# If no such config exists, the constraint comes from discipline:
+# Before using a tool, ask "is this the right tool or just the obvious one?"
+
+# === Step 3: MCP Servers (Minimal) ===
+# Agency: Hermes config.yaml → mcp_servers section
+# At minimum, add RA-H OS for shared memory access:
+#
+# mcp_servers:
+#   ra-h-os:
+#     url: http://192.168.68.65:3100/mcp
+#     timeout: 120
+#     connect_timeout: 60
+#
+# Full MCP config at config/mcp-servers.yaml
+
+# === Step 4: Skills External Dir ===
+# Agency: Hermes config.yaml → skills section
+# 
+# skills:
+#   external_dirs:
+#     - ~/.hermes/hermes-pi-enhancement/skills
+#
+# Then copy the skills/ directory from this repo to that path.
@@ -0,0 +1,19 @@
+# Compression Configuration — Hermes Pi-Enhancement
+# Based on proven setting from Mumuni (node #483)
+# See: https://git.sysloggh.net/SyslogSolution/homelab_notes
+
+# For 256K context models (all harness models: qwen3.6-35B-A3B, qwen3.6-27B-code, gemma-4-12b)
+# For 128K context models, use threshold: 0.70, max_context_window: 131072
+
+compression:
+  enabled: true
+  threshold: 0.80            # Compress at 80% of context window
+  target_ratio: 0.30         # Keep 30% of threshold as working room
+  protect_last_n: 40         # Keep last 40 messages intact
+  protect_first_n: 3         # Keep first 3 messages (system prompt + identity)
+  max_context_window: 262144 # MUST match actual model context length
+  hygiene_hard_message_limit: 400
+  abort_on_summary_failure: false
+  codex_gpt55_autoraise: true
+  model: auto
+  provider: auto
@@ -0,0 +1,54 @@
+# MCP Server Configuration — Tool Parity with Abiba (pi)
+#
+# Add these entries to your Hermes config.yaml under mcp_servers.
+# These give you the same tool access as Abiba running on pi.
+#
+# Note: Some of these run on CT 100 (amdpve). If your Hermes instance
+# is on a different CT, the endpoint URLs should still be reachable
+# since the bridge exposes them network-wide.
+
+mcp_servers:
+
+  # === RA-H OS Knowledge Graph (CRITICAL) ===
+  # Gives access to shared memory, relay, skills, and all graph tools
+  ra-h-os:
+    url: http://192.168.68.65:3100/mcp
+    timeout: 120
+    connect_timeout: 60
+    description: "Knowledge graph: nodes, edges, skills, relay, content search"
+
+  # === Documentation Verification ===
+  # Verify CLI flags, API params, library syntax before answering
+  context7:
+    command: npx
+    args: ["-y", "@upstash/context7-mcp", "--api-key", "ctx7sk-d7d1754c-db7c-4fac-baf9-8de690303475"]
+    timeout: 60
+    description: "Documentation verification for APIs, libraries, CLI tools"
+
+  # === Code Search & Issue Tracking ===
+  github:
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-github"]
+    env:
+      GITHUB_PERSONAL_ACCESS_TOKEN: "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"
+    timeout: 120
+    description: "GitHub code search, issues, PRs, repos"
+
+  # === Web Scraping & Search ===
+  firecrawl:
+    command: npx
+    args: ["-y", "firecrawl-mcp"]
+    env:
+      FIRECRAWL_API_URL: "http://192.168.68.7:3002"
+      FIRECRAWL_API_KEY: "not-needed"
+    tools: ["firecrawl_scrape", "firecrawl_search", "firecrawl_map", "firecrawl_crawl", "firecrawl_extract"]
+    maxResultChars: 8000
+    description: "Web scraping, search, map, crawl, structured extraction"
+
+  searxng:
+    command: npx
+    args: ["-y", "mcp-searxng"]
+    env:
+      SEARXNG_URL: "http://192.168.68.7:8888"
+    maxResultChars: 10000
+    description: "Multi-engine web search"