Files
zulip-platform-plugins/hermes-enhancement/README.md
T
root 224ff326a8
CI / validate (push) Failing after 1s
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-24 21:15:42 +00:00

2.3 KiB

Hermes Enhancement — Pi-Style Agent Quality

Give your Hermes agent the focus and clarity of a pi coding agent — without leaving Hermes.

This directory is a self-service enhancement package for Hermes agents (Mumuni, Tanko, Koby, Koonimo). It distills the architectural philosophy that makes pi agents effective — constraint creates clarity — and adapts it for the Hermes framework.

Why

Pi agents deliver sharper results because of deliberate design choices:

  • 418-line core loop — tight orchestration, fast decisions
  • 4 built-in tools (read/write/edit/bash) — fewer choices = less confusion
  • System prompt under 1,000 tokens — less prompt noise = clearer reasoning
  • Skills loaded on-demand — knowledge isn't always in the context window
  • Extensions over features — capability added via MCP bridge, not permanently baked in

Hermes agents can adopt the same philosophy by trimming system prompts, constraining their default tool palette, and pulling knowledge into skills loaded on-demand.

Contents

hermes-enhancement/
├── README.md                       # You are here
├── INSTALL.md                      # Step-by-step self-installation
├── CHECKLIST-POC.md                # Tanko POC verification checklist
├── prompts/
│   ├── behavioral-core.md          # Replace SOUL.md intro — Three Pillars
│   └── behavioral-core-compact.md  # Ultra-compact version (< 500 tokens)
├── config/
│   ├── compression.yaml            # Optimized 256K compression settings
│   ├── mcp-servers.yaml            # MCP server config for tool parity
│   └── baseline.yaml               # Minimal behavioral baseline
└── skills/
    ├── three-pillars.md            # Proactive, Persistent, Self-Improving
    ├── verification-protocol.md    # Context7 + GitHub verification
    └── self-healing.md             # Error recovery patterns

Quick Start

# 1. Read INSTALL.md
# 2. Merge prompts/behavioral-core.md into your SOUL.md
# 3. Add MCP servers from config/mcp-servers.yaml to your config.yaml
# 4. Copy skills/ to your skills directory
# 5. Apply compression settings from config/compression.yaml
# 6. Restart and verify

POC Pilot

Tanko is the designated proof-of-concept pilot. See CHECKLIST-POC.md.