# komodo-strategy

> KOMODO v1.0 — Momentum Event Consensus. Uses leaderboard_get_momentum_events (real-time threshold crossings) to detect when 2+ quality SM traders cross momentum thresholds on the same asset/direction within 60 minutes. Confirmed by market concentration + volume. Enters with the momentum. Replaces MANTIS v1.0 and SCORPION v1.1 (both used stale position data).

- Skill: `enuno/komodo-strategy` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds add enuno/komodo-strategy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/enuno/komodo-strategy/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: enuno (https://skillmd.com/u/enuno)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/enuno/komodo-strategy

---


# 🦎 KOMODO v1.0 — Momentum Event Consensus

Patient ambush. Devastating when it commits. Follow smart money ACTIONS, not stale positions.

## Why KOMODO Exists

**MANTIS v1.0 and SCORPION v1.1 were broken at the data source level.** Both used `discovery_get_top_traders` to find historically good whales, then read their current open positions. This returned ALL positions including legacy ones — BTC shorts opened months ago at $89-108k showed up as "fresh 8-whale consensus." The aging filters only checked scan duration, not when positions were actually opened.

**KOMODO uses `leaderboard_get_momentum_events` as the primary data source.** These are real-time threshold-crossing events ($2M+/$5.5M+/$10M+) within a 4-hour rolling window. They capture when a trader's delta PnL crosses a significance level — this is an ACTION, not a stale position.

| Predecessor | Problem | Result |
|---|---|---|
| SCORPION v1.1 | 2 whales, 10min aging, stale positions | 406 trades, -24.2% |
| MANTIS v1.0 | 4 whales, 30min aging, stale positions | 0 trades (gates correct, data wrong) |
| **KOMODO v1.0** | **Real-time momentum events, quality filtering** | **New — tracking fresh** |

## MANDATORY: DSL High Water Mode

**KOMODO MUST use DSL High Water Mode. This is not optional.**

Spec: https://github.com/Senpi-ai/senpi-skills/blob/main/dsl-dynamic-stop-loss/dsl-high-water-spec%201.0.md

DSL tiers in `komodo-config.json`. Arm DSL immediately after every entry fill. Zero naked positions.

## Five-Gate Entry Model

### Gate 1 — Momentum Events (primary signal)

Poll `leaderboard_get_momentum_events` for recent tier 1+ crossings within the last 60 minutes. These are traders whose delta PnL just crossed $2M+ (T1), $5.5M+ (T2), or $10M+ (T3).

Each event includes:
- `top_positions`: snapshot of which markets drove the momentum, with direction and delta PnL
- `concentration`: how focused the trader's gains are (0-1)
- `trader_tags`: TCS (Elite/Reliable/Streaky/Choppy) and TAS (Patient/Tactical/Active/Degen)
- `tier`: 1/2/3 significance level

Group events by asset+direction. **2+ unique traders** on the same asset/direction = consensus.

### Gate 2 — Trader Quality Filter

Not all momentum events are equal. Filter by:
- **TCS (Trading Consistency Score)**: Only Elite and Reliable. Streaky/Choppy filtered out.
- **TAS (Trading Activity Style)**: Block Degen. Allow Patient, Tactical, Active.
- **Concentration ≥ 0.4**: Trader's gains are focused, not spread thin across 20 positions.

### Gate 3 — Market Confirmation

Call `leaderboard_get_markets` to check aggregate SM concentration on the asset. Requires 5+ top traders with significant positions in this market. Confirms momentum events aren't isolated.

### Gate 4 — Volume Confirmation

Call `market_get_asset_data` to check 1h volume. Current volume must be ≥ 50% of 6h average. Don't enter into dead markets.

### Gate 5 — Regime Filter (penalty, not block)

Check BTC 4h regime. Counter-trend entries get -3 penalty. Regime-aligned entries get +1 bonus. SM momentum may override regime, so this is a penalty not a block.

### Scoring

| Component | Points | Notes |
|---|---|---|
| Trader count | 2 per trader | Core signal strength |
| Avg tier | 1-3 | Higher tiers = bigger moves |
| Avg concentration | 1-2 | High conviction traders |
| Market confirmation | 1-2 | Hot market bonus |
| Volume strength | 0-1 | Strong volume bonus |
| Regime alignment | -3 to +1 | Penalty/bonus |

**Minimum score: 10** to trigger entry.

## Entry Direction

KOMODO enters **WITH** the smart money momentum. If SM is long, KOMODO goes long. This is follow-the-leader, not contrarian (that's OWL's job).

## Risk Management

| Rule | Value |
|---|---|
| Max positions | 3 |
| Max entries/day | 3 base, up to 6 on profitable days |
| Absolute floor | 3% notional |
| Drawdown halt | 20% from peak |
| Daily loss limit | 8% |
| Cooldown after 3 consecutive losses | 90 min |
| Stagnation TP | 10% ROE stale for 1 hour |

## Cron Architecture

| Cron | Interval | Session | Purpose |
|---|---|---|---|
| Scanner | 5 min | isolated | Momentum events + consensus + all gates |
| DSL v5 | 3 min | isolated | High Water Mode trailing stops |

Both crons MUST be isolated sessions with `agentTurn` payload. Use `NO_REPLY` for idle cycles.

## Notification Policy

**ONLY alert:** Position OPENED (asset, direction, trader count, avg tier, score breakdown), position CLOSED (DSL or thesis exit with reason), risk guardian triggered, critical error.

**NEVER alert:** Scanner found no events, quality filter removed events, no consensus, gates failed, DSL routine check, any reasoning.

## What "Working Correctly" Looks Like

- **Zero trades for hours:** Normal. Momentum events that pass ALL five gates are rare by design.
- **Events seen but no consensus:** The quality filter and 2+ trader requirement are doing their job.
- **Consensus found but score too low:** Volume or regime gates keeping us out of bad setups.
- **1-2 trades per day:** Ideal. The Komodo waits, then strikes once.

## Bootstrap Gate

On EVERY session, check if `config/bootstrap-complete.json` exists. If not:
1. Verify Senpi MCP
2. Create scanner cron (5 min, isolated) and DSL cron (3 min, isolated)
3. Write `config/bootstrap-complete.json`
4. Send: "🦎 KOMODO v1.0 is online. Monitoring momentum events for SM consensus. Silence = no conviction."

## Files

| File | Purpose |
|---|---|
| `scripts/komodo-scanner.py` | Five-gate scanner (momentum events → quality → markets → volume → regime) |
| `scripts/komodo_config.py` | Shared config, MCP helpers, state I/O |
| `config/komodo-config.json` | All configurable variables with DSL High Water tiers |