| 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.
