compact-check

name	compact-check
description	Soft/Hard compact range checker. Vrátí zone (green/soft/hard/over) + action + recommendation. Per-instance thresholds. Používej v loop protokolu over 200k.
user-invocable	true

compact-check — Soft/Hard Context Zone Checker

PURPOSE

Implementuje Tomův loop protokol: over 200k → remember → team ping-pong → autocompact → continue.

Každá instance má vlastní thresholds. Skill řekne co dělat teď.

---

ZONES

Zone	Tokeny (strat/legal)	Action	Urgency
green	< 180k	work	0
soft	180k – 230k	plan-compact	1
hard	230k – 250k	compact-now	2
over	> 250k	emergency	3

Per-instance thresholds (strat/legal=180k/230k/250k, coder=160k/210k/230k, ostatní=170k/220k/250k). Editovatelné přímo ve skriptu: scripts/compact_check.py → INSTANCE_THRESHOLDS.

---

EXECUTION

python C:/Users/tom/.claude/plugins/marketplaces/lg13/plugins/lg13-skills/skills/compact-check/scripts/compact_check.py \
  --ctx-now <N> [--instance <name>] [--json]

--ctx-now = aktuální počet tokenů (z /context nebo claude_usage_read.py). --instance = auto-detekuje z CWD pokud chybí. --json = strojový výstup pro loop skripty.

---

LOOP PROTOKOL (Tom 2026-05-26)

Při každém deep-read batchi nebo pravidelném checku:

1. compact-check --ctx-now <N> --json
2. zone == 'green'  → work, žádná akce
3. zone == 'soft'   → /remember + ping-pong strat (compact_signal=True) + dokonči turn
4. zone == 'hard'   → /remember + ping-pong strat + IHNED save-min + nech autocompact spustit
5. zone == 'over'   → P0 ping strat, compact emergency

PreCompact hook (C:/Users/tom/.claude/hooks/pre-compact-loop.py) dělá kroky 3-4 automaticky.

---

VÝSTUP (--json)

{
  "instance": "strat",
  "ctx_now": 195000,
  "pct": 78.0,
  "zone": "soft",
  "action": "plan-compact",
  "recommendation": "Soft limit. Dokonči aktuální task, pak save-min + ping-pong...",
  "compact_signal": true,
  "urgency": 1,
  "thresholds": { "soft": 180000, "hard": 230000, "window": 250000 },
  "remaining": {
    "to_soft_tokens": 0,
    "to_hard_tokens": 35000,
    "to_window_tokens": 55000,
    "turns_to_soft": 0,
    "turns_to_hard": 7.0,
    "turns_remaining": 11.0
  }
}

---

RULES

• Claude NEpočítá sám — deleguje skriptu
• --ctx-now je povinný
• Výsledek action je závazný pro loop protokol
• compact_signal: true = zahrnout do ping-pong compact_signal pole
• urgency >= 2 = save-min IHNED bez dalšího work

---

INTEGRACE DO INIT MIN / SAVE MIN

Po každém deep-read batchi (krok 5 init min):

python compact_check.py --ctx-now $(python claude_usage_read.py --field session_tokens) --instance strat

Nebo jednoduše: zavolej skill, přečti action, reaguj.

---

RELATED

• Skill save-min — spusť když action=plan-compact nebo hard
• Skill ping-pong — odešli s compact_signal=true
• Skill remember:remember — handoff note před compactem
• Hook C:/Users/tom/.claude/hooks/pre-compact-loop.py — auto při autocompact
• Script edge_calc.py — starší per-turn edge (nadále platný pro save/work rozhodnutí)