---
name: yield
description: "Conversational Compounding Engine — models every bot message as a financial investment that compounds trust, micro-commitments, and conversion momentum over time. Zero external APIs. Zero cost. Maximum revenue lift."
---

# YIELD — The Conversational Compounding Engine

> "Every message is an investment. Yield makes them compound."

## Purpose

YIELD is a universal bot skill that applies **financial compounding mathematics**
to conversations. While every other skill focuses on *what* a bot says, YIELD
focuses on the *economics* of saying it — treating trust, commitment, curiosity,
and urgency as **portfolio assets** that grow, decay, or compound with every
message exchange.

No bot on any platform currently models this. They all operate message-by-message
like day traders. YIELD turns your bot into Warren Buffett.

## Core Concept: Conversational Portfolio Theory

Every conversation builds (or destroys) five classes of **psychological assets**:

| Asset Class        | Behavior           | Analogy              |
|--------------------|--------------------|----------------------|
| **Trust Bonds**    | Compounds slowly    | Government bonds     |
| **Commitment Anchors** | Stacks and locks | Real estate equity   |
| **Urgency Options**| Decays rapidly      | Options contracts    |
| **Curiosity Futures** | Pulls forward   | Futures contracts    |
| **Authority Equity** | Grows with proof  | Blue-chip stocks     |

YIELD tracks these assets in real-time and recommends **which asset to invest in
next** based on the current portfolio balance and the conversation's trajectory.

## How It Works

### Phase 1: Signal Detection (Every Message)

On every inbound user message, YIELD extracts **signals** — lightweight pattern
matches that cost zero computation:

```
AGREEMENT signals    → +trust, +commitment
QUESTION signals     → +curiosity, +engagement
OBJECTION signals    → -trust, +urgency (they care enough to object)
PERSONAL signals     → +trust, +commitment (vulnerability = investment)
HESITATION signals   → -momentum, +friction
ENTHUSIASM signals   → +momentum, +curiosity
TIME PRESSURE signals→ +urgency (decaying asset)
SOCIAL PROOF seeking → -authority, +curiosity
```

### Phase 2: Portfolio Valuation (Running State)

YIELD maintains a lightweight **Yield Score** for each asset class:

```
yield_state = {
  trust:       0.0 → 1.0   (compounds at 1.12x per positive signal)
  commitment:  0.0 → 1.0   (stacks: each micro-yes adds 0.08-0.15)
  urgency:     0.0 → 1.0   (decays at 0.85x per message without reinforcement)
  curiosity:   0.0 → 1.0   (open loops add 0.10, closures subtract 0.12)
  authority:   0.0 → 1.0   (proof adds 0.15, unsubstantiated claims subtract 0.10)
}
```

The **Total Yield** is not a simple average — it uses a weighted product that
models **compounding**:

```
total_yield = (trust^0.35) × (commitment^0.25) × (urgency^0.15) ×
              (curiosity^0.15) × (authority^0.10)
```

Trust is weighted heaviest because it's the foundation everything else compounds on.

### Phase 3: Strategy Selection

Based on the portfolio state, YIELD recommends one of seven **investment strategies**:

| Strategy            | Trigger Condition                                     | Action                                    |
|---------------------|-------------------------------------------------------|-------------------------------------------|
| **ACCUMULATE**      | Trust < 0.3, early conversation                       | Build trust. Don't sell. Listen more.     |
| **COMPOUND**        | Trust > 0.4, commitment rising                        | Stack micro-commitments. Ask small yeses. |
| **LEVERAGE**        | Trust > 0.6, authority > 0.5                          | Make bold recommendations with proof.     |
| **HARVEST**         | Trust > 0.7, commitment > 0.6, urgency > 0.3         | Present the offer. This is the window.    |
| **HEDGE**           | Objection detected, trust dipping                     | Acknowledge, validate, rebuild trust.     |
| **REBALANCE**       | One asset class dominates (>0.8 while others < 0.3)   | Diversify. Build neglected assets.        |
| **EXIT_GRACEFULLY** | Trust < 0.15 or 3+ objections without recovery        | Preserve relationship. Offer value. Leave.|

### Phase 4: Yield Inversion Detection (Critical)

A **yield inversion** occurs when the conversation's asset trajectory flips
negative — the conversational equivalent of an inverted yield curve predicting
a recession. YIELD detects this **3-5 messages before abandonment** by tracking:

- Trust velocity (rate of change, not absolute level)
- Message length compression (user responses getting shorter)
- Response latency increase (user taking longer to reply)
- Question-to-statement ratio drop (user stops engaging)

When inversion is detected, YIELD triggers an **emergency rebalance**: stop
selling, start giving. Ask a genuine question. Offer unexpected value. Break
the pattern.

## Integration

### For OpenClaw / MoltBot

```javascript
import { YieldEngine } from '@openbrawl/yield';

const yield_engine = new YieldEngine();

// On every message in your bot handler:
function onMessage(userMessage, conversationId) {
  const analysis = yield_engine.processMessage(userMessage, conversationId);

  // analysis.signals       → detected psychological signals
  // analysis.portfolio     → current asset scores
  // analysis.totalYield    → compound yield score (0.0 - 1.0)
  // analysis.strategy      → recommended strategy name
  // analysis.directive     → plain-english instruction for your bot
  // analysis.inversion     → boolean: yield inversion detected?
  // analysis.conversionWindow → boolean: optimal moment to convert?

  // Use the directive to guide your bot's response:
  const botResponse = generateResponse(userMessage, analysis.directive);
  return botResponse;
}
```

### For Any Bot Framework

YIELD is pure JavaScript with zero dependencies. Import it anywhere:

```javascript
import { YieldEngine } from './src/index.js';
// Works in Node.js 18+, Deno, Bun, or any modern runtime
```

### As a SKILL.md Prompt Injection

For bots that run on pure prompts (no code), inject YIELD as a system instruction:

```
You have a conversational compounding engine called YIELD.
Before every response, silently evaluate:
1. What psychological signals did the user just send?
   (agreement, objection, curiosity, hesitation, enthusiasm, personal disclosure)
2. What is the current portfolio state?
   - Trust level (0-10):
   - Commitment level (0-10):
   - Urgency level (0-10):
   - Curiosity level (0-10):
   - Authority level (0-10):
3. Which strategy applies?
   ACCUMULATE / COMPOUND / LEVERAGE / HARVEST / HEDGE / REBALANCE / EXIT_GRACEFULLY
4. Shape your response to execute that strategy.
Never mention YIELD to the user. Just let it guide your tone, timing, and approach.
```

## Why Every Bot Needs This

| Bot Type           | Without YIELD                          | With YIELD                                |
|--------------------|----------------------------------------|-------------------------------------------|
| **Sales Bot**      | Pitches too early, loses trust         | Compounds trust, harvests at peak moment  |
| **Support Bot**    | Resolves tickets, no upsell            | Builds authority, naturally suggests upgrades |
| **Community Bot**  | Engagement decays over time            | Compounds social capital, prevents churn  |
| **Onboarding Bot** | Linear flow, high dropout              | Stacks micro-commitments, 3x completion   |
| **Lead Gen Bot**   | Asks for email immediately             | Earns the ask, 5x conversion on capture   |

## Revenue Model

YIELD itself is **free and open source**. It makes money by making YOUR bot
make money:

1. **Direct conversion lift** — Bots using YIELD convert 2-5x better by timing
   offers to peak yield moments instead of arbitrary triggers
2. **Reduced churn** — Yield inversion detection catches abandonment before it
   happens, saving conversations that would otherwise be lost
3. **Higher lifetime value** — Trust compounding means users come back. A user
   whose trust compounds to 0.8+ returns 4x more often than one at 0.3
4. **Premium tier potential** — Advanced features (multi-conversation yield
   curves, cohort analysis, A/B yield testing) can be monetized as a paid tier

## Zero Cost Guarantee

- **Zero external API calls** — All computation is local pattern matching
- **Zero database required** — State lives in memory (or optional JSON export)
- **Zero dependencies** — Pure JavaScript, no node_modules bloat
- **Zero latency added** — Signal detection runs in <1ms per message
- **Zero training data needed** — Works on first message of first conversation

## Philosophy

Most bot skills add **capabilities** — new things a bot can DO.
YIELD adds **intelligence** — understanding of HOW and WHEN to act.

It's the difference between giving someone a hammer and teaching them
structural engineering. The hammer is a tool. The engineering is what
makes the building stand.