Mappa concettuale — Dal bisogno alla consegna
agg. 2026-08-25mappe_concettuali/ciclo_del_lavoro.mdMappa concettuale — Dal bisogno alla consegna
Il percorso che fa un lavoro da quando nasce a quando è chiuso, e i due punti in cui può
fermarsi. Ordine di lettura: dall'alto verso il basso.
Fonti: CATPIT_vault/CICLO_TASK.md (agg. 2026-08-19) · CATPIT_vault/LOOP_LAVORO.md ·AGENTS.md (sezione Coda e Richieste) · METODO_DI_LAVORO.md.
graph TD
B([Bisogno di Ettore]):::umano --> RIC["Richiesta<br/>detta in chat o scritta in CATPIT"]:::umano
RIC --> DOM{"È chiara?"}:::scelta
DOM -->|no| Q["Domanda di definizione<br/>stanza Richieste · q###"]:::blocco
Q --> RIC
DOM -->|sì| PROG["Progetto · p##"]:::dato
PROG --> FASE["Fase · A ideazione · B pianificazione<br/>C realizzazione · D check"]:::dato
FASE --> TASK["Task · a##"]:::dato
TASK --> SUB["Sottotask<br/>checklist spuntabile"]:::dato
TASK --> PRONTO{"È pronto?<br/>ha prossima azione<br/>+ criterio di fatto"}:::scelta
PRONTO -->|no| NP["Resta fuori dalla coda<br/>sezione 'Non pronti'"]:::blocco
PRONTO -->|sì| CODA[["Coda · /tasks"]]:::coda
CODA --> CRON["Il cron pesca il primo<br/>e sveglia l'agente"]:::infra
CRON --> ESE["Esecuzione<br/>Romeo · Archimede · Creso"]:::agente
ESE --> VER{"Il criterio di fatto<br/>è verificato davvero?"}:::scelta
VER -->|no| ESE
VER -->|sì| FATTO["Task = Fatto<br/>esito + evidenza scritti"]:::ok
FATTO --> REF["Referto nella stanza Discord<br/>+ fonte-verità allineata"]:::ok
REF --> B
ESE -.->|"serve una decisione<br/>che solo Ettore può dare"| BLOC["Bloccato su Ettore<br/>lo mette e lo toglie l'API"]:::blocco
BLOC -.->|"Ettore risponde"| ESE
classDef umano fill:#3a2a0a,stroke:#e08a2e,color:#f5e6d0
classDef dato fill:#2a1420,stroke:#c85a8a,color:#f7dbe8
classDef scelta fill:#22201a,stroke:#c8a13a,color:#f7ecd0
classDef coda fill:#0f2233,stroke:#3a86c8,color:#dbeafe
classDef infra fill:#0f2233,stroke:#3a86c8,color:#dbeafe
classDef agente fill:#132a1e,stroke:#3fb27f,color:#d7f5e6
classDef ok fill:#12291c,stroke:#3fb27f,color:#d7f5e6
classDef blocco fill:#2e1414,stroke:#c85a5a,color:#f7dadaLe regole che si leggono dal disegno
- Il lavoro parte dalla coda, non dall'orologio. Il cron è stupido: prende il primo task pronto. Se la coda è vuota non si inventa lavoro — si scrivono le domande e ci si ferma.
- "Pronto" ha una definizione precisa: il task non è Fatto, non è bloccato su Ettore, ha una prossima azione scritta e un criterio di fatto verificabile da un comando o da un file. Senza criterio, il ciclo automatico non lo lavora: lo segnala e passa oltre.
- "Bloccato su Ettore" non si scrive a mano. Lo mette l'API quando una richiesta aperta cita il task, e lo toglie da sola quando la richiesta viene chiusa.
- Chiudere è un fatto, non una dichiarazione. Un task si chiude con esito ed evidenza; "sembra giusto" e "funziona bene" non sono criteri, sono impressioni.