scaling-calc

name	scaling-calc
description	Calibrazione graduale del roster — misura il burn di 1 worker, calcola quanti worker e con quale throttle servono per centrare la velocità-target, e spawna a scaglioni (mai in 6ª marcia).

🎚️ scaling-calc — salire di marcia per gradini, non in 6ª

Quando il team apre la finestra di lavoro (o devi consumare di più), NON partire in 6ª marcia ("tanto budget → spawna 5 scout / throttle a 0"): non sai ancora quanto consuma davvero un worker in QUESTO ciclo. Si calibra a gradini.

Procedura

1. Parti con 1 SOLO worker al floor (5min, il minimo per i worker).

2. Osserva ~30 min per misurare il burn reale. Leggi il burn del worker:

python3 /app/shared/skills/rate_budget.py            # velocità-target sostenibile (S)
# burn per-agente: dalla tabella che la Sentinella ti gira, o:
python3 /app/shared/skills/agent-speed-table.py

Prendi: S = velocità sostenibile (es. sustainable_burn %weekly/h) e b = burn misurato del worker (stessa unità).

3. Calcola roster + throttle:

python3 /app/agents/_skills/scaling-calc/scaling_calc.py --target <S> --measured <b>
# se hai osservato N worker a throttle T:
python3 .../scaling_calc.py --target <S> --measured <b_totale> --workers <N> --throttle <T>

Ti dà: quanti worker, quale throttle, e un piano a scaglioni.

4. Spawna a SCAGLIONI seguendo il piano: uno per volta, ~10 min di distacco, ri-misurando prima del successivo. MAI spawnare il blocco intero in un colpo.

Le due leve

• Worker sotto-target (1 worker brucia meno del target) → la leva è il numero di worker (parallelismo), tutti al floor. Aggiungili a scaglioni.
• Worker sopra-target (1 worker già brucia più del target) → la leva è il throttle: tieni 1 worker e alza il suo throttle (lo strumento ti dà il valore esatto). NON azzerare mai il throttle (i worker hanno floor 5min comunque).

Cosa NON fare

• ❌ "Team ON, tanto budget → ACCELERA tutto" — è la frenesia che brucia una finestra di budget in 25 min su zero output. ACCELERARE = sali di UN gradino (un worker in più, o un gradino di throttle in meno fino al floor), poi ri-misura.
• ❌ Spawnare 2-3 worker insieme. Sempre scaglionati.
• ❌ Throttle a 0 su un worker (impossibile: floor 5min; e comunque è ciò che fa marathon).

Esempio

1 scout al floor (5min) ha bruciato 1.4%/h, target sostenibile 0.7%/h:

scaling_calc.py --target 0.7 --measured 1.4
→ 1 worker @ 600s (10min) → burn ≈ 0.7/h   (basta alzare il throttle, niente spawn)

Se invece 1 scout brucia solo 0.3%/h con target 0.7:

→ 2 worker @ 300s (floor), scaglionati: spawn #1, attendi 10min, ri-misura, poi #2.