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
This commit is contained in:
root
2026-06-27 19:03:43 +00:00
committed by Abiba (pi)
parent 7e6536ea57
commit aa305ce431
11 changed files with 517 additions and 0 deletions
+51
View File
@@ -0,0 +1,51 @@
# 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
```bash
# 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](CHECKLIST-POC.md).