Vai al contenuto

Workflow Operativo

Regola Fondamentale

Un passo confermato alla volta

Non procedere con lo step successivo finché il precedente non è verificato e confermato. Questo è il risultato di esperienze precedenti con tool AI che procedevano in autonomia causando danni.

Workflow per Ogni Task

1. LEGGI      → SPEC.md + CLAUDE.md + documentazione del modulo coinvolto
2. ANALIZZA   → Esplora i file che verranno toccati
3. PIANIFICA  → Presenta piano dettagliato: cosa, in che ordine, quali file
4. ATTENDI    → Aspetta approvazione esplicita
5. ESEGUI     → Step by step, un pezzo alla volta
6. VERIFICA   → Test concreto: build ok, log puliti, risposta HTTP corretta
7. DOCUMENTA  → Se hai preso decisioni architetturali, aggiorna SPEC.md

Non saltare step. Non unire step. Non andare avanti da soli.

Comandi Ufficiali

Questi comandi hanno un significato predefinito e inequivocabile. Qualsiasi altra parola simile richiede chiarimento prima di procedere.

SYNC PROD

Porta in produzione solo i file modificati dall'ultimo deploy. - Non tocca: database, .env, Nginx, cartella uploads - Prima: mostra lista esatta dei file che verranno modificati - Dopo conferma: procede file per file

DEPLOY FULL

Deploy completo con build inclusa (frontend e/o backend). - Prima: mostra lista completa di tutto quello che verrà toccato - Richiede: conferma esplicita su ogni ambiente - Mai: eseguire su prod senza aver prima testato su dev

BUILD

Compila frontend e/o backend senza deployare. - Solo compilazione, zero modifiche all'ambiente - Mostra output e segnala errori

HOTFIX

Intervento urgente su produzione. Unica keyword che sblocca accesso al server .51. - Modifica minima e chirurgica — nessun refactoring - Loggato in .claude/handoff/hotfix-YYYY-MM-DD.md - Dopo il fix su prod: stesso fix applicato su dev - Verifica entrambi gli ambienti prima di chiudere

ROLLBACK

Torna all'ultimo stato funzionante. - Prima: chiede su quale commit/backup tornare - Prima: chiede se rollback solo codice o anche database

CLEANUP

Rimuove file temporanei, cache, log vecchi. - Mai toccare file di progetto, uploads, database - Prima: mostra lista di cosa verrà rimosso

STATUS

Mostra stato attuale di tutti i servizi senza modificare nulla. - pm2 status, stato Nginx, connessione DB, spazio disco

Gestione Errori

Quando si incontra un errore:

  1. Non tentare fix creativi senza spiegare cosa si sta facendo
  2. Mostrare l'errore completo (log, stack trace, output)
  3. Proporre massimo 2-3 soluzioni con pro e contro
  4. Aspettare che Gianluca scelga
  5. Se bloccante e non si sa come procedere: dirlo chiaramente

Handoff tra Sessioni

Se una sessione termina con task incompleto, si scrive: .claude/handoff/YYYY-MM-DD-[nome-task].md

Contenuto obbligatorio:

  • Stato attuale del lavoro
  • Decisioni prese e motivazione
  • Prossimo step esatto da eseguire

Alla sessione successiva: leggere il file di handoff prima di qualsiasi altra cosa.

Regole Assolute (mai derogabili)

Regola Motivazione
MAI eseguire comandi su PROD senza keyword HOTFIX Protezione ambiente produzione
MAI modificare .env, Nginx, DB senza mostrare prima il piano Prevenzione danni irreversibili
MAI DROP/DELETE su tabelle senza conferma scritta Protezione dati
MAI commit diretto su main Stabilità del branch principale
MAI push senza approvazione Controllo deploy
MAI aggiungere dipendenze npm senza proposta Controllo dipendenze
MAI dichiarare un task completato senza verifica concreta Qualità delle release
MAI iniziativa su bug fuori dal task corrente — segnalare, non correggere Scope control