Riferimenti
--:--:--
08

Riferimenti

I documenti di riferimento del sistema. Sola lettura, letti live dal disco. Si parte dal Metodo di lavoro.

Criterio dell'elenco: i documenti stanno in gruppi per mestiere, non in ordine di nome né di data. I gruppi nascono chiusi e dicono quanti documenti contengono; quello del documento che stai leggendo si apre da solo, e come li lasci li ritrovi. Dentro un gruppo l'ordine è quello in cui uno nuovo deve aprirli, e non è alfabetico.

Policy operative

🟢 v1agg. 2026-07-21Metodo_di_lavoro/POLICY_operative.md

Policy operative

Regole trasversali che si applicano dentro i preset T1–T4 e i profili di orchestrazione O1–O5.
Non sono tipologie di task: sono aspetti specifici che si accendono quando servono.

1. Token-Lean (risparmio token) — incl. skill caveman

Cosa: ridurre i token spesi dagli agenti su task lunghi/costosi, senza perdere sostanza.
Come (a strati, dal più leggero):

  • Nativo (sempre): output conciso, "di' cosa fare non cosa non fare", niente markdown superfluo, response_format: concise sui tool (L1 §output/verbosità); effort calibrato al task (L1 §Opus 4.8).
  • Context management (task lunghi): compaction / tool clearing / memory (L3 §8, L5 §5); prompt caching sui prefissi stabili (system prompt, tool def, file di contesto).
  • Skill `caveman` (installata, workspace/skills/caveman): output telegrafico, taglia ~65% dei token di output mantenendo verbatim codice/errori/warning. Attivazione ON-REQUEST: si usa su richiesta o su auto-trigger nei task lunghi e costosi (non always-on). Livelli: lite/full/ultra.
  • Programmatic Tool Calling (tool che ritornano output enormi → risultati intermedi fuori dal contesto). Quando: T3/T4 lunghi, output di sotto-agenti che rientrano nel main, elaborazioni su molti item. Materiale/fonti: Metodo_di_lavoro/Efficienza_token/ (INDICE + estratti + fonti: caveman, LLMLingua, prompt-caching, advanced-tool-use). Agganci: L1 (verbosità) · L3 (context mgmt/skill) · L5 (loop lunghi).

2. Fresh-context stepping (nuova conversazione per step)

Cosa: su processi marcati, quando l'agente passa a un nuovo step avvia una **conversazione a
contesto pulito* invece di trascinare tutta la history → si evita il context rot* sui task lunghi.
Come: ogni step = sessions_spawn isolato che riceve un handoff compatto (template
L2_templates/handoff_sessione.md: Intent · Completato · Attivo · Pending · Riferimenti-chiave) e
restituisce l'handoff aggiornato per lo step successivo. È prompt-chaining su sessioni fresche
(L3 §2 routing/chaining + L2 context offload + L5 loop).
Flag: è opzionale per-processo (stepping: fresh-context, default off); si accende dove i
passi sono lunghi/indipendenti (migrazioni, guide multi-step, fan-out pesanti).
Quando NON: task brevi o dove serve continuità stretta di ragionamento tra i passi.

3. Cron usa-e-getta (autocancellante)

Cosa: un cron one-shot che si esegue una volta e si autocancella, senza lasciare job residui.
Come: cron add con schedule.kind:"at" (istante preciso) + `deleteAfterRun: true`.
Vale la regola permessi: il job non pubblica/spende da solo senza i permessi giusti; verificare con
cron list. In OpenClaw il lavoro cross-turno non va in background (muore): usa cron / sessions_spawn.
Quando: reminder e azioni differite una-tantum (ricordami X alle 18, lancia Y domani mattina).
Aggancio: L5 §7 (cron/T4) + template L5_templates/cron_loop.md.


Changelog

  • v1 · 2026-07-21 — prima stesura: Token-Lean (+caveman on-request), fresh-context stepping (flag), cron usa-e-getta. Definite con Ettore sopra la base di conoscenza dei 5 strati.
LIVE
3 AGENTI AL LAVORO ora · Romeo: chat Discord #romeo-brainstorm · Romeo: chat Discord #romeo-bs2 · Romeo: chat Discord #romeo-bs326 task in corso su 16818 progetti monitoratiHomelab · Censire HD e creare gallerie dei contenutiHomelab · RAG + NotebookLM locale per documenti voluminosiKB · Costruzione KB (template + 3 argomenti pilota)KB · Obsidian: setup e usoVita · Automazione piano pasti (dispensa→ricette→spesa→piano)Vita · Lista ingredienti collegata a ricette + preferite77 sessioni registrate3 AGENTI AL LAVORO ora · Romeo: chat Discord #romeo-brainstorm · Romeo: chat Discord #romeo-bs2 · Romeo: chat Discord #romeo-bs326 task in corso su 16818 progetti monitoratiHomelab · Censire HD e creare gallerie dei contenutiHomelab · RAG + NotebookLM locale per documenti voluminosiKB · Costruzione KB (template + 3 argomenti pilota)KB · Obsidian: setup e usoVita · Automazione piano pasti (dispensa→ricette→spesa→piano)Vita · Lista ingredienti collegata a ricette + preferite77 sessioni registrate