# Detailed Bubble Theory Framework

> True bubbles are determined not by price levels but by the phase of crowd psychology.

- Skill: `tools-only/detailed-bubble-theory-framework` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/detailed-bubble-theory-framework`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/detailed-bubble-theory-framework/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/detailed-bubble-theory-framework

---

# Detailed Bubble Theory Framework

## Table of Contents
1. [Core Concept](#core-concept)
2. [Minsky/Kindleberger Model](#minskykindleberger-model)
3. [Behavioral Psychology Elements](#behavioral-psychology-elements)
4. [Quantitative Indicators for Detection](#quantitative-indicators-for-detection)
5. [Practical Response Strategies](#practical-response-strategies)

---

## Core Concept

### The Essence of Bubbles: Social Norm Inversion Through Social Contagion

True bubbles are determined not by **price levels** but by **the phase of crowd psychology**.

#### Core Characteristics

1. **Critical Information Cascade**
   - Spread to all layers (including non-investors) is complete
   - FOMO (Fear of Missing Out) becomes social norm
   - Social cost of being skeptical is maximized

2. **Social Calculation Inversion**
   ```
   Normal state: Conformity pressure < Value of independent judgment
   Bubble state: Conformity pressure > Value of independent judgment
   ```
   Completion is near when "pain of not conforming < pain of holding contrarian views"

3. **Institutionalized Confirmation Bias**
   - Media, experts, and laypeople repeat the same narrative
   - Counterevidence is ignored or excluded
   - "This time is different" becomes the mantra

### Signal Example: Taxi Driver Investment Talk

Modern version of Joe Kennedy selling before the 1929 crash after hearing a shoeshine boy talk stocks.

**Why this is a decisive signal:**
- Information reaches the final tier = cascade complete
- "Last buyer" cohort enters = demand exhaustion near
- "Sure to profit" perception without expertise = peak risk ignorance

---

## Minsky/Kindleberger Model

5-stage bubble progression model (Hyman Minsky / Charles Kindleberger)

### 1. Displacement (Trigger)

**Characteristics:**
- Structural changes like new technology, institutional reform, monetary easing
- Legitimate investment opportunities emerge
- Rational price rises

**Real Examples:**
- 1990s: Internet revolution
- 2010s: Mobile/cloud
- 2020-21: Pandemic-response ultra-easing + remote work technology

### 2. Boom (Expansion)

**Characteristics:**
- Self-reinforcing loop: price rise → media exposure → new participants → liquidity expansion
- Positive expert views increase
- Valuations high but "explainable by growth expectations"

**Psychology:**
- Availability bias: Success stories dominate
- Herding: Even institutional investors feel pressure to join

**Detection Indicators:**
- Sustained trading volume increase
- Accelerating new account openings
- Annual returns in 75-90th percentile

### 3. Euphoria (Exuberance)

**Characteristics:**
- Narrative becomes "common sense," dissent labeled "outdated"
- Leverage increases (margin trading, futures, derivatives)
- New issuances proliferate (IPO/ICO/SPAC)
- Even low-quality stocks rally

**Psychology:**
- Overconfidence: "I'm special"
- Confirmation bias: Accept only favorable information
- Regret aversion: Overly fear "missing gains after selling"

**Detection Indicators:**
- VIX falls (risk dismissal)
- Extreme Put/Call ratio bias
- Margin balances at all-time highs
- Proliferation of "XX-related" products

### 4. Profit Taking (Exit Begins)

**Characteristics:**
- Early participants (smart money) begin taking profits
- But crowd continues chasing with FOMO
- Volatility (price fluctuation) increases

**Psychological Divergence:**
- Smart money: Loss aversion (prioritize securing gains)
- Crowd: FOMO peaks ("don't miss out")

**Detection Indicators:**
- Volume surges + increased price swings
- Insider selling increases
- Short interest rises (sophisticated skepticism)

### 5. Panic (Reversal)

**Characteristics:**
- Objective confirmation of trend breakdown (failure to make new highs, MA breaks)
- Forced liquidations → liquidation cascade
- Liquidity evaporates

**Psychology:**
- Loss aversion reverses: "don't want to realize loss" → "must avoid further loss by panic selling"
- Herding reverses: buying crowd → selling crowd

**Detection Indicators:**
- Circuit breakers triggered
- Chain of margin calls
- Mark-to-market losses at all-time worst levels

---

## Behavioral Psychology Elements

### 1. FOMO (Fear of Missing Out)

**Mechanism:**
- Social proof: "Everyone's buying → must be right"
- Regret aversion: "regret of missing out" > "regret of losing money"

**Bubble Condition:**
FOMO elevates from individual psychology to **social norm** → non-conformity becomes professional/social risk

### 2. Confirmation Bias

**Bubble-Period Amplification:**
- Media echo chambers
- Social media algorithm filter bubbles
- Expert conformity pressure (contrarianism = career risk)

### 3. Overconfidence

**Bubble-Period Characteristics:**
- "Only I can sell at the top"
- "This time is different"
- Risk management neglect

### 4. Dangerous Combination: Loss Aversion × Regret Aversion

**Most Dangerous Phase:**
Investors who experienced "rapid rise after early profit-taking"

1. Take profit → price rises further → regret
2. Re-enter → buy high → can't cut loss due to loss aversion
3. Further rise → illusion of being "right" reinforces
4. Miss exit when reversal comes

---

## Quantitative Indicators for Detection

### Category 1: Social Penetration

| Indicator | Data Source | Alert Threshold |
|-----------|------------|----------------|
| Google Search Trends | Google Trends API | 5x+ normal |
| Social Media Mentions | Twitter/Reddit API | z-score > +3 |
| New Account Openings | Brokerage data | 200%+ YoY |
| Media Coverage | News APIs | Weekly article count 10x normal |

### Category 2: Price Dynamics

| Indicator | Calculation | Alert Threshold |
|-----------|------------|----------------|
| Annualized Return | Annualize 90-day return | Exceeds 95th percentile |
| Price Acceleration | 2nd derivative sign and magnitude | Positive and increasing |
| Volatility Skew | Put/Call ratio | < 0.5 (extreme optimism) |
| Distance from 52W High | (Current - 52W High) / 52W High | Within -5%, clustering |

### Category 3: Leverage & Positioning

| Indicator | Data Source | Alert Threshold |
|-----------|------------|----------------|
| Margin Balance | FINRA | All-time high |
| Mark-to-Market P&L | Exchange data | Extreme unrealized gains (reversal risk) |
| Futures Positioning | CFTC COT | Speculators extremely long |
| Funding Rate | Crypto exchanges | 50%+ annual sustained |

### Category 4: New Issuance & Entry

| Indicator | Data Source | Alert Threshold |
|-----------|------------|----------------|
| IPO Count | Renaissance IPO Index | 100%+ YoY |
| SPAC Formation | SPAC statistics | 100+ per quarter |
| Theme ETF Launches | ETF.com | 5+ "XX-related" per month |

### Category 5: Valuation

| Indicator | Calculation | Alert Threshold |
|-----------|------------|----------------|
| Shiller CAPE | P/E using 10-year real earnings average | >30 (historically high) |
| Buffett Indicator | Market cap / GDP | >150% (overheating) |
| Sector Divergence | Top sector vs bottom sector P/E difference | 3x+ gap |

---

## Practical Response Strategies

### Offense: Profit-Taking Strategy

#### 1. Mechanical Stair-Step Profit-Taking

```
Target Return    Profit %    Remaining Position
+20%             25%         75%
+40%             25%         50%
+60%             25%         25%
+80%             25%         0%
```

**Benefits:**
- Eliminates psychological pressure
- Mitigates "post-sale rise" regret
- Guarantees partial profit capture

#### 2. Time-Diversified Exit

**NG Pattern:**
Concentrate profit-taking on specific events (earnings, product launch, index inclusion)

**Recommended:**
- Sell 10% daily over 2 weeks
- Distribute before/during/after events

#### 3. Trailing Stop (Volatility-Adjusted)

```python
stop_price = current_price - (ATR × coefficient)
# ATR: Average True Range (20-day average fluctuation)
# Coefficient: 2.0 (normal), 1.5 (bubble zone, tightened)
```

### Defense: Risk Management

#### 1. Pre-Determined Drawdown Tolerance

```
Expected Max DD    Position Size
-10%               100% (full position)
-20%               50%
-30%               33%
-40%               25%
```

#### 2. Risk Budget by Bubble Stage (REVISED v2.1)

| Bubble Stage | Score | Total Risk Budget | New Entry | Stop Coefficient |
|-------------|-------|------------------|-----------|-----------------|
| Normal | 0-4 | 100% | Normal | 2.0 ATR |
| Caution | 5-7 | 70-80% | 50% reduced | 1.8 ATR |
| Elevated Risk | 8-9 | 50-70% | Selective | 1.6 ATR |
| Euphoria | 10-12 | 40-50% | Stop | 1.5 ATR |
| Critical | 13-15 | 20-30% | Stop | 1.2 ATR |

**Key Changes in v2.1:**
- Added "Elevated Risk" phase (8-9 points) for more granular risk management
- Adjusted risk budgets to be less extreme at 9-point level
- Maximum score reduced to 15 (Phase 2: 12 max, Phase 3: 3 max with strict criteria)

#### 3. Short-Selling Timing (Critical)

**NG Pattern:**
- Early shorts based on subjective "too high"
- Bubbles "last longer than expected" ("Markets can remain irrational longer than you can remain solvent")

**Recommended Conditions (Composite):**
1. Weekly chart shows clear lower highs
2. Volume peaks out (enters declining trend)
3. Funding rate drops sharply (crypto) / margin balance declines (stocks)
4. Media/search trends peak out
5. Weak stocks within sector start breaking down first

Consider starting when minimum 3 conditions met.

#### 4. Separate Cash Accounts

- **Long-term investment account**: Buy & hold, dividend reinvestment, rebalancing only
- **Trading account**: Short-term trading, bubble profit-taking, reversal shorts

**Purpose:** Prevent decision confusion, maintain psychological stability

### Practical Daily Checklist

Check every morning before market open:

- [ ] Update Bubble-O-Meter (score 8 indicators)
- [ ] Update ATR trailing stops for held positions
- [ ] Verify planned new entries are appropriate given bubble stage
- [ ] Check for sudden media/social media trend changes
- [ ] Confirm major indices' distance from 52-week highs
- [ ] Check leverage indicators (margin balance, funding rate)
- [ ] Check VIX level and Put/Call ratio
- [ ] Check sector breadth (broad rally or selective)

---

## Summary: Golden Rules for Practice

1. **"See process, not price"**
   Evaluate bubbles not by levels but by crowd psychology phase transitions

2. **"When taxi drivers talk stocks, exit"**
   Last buyer cohort entry = demand exhaustion near

3. **"'This time is different' is always the same"**
   When "This time is different" becomes the mantra, be very cautious

4. **"Mechanical rules protect psychology"**
   When conformity pressure peaks, strict adherence to pre-determined rules is lifeline

5. **"Short after confirmation, take profits early"**
   Bubble collapses come late but suddenly. Contrarian shorts dangerous. Profits mechanically.

6. **"When skepticism hurts, the end begins"**
   The moment social cost exceeds independent judgment is the critical point