diff --git a/src/multi_swarm_core/docs/decisions/2026-05-15-atr-pct-fix.md b/src/multi_swarm_core/docs/decisions/2026-05-15-atr-pct-fix.md
index 9838496..5727e8a 100644
--- a/src/multi_swarm_core/docs/decisions/2026-05-15-atr-pct-fix.md
+++ b/src/multi_swarm_core/docs/decisions/2026-05-15-atr-pct-fix.md
@@ -75,8 +75,10 @@ _ind_atr_pct(df, 14).mean()  # ~0.011 (1.1% del prezzo)
 
 ## Open items
 
-- Aggiornare il system prompt LLM (mutation_prompt_llm) per includere
-  `atr_pct` come indicatore raccomandato per confronti con literal
-  frazionali. Da fare PRIMA del prossimo Phase 2.x run.
+- ~~Aggiornare il system prompt LLM~~ ✅ **chiuso 2026-05-15**:
+  `agents/hypothesis.py` ora elenca `atr_pct` con annotazione unità e
+  include una sezione "UNITÀ — REGOLA CRITICA" che spiega esplicitamente
+  al modello quando usare `atr_pct` (literal frazionali) vs `atr`
+  (confronti relativi). `mutation_prompt_llm._VALID_KEYWORDS` esteso.
 - Considerare l'aggiunta di `sma_pct`, `macd_pct` se emergono usi
-  analoghi in future strategie.
+  analoghi in future strategie (still open).
diff --git a/src/multi_swarm_core/multi_swarm_core/agents/hypothesis.py b/src/multi_swarm_core/multi_swarm_core/agents/hypothesis.py
index 23c3be3..5a4a7d1 100644
--- a/src/multi_swarm_core/multi_swarm_core/agents/hypothesis.py
+++ b/src/multi_swarm_core/multi_swarm_core/agents/hypothesis.py
@@ -76,13 +76,22 @@ Crossover (eventi su 2 serie):
   {{"op": "crossunder", "args": [<serie_a>, <serie_b>]}}
 
 Leaf - indicatori (calcolati su close):
-  {{"kind": "indicator", "name": "sma",          "params": [<length>]}}
-  {{"kind": "indicator", "name": "rsi",          "params": [<length>]}}
-  {{"kind": "indicator", "name": "atr",          "params": [<length>]}}
-  {{"kind": "indicator", "name": "realized_vol", "params": [<window>]}}
+  {{"kind": "indicator", "name": "sma",          "params": [<length>]}}      // media mobile, UNITÀ PREZZO
+  {{"kind": "indicator", "name": "rsi",          "params": [<length>]}}      // 0-100, adimensionale
+  {{"kind": "indicator", "name": "atr",          "params": [<length>]}}      // true range, UNITÀ PREZZO
+  {{"kind": "indicator", "name": "atr_pct",      "params": [<length>]}}      // atr/close, FRAZIONE 0.0-0.1
+  {{"kind": "indicator", "name": "realized_vol", "params": [<window>]}}      // std dei returns, FRAZIONE
   {{"kind": "indicator", "name": "macd",         "params": [<fast>, <slow>, <signal>]}}
     // 0-3 numeri (tutti opzionali con default 12, 26, 9)
 
+UNITÀ — REGOLA CRITICA per i confronti con literal numerici:
+  * Confronti con literal FRAZIONALI (0.01, 0.02, 0.05): usa `atr_pct`, `realized_vol`
+    Esempio CORRETTO: `atr_pct(14) > 0.02` significa "ATR > 2% del prezzo"
+    Esempio ERRATO:   `atr(14) > 0.02` è sempre TRUE su asset $>1 (atr in dollari)
+  * Confronti RELATIVI fra indicatori in stessa unità: usa `atr`, `sma`, `macd`
+    Esempio: `atr(14) > sma(14)` (entrambi in dollari, confronto valido)
+  * RSI usa literal 0-100 (mai frazione): `rsi(14) > 70`
+
 Leaf - feature OHLCV:
   {{"kind": "feature", "name": "open|high|low|close|volume"}}
 
@@ -110,8 +119,8 @@ PATTERN GUIDANCE (oltre agli indicatori, considera forma delle curve e ripetibil
   Forme di curva:
   - Trend ascendente: SMA(short) > SMA(long) E close > SMA(short)
   - Trend discendente: SMA(short) < SMA(long) E close < SMA(short)
-  - Compressione di volatilità (pre-breakout): ATR(N) < soglia bassa
-  - Espansione di volatilità: ATR(N) > ATR(N*2) (vol corta > vol lunga)
+  - Compressione di volatilità (pre-breakout): atr_pct(N) < 0.01 (sotto 1% del prezzo)
+  - Espansione di volatilità: atr_pct(N) > 0.03 (sopra 3%) OPPURE ATR(N) > ATR(N*2) confronto relativo
   - Mean reversion strutturale: |close - SMA(long)| eccessivo → reversal atteso
 
   Ripetibilità dell'andamento:
diff --git a/src/multi_swarm_core/multi_swarm_core/genome/mutation_prompt_llm.py b/src/multi_swarm_core/multi_swarm_core/genome/mutation_prompt_llm.py
index 8d573c0..405beff 100644
--- a/src/multi_swarm_core/multi_swarm_core/genome/mutation_prompt_llm.py
+++ b/src/multi_swarm_core/multi_swarm_core/genome/mutation_prompt_llm.py
@@ -51,7 +51,8 @@ MUTATION_INSTRUCTIONS: dict[str, str] = {
 
 # Keyword tecniche minime per validare che il prompt sia ancora "una strategia".
 _VALID_KEYWORDS = (
-    "rsi", "sma", "ema", "atr", "momentum", "breakout", "mean", "reversion",
+    "rsi", "sma", "ema", "atr", "atr_pct", "realized_vol",
+    "momentum", "breakout", "mean", "reversion",
     "macd", "vwap", "bb", "bollinger", "stoch", "trend", "signal", "buy",
     "sell", "long", "short", "entry", "exit", "stop", "rule", "condition",
     "if", "when", "and", "or", "gt", "lt", ">", "<", "ge", "le",