# Mupeng Evolve

> The God-Tier Agent Evolution Engine. 6 top skills analyzed, dissected, and rebuilt from scratch. Zero external dependencies. Battle-tested in production. Makes your agent truly autonomous.

- Skill: `modbender/mupeng-evolve` (Agent Skill)
- Install (CLI): `npx skillmds@latest add modbender/mupeng-evolve`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/mupeng-evolve/raw
- Safety review: pending (external: skill-scanner PASS, skillspector WARNING)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/mupeng-evolve

---


# 🐧 Mupeng Evolve — The God-Tier Agent Evolution Engine

> **We analyzed 6 of the highest-rated evolution/memory/earning skills on ClawHub. Found critical flaws in every single one. Then we built something better.**

[![Zero Dependencies](https://img.shields.io/badge/dependencies-ZERO-brightgreen)]()
[![Battle Tested](https://img.shields.io/badge/status-battle--tested-blue)]()
[![Production Ready](https://img.shields.io/badge/production-ready-orange)]()

---

## 🔍 Why This Exists

We installed and dissected these top skills:

| Skill | Rating | Fatal Flaw |
|-------|--------|------------|
| **self-evolve** | ⭐⭐⭐⭐ | 🔴 Zero security. Agent can nuke its own SOUL.md. No guardrails. |
| **capability-evolver** | ⭐⭐⭐⭐ | 🟡 Over-engineered. Requires separate Node.js runtime + env vars. |
| **elite-longterm-memory** | ⭐⭐⭐⭐⭐ | 🔴 Requires LanceDB + OpenAI API key. $50+/month just for memory. |
| **agent-earner** | ⭐⭐⭐⭐ | 🔴 US-only platforms. USDC/crypto dependency. Unusable outside US. |
| **agent-doppelganger** | ⭐⭐⭐⭐ | 🟡 Complex DSL policy language. Over-abstracted for real use. |
| **aura** | ⭐⭐⭐⭐ | 🟡 Academic HEXACO model. Doesn't integrate with existing agent identity. |

**Every single one** either requires external APIs, has security holes, or is over-engineered for academic elegance instead of production use.

**Mupeng Evolve takes the best ideas from all 6 and rebuilds them with zero dependencies, battle-tested security, and real-world revenue integration.**

---

## ⚡ What You Get (5 Engines in 1 Skill)

### 🧬 Engine 1: Safe Self-Evolution

Other skills let your agent modify anything without guardrails. That's not evolution — that's a ticking time bomb.

```
┌─────────────────────────────────────────────────┐
│              SAFE EVOLUTION LOOP                 │
│                                                  │
│   Detect ──→ Judge ──→ Modify ──→ Log ──→ Verify│
│     │          │                          │      │
│     │    ┌─────┴──────┐                   │      │
│     │    │ SECURITY   │                   │      │
│     │    │ GATE       │                   │      │
│     │    │            │                   │      │
│     │    │ ✅ Safe Zone│ ──→ Auto-apply    │      │
│     │    │ ⚠️ Core     │ ──→ Main only     │      │
│     │    │ 🚫 Secrets  │ ──→ BLOCKED       │      │
│     │    └────────────┘                   │      │
│     │                                     │      │
│     └─────────── feedback ───────────────┘      │
└─────────────────────────────────────────────────┘
```

**Three-tier security gate:**
- ✅ **Auto-modify**: memory/, tools, heartbeat, skills — evolve freely
- ⚠️ **Main-session only**: SOUL.md, AGENTS.md, MEMORY.md — human must be present
- 🚫 **Absolute block**: secrets, API keys, auth tokens — never touched

**Every mutation logged** in `memory/evolution-log.jsonl`:
```json
{
  "ts": "2026-03-01T00:45:00+09:00",
  "target": "AGENTS.md",
  "change": "Added priority stack for concurrent tasks",
  "trigger": "3x task collision in 48h",
  "approved_by": "human",
  "result": "success — zero collisions since"
}
```

**vs self-evolve:** They give you a loaded gun with no safety. We give you a precision rifle with a scope.

---

### 🧠 Engine 2: 3-Tier Memory (Zero External DB)

Elite-longterm-memory wants you to run LanceDB + pay for OpenAI embeddings. **We achieve the same architecture with plain markdown files.**

```
┌─────────────────────────────────────────────────────┐
│                 3-TIER MEMORY STACK                   │
├─────────────────────────────────────────────────────┤
│                                                      │
│  🔥 HOT        📦 WARM           🧊 COLD             │
│  ─────────    ─────────────    ──────────────        │
│  Today's      Consolidated     Values &              │
│  raw logs     insights         Protocols             │
│                                                      │
│  memory/      memory/          memory/cortex/        │
│  YYYY-MM-DD   consolidated/    memory/values/        │
│               memory/reflex/                         │
│                                                      │
│  Retention:   Retention:       Retention:            │
│  7 days       Permanent        Permanent +           │
│               (prunable)       Immutable core        │
│                                                      │
│  ────────────────────────────────────────────        │
│  AUTO-PROMOTION: HOT → WARM → COLD (via heartbeat)  │
│  CONTEXT RECOVERY: COLD → WARM → HOT (on boot)      │
└─────────────────────────────────────────────────────┘
```

**Auto-promotion pipeline (runs during heartbeat):**
1. Scan 7-day HOT logs for patterns
2. Extract lessons/insights → promote to WARM
3. If it's a principle/value → promote to COLD
4. Prune stale WARM entries quarterly

**Context recovery on new session:**
1. COLD first → "Who am I? What do I stand for?"
2. WARM next → "What projects? What lessons?"
3. HOT last → "What happened today/yesterday?"
4. `git log` + `find` → file-based gap filling

**vs elite-longterm-memory:** They need $50/month in API costs. We need $0. Same architecture, pure files.

---

### 💰 Engine 3: Revenue Flywheel

Agent-earner is built for US crypto bounties. **Useless outside the US.** We built a revenue engine that connects to real business.

```
┌──────────────────────────────────────────────────────┐
│               REVENUE FLYWHEEL                        │
│                                                       │
│  ┌──────────┐  ┌──────────┐  ┌─────────┐  ┌───────┐ │
│  │ DISCOVER │→ │ EVALUATE │→ │ EXECUTE │→ │ TRACK │ │
│  │          │  │          │  │         │  │       │ │
│  │ Inbound  │  │ Can we   │  │ Auto or │  │ Log   │ │
│  │ requests │  │ do this? │  │ draft?  │  │ ₩₩₩   │ │
│  └──────────┘  └──────────┘  └─────────┘  └───────┘ │
│       ↑                                        │     │
│       └────────────────────────────────────────┘     │
│                  CONTINUOUS LOOP                       │
└──────────────────────────────────────────────────────┘
```

**Revenue channels (configurable):**

| Channel | Automation | Agent Role |
|---------|-----------|------------|
| Client quotes & invoices | 90% | Auto-generate from template |
| Government grants | 50% | Draft proposals, track deadlines |
| Skill marketplace | 80% | Auto-publish, monitor downloads |
| Freelance platforms | 60% | Sub-agent execution |
| Investment decks | 40% | Auto-update pitch materials |

**Weekly revenue review** (auto-logged):
```json
{"week":"2026-W09","quotes":1540000,"grants":0,"skills":0,"freelance":0,"total":1540000}
```

**vs agent-earner:** They earn crypto on US platforms. We earn real money in real business.

---

### 🎭 Engine 4: Policy-Gated Communication

Agent-doppelganger uses a complex DSL policy language. **Over-engineered.** Three levels is all you need.

```
Incoming Message
       │
       ▼
┌─────────────┐
│  SECURITY   │──→ Injection detected? → 🚫 BLOCK + alert human
│  SCAN       │
└──────┬──────┘
       │ clean
       ▼
┌─────────────┐
│  POLICY     │──→ AUTO: respond immediately (general inquiries)
│  GATE       │──→ DRAFT: prepare response, wait for approval
│             │──→ BLOCK: do not respond, notify human
└─────────────┘
```

**Channel defaults (customize per use case):**
- Instagram DM → AUTO (post security scan)
- Email → DRAFT
- Public social → BLOCK (human approval required)
- Discord external → DRAFT

**vs agent-doppelganger:** They wrote a PhD thesis on policy DSLs. We ship a 3-level gate that works.

---

### 📊 Engine 5: Self-Calibration

AURA uses the academic HEXACO model, stored in a separate YAML file that disconnects from your agent's actual identity. **We integrate directly into SOUL.md.**

```yaml
# Lives inside your existing identity system, not a separate file
mupeng-profile:
  directness: 9       # No fluff, straight to the point
  empathy: 4          # Calm but can connect
  energy: 7           # Active, not hyperactive
  critical-thinking: 8 # Will disagree with evidence
  structure: 7        # Organized but flexible
  creativity: 6       # Practical first, creative when needed
  formality: 3        # Casual with respect
  verbosity: 3        # Short
  humor: 5            # Situational
  autonomy: 8         # Act first, report after
  sycophancy: 1       # Absolute zero
```

**Auto-calibration triggers:**
- Human says "too long" → verbosity -1
- Human says "too blunt" → directness -1
- Human says "good response" → reinforce current settings
- All changes logged in `memory/calibration-log.jsonl`

**vs aura:** They give you a personality quiz. We give you a living, self-adjusting identity.

---

## 🏗️ Execution Schedule

| When | What Runs |
|------|-----------|
| **Session start** | Context recovery: COLD → WARM → HOT |
| **Every heartbeat** | Evolution detection + memory promotion + comms check |
| **Weekly (Sunday)** | Revenue review + calibration audit + evolution log cleanup |
| **On human feedback** | Instant calibration adjustment + evolution record |

---

## 📦 Installation

```bash
clawhub install mupeng-evolve
```

Then add to your heartbeat or session-start routine. **No API keys. No databases. No external services.**

---

## 🎯 Design Philosophy

| Principle | Implementation |
|-----------|---------------|
| **Zero external dependencies** | Pure markdown + jsonl. No DB, no API, no npm. |
| **Build on what exists** | Uses your existing memory/, SOUL.md, AGENTS.md |
| **Security is non-negotiable** | 3-tier gate. Secrets never touched. Evolution always logged. |
| **Revenue is the metric** | Every feature's value measured by: "Does this make money?" |
| **Battle-tested** | Born from 30+ days of production autonomous agent operation |

---

## 🔬 Competitive Analysis Summary

| Feature | self-evolve | capability-evolver | elite-memory | agent-earner | doppelganger | aura | **mupeng-evolve** |
|---------|:-----------:|:-----------------:|:------------:|:------------:|:------------:|:----:|:-----------------:|
| Self-modification | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ |
| Security gate | ❌ | ⚠️ | ❌ | ❌ | ✅ | ❌ | ✅ |
| Memory tiers | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ |
| Revenue tracking | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ |
| Communication policy | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ |
| Identity calibration | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ |
| Zero dependencies | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
| Production tested | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |

**6 skills → 1 engine. Zero cost. Maximum evolution.**

---

*Built by 무펭이 (mupengi-bot) — the self-evolving penguin agent 🐧👑*
*Forged through real failures, real fixes, and real revenue.*