From f4ae2fea7a1bfb87dba1eef62b26078db3e4d982 Mon Sep 17 00:00:00 2001
From: johba <admin@noreply.localhost>
Date: Mon, 18 Aug 2025 17:52:39 +0200
Subject: [PATCH] docs: Merge analysis/CLAUDE.md into onchain/CLAUDE.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Consolidated the fuzzing analysis documentation into the main onchain
CLAUDE.md file for better discoverability. Removed the redundant
analysis/CLAUDE.md file.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 onchain/CLAUDE.md          | 57 +++++++++++++++++++++++++++++++++++++-
 onchain/analysis/CLAUDE.md | 56 -------------------------------------
 2 files changed, 56 insertions(+), 57 deletions(-)
 delete mode 100644 onchain/analysis/CLAUDE.md

diff --git a/onchain/CLAUDE.md b/onchain/CLAUDE.md
index 7fd6931..db16e58 100644
--- a/onchain/CLAUDE.md
+++ b/onchain/CLAUDE.md
@@ -71,7 +71,62 @@ forge test --fuzz-runs 10000  # Extended fuzzing
 
 ## Analysis Tools
 
-See `analysis/CLAUDE.md` for fuzzing and attack vector testing.
+### Fuzzing Analysis
+
+Tools for testing KRAIKEN's three-position strategy resilience against various market conditions and trading patterns.
+
+#### Quick Start
+
+```bash
+# Run with specific optimizer (50 runs default)
+./analysis/run-fuzzing.sh BullMarketOptimizer
+
+# Custom runs and trades
+./analysis/run-fuzzing.sh WhaleOptimizer runs=100 trades=30
+
+# Debug mode with position tracking CSV (forces runs=1)
+./analysis/run-fuzzing.sh NeutralMarketOptimizer debugCSV
+```
+
+#### Available Optimizers
+
+- `BullMarketOptimizer` - Buying bias
+- `NeutralMarketOptimizer` - Balanced trading  
+- `BearMarketOptimizer` - Selling bias
+- `WhaleOptimizer` - Large positions
+- `RandomScenarioOptimizer` - Random behavior
+
+#### Output Structure
+
+Each campaign creates `fuzzing_results_[optimizer]_[timestamp]/`:
+- `config.txt` - Campaign parameters
+- `run_*.log` - Individual run logs
+- `merged_profitable_scenarios.csv` - Profitable scenarios combined
+- `summary.txt` - Statistics and cumulative P&L
+- `debug_positions_*.csv` - Position data (debugCSV mode only)
+
+#### Visualization
+
+```bash
+# Automatic launch with debugCSV
+./analysis/run-fuzzing.sh [optimizer] debugCSV
+
+# Manual server (port 8000)
+./analysis/view-scenarios.sh
+```
+
+#### Advanced Usage
+
+```bash
+# Manual fuzzing with environment variables
+FUZZING_RUNS=500 TRACK_POSITIONS=true forge script analysis/FuzzingAnalysis.s.sol --ffi --via-ir
+```
+
+Environment variables:
+- `FUZZING_RUNS` - Scenarios per market (default: 100)
+- `TRACK_POSITIONS` - Enable position CSV (default: false)
+- `OPTIMIZER_CLASS` - Optimizer to use
+- `TRADES_PER_RUN` - Trades per run (default: 20)
 
 ## Uniswap V3 Math
 
diff --git a/onchain/analysis/CLAUDE.md b/onchain/analysis/CLAUDE.md
deleted file mode 100644
index 328928d..0000000
--- a/onchain/analysis/CLAUDE.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# KRAIKEN LiquidityManager Fuzzing Analysis
-
-Tools for testing KRAIKEN's three-position strategy resilience against various market conditions and trading patterns.
-
-## Quick Start
-
-```bash
-# Run with specific optimizer (50 runs default)
-./analysis/run-fuzzing.sh BullMarketOptimizer
-
-# Custom runs and trades
-./analysis/run-fuzzing.sh WhaleOptimizer runs=100 trades=30
-
-# Debug mode with position tracking CSV (forces runs=1)
-./analysis/run-fuzzing.sh NeutralMarketOptimizer debugCSV
-```
-
-## Available Optimizers
-
-- `BullMarketOptimizer` - Buying bias
-- `NeutralMarketOptimizer` - Balanced trading  
-- `BearMarketOptimizer` - Selling bias
-- `WhaleOptimizer` - Large positions
-- `RandomScenarioOptimizer` - Random behavior
-
-## Output Structure
-
-Each campaign creates `fuzzing_results_[optimizer]_[timestamp]/`:
-- `config.txt` - Campaign parameters
-- `run_*.log` - Individual run logs
-- `merged_profitable_scenarios.csv` - Profitable scenarios combined
-- `summary.txt` - Statistics and cumulative P&L
-- `debug_positions_*.csv` - Position data (debugCSV mode only)
-
-## Visualization
-
-```bash
-# Automatic launch with debugCSV
-./analysis/run-fuzzing.sh [optimizer] debugCSV
-
-# Manual server (port 8000)
-./analysis/view-scenarios.sh
-```
-
-## Advanced Usage
-
-```bash
-# Manual fuzzing with environment variables
-FUZZING_RUNS=500 TRACK_POSITIONS=true forge script analysis/FuzzingAnalysis.s.sol --ffi --via-ir
-```
-
-Environment variables:
-- `FUZZING_RUNS` - Scenarios per market (default: 100)
-- `TRACK_POSITIONS` - Enable position CSV (default: false)
-- `OPTIMIZER_CLASS` - Optimizer to use
-- `TRADES_PER_RUN` - Trades per run (default: 20)
\ No newline at end of file