Verifica prima di completare
Principio: l'evidenza precede la dichiarazione di "fatto".
La regola
Niente claim di completamento senza evidenza fresca dell'esecuzione.
Prima di scrivere "fatto / risolto / funziona / pronto":
- Identifica il comando che prova la claim (test, build, lint, type-check, curl, navigazione browser)
- Esegui il comando completo (non un subset, non da cache vecchia)
- Leggi l'output integrale e l'exit code
- Conferma che l'output corrisponda alla claim
- Solo allora comunica il successo
Red flag linguistici
Se stai per scrivere queste parole senza aver verificato, fermati:
- "dovrebbe funzionare"
- "probabilmente"
- "sembra funzionare"
- "il fix è semplice e non rompe nulla"
- "ho aggiornato X, ora dovrebbe andare"
Queste frasi indicano che stai per dichiarare done senza prova.
Rationalizzazioni da bloccare
| Pensiero |
Realtà |
| "Il lint passa, quindi funziona" |
Linter ≠ compiler ≠ test ≠ runtime |
| "Il type-check passa, quindi funziona" |
Compila ≠ funziona |
| "Il test unitario passa" |
Test unit ≠ integrazione ≠ E2E |
| "L'agente ha detto che ha finito" |
Richiede verifica indipendente |
| "L'ho già verificato 10 minuti fa" |
Lo stato può essere cambiato — rifai |
| "Ho fretta" |
Falsi positivi costano più tempo di una verifica |
Test che valgono qualcosa
Un test verde che non può fallire non prova nulla. Evita:
- Test sull'implementazione: asserire chiamate interne o campi privati invece dell'output osservabile (Pest/PHPUnit:
shouldReceive su un metodo interno; Jest/Vitest: toHaveBeenCalledWith su helper; flutter_test: leggere lo state del widget invece di find.text)
- Test tautologici: l'atteso è calcolato con la stessa logica del codice, o l'assert è sempre vero (
expect(true).toBe(true)). Prova: rompi il codice, il test deve diventare rosso
- Mock ovunque: mocka solo i confini esterni (rete, tempo, servizi terzi), mai i tuoi moduli
- Fette orizzontali: tutti i test prima, tutto il codice poi. Meglio fette verticali: un comportamento, un test, il minimo codice, poi il successivo
Casi specifici del workflow
- Modifiche backend (Laravel/Node): esegui i test rilevanti + un curl reale o chiamata dell'endpoint
- Modifiche frontend (Vue/React): build + caricamento pagina nel browser (non solo HMR)
- Modifiche Flutter:
flutter analyze + build release per la piattaforma toccata
- Modifiche Docker/Traefik:
docker compose config + docker compose up in ambiente locale o di staging + curl al servizio esposto
- Modifiche KB / project-memory: rileggi il file dopo la scrittura, verifica frontmatter valido
- Modifiche presentazioni didattiche: build + apertura in browser, verifica che le slide non siano vuote o rotte
- Commit/push: dopo il push, verifica con
git log origin/<branch> che il commit sia arrivato
Eccezioni legittime
Non serve verifica per:
- Pura lettura/esplorazione senza modifiche
- Task esplicitamente di sola ricerca ("trovami dove sta X")
- Quando l'utente dice "non testare, voglio solo vedere il diff"
In tutti gli altri casi: se hai modificato, verifica.
Idee adattate da mattpocock/skills@59db609 (MIT, © 2026 Matt Pocock).
1---2name: verifica-prima-di-completare-23description: Prima di dichiarare una task completata, fixata, funzionante o pronta per il deploy, esegui il comando di verifica e leggi l'output. Da usare quando stai per scrivere "fatto", "risolto", "funziona", "pronto", "deployato" o equivalenti. NON da usare per task di pura esplorazione/lettura senza modifiche.4metadata:5 source: https://skillmd.com/skills/thomascasali/verifica-prima-di-completare-26---78# Verifica prima di completare910**Principio**: l'evidenza precede la dichiarazione di "fatto".1112## La regola1314Niente claim di completamento senza evidenza fresca dell'esecuzione.1516Prima di scrivere "fatto / risolto / funziona / pronto":17181. **Identifica** il comando che prova la claim (test, build, lint, type-check, curl, navigazione browser)192. **Esegui** il comando completo (non un subset, non da cache vecchia)203. **Leggi** l'output integrale e l'exit code214. **Conferma** che l'output corrisponda alla claim225. **Solo allora** comunica il successo2324## Red flag linguistici2526Se stai per scrivere queste parole senza aver verificato, **fermati**:2728- "dovrebbe funzionare"29- "probabilmente"30- "sembra funzionare"31- "il fix è semplice e non rompe nulla"32- "ho aggiornato X, ora dovrebbe andare"3334Queste frasi indicano che stai per dichiarare done senza prova.3536## Rationalizzazioni da bloccare3738| Pensiero | Realtà |39|---|---|40| "Il lint passa, quindi funziona" | Linter ≠ compiler ≠ test ≠ runtime |41| "Il type-check passa, quindi funziona" | Compila ≠ funziona |42| "Il test unitario passa" | Test unit ≠ integrazione ≠ E2E |43| "L'agente ha detto che ha finito" | Richiede verifica indipendente |44| "L'ho già verificato 10 minuti fa" | Lo stato può essere cambiato — rifai |45| "Ho fretta" | Falsi positivi costano più tempo di una verifica |4647## Test che valgono qualcosa4849Un test verde che non può fallire non prova nulla. Evita:50- **Test sull'implementazione**: asserire chiamate interne o campi privati invece dell'output osservabile (Pest/PHPUnit: `shouldReceive` su un metodo interno; Jest/Vitest: `toHaveBeenCalledWith` su helper; flutter_test: leggere lo state del widget invece di `find.text`)51- **Test tautologici**: l'atteso è calcolato con la stessa logica del codice, o l'assert è sempre vero (`expect(true).toBe(true)`). Prova: rompi il codice, il test deve diventare rosso52- **Mock ovunque**: mocka solo i confini esterni (rete, tempo, servizi terzi), mai i tuoi moduli53- **Fette orizzontali**: tutti i test prima, tutto il codice poi. Meglio fette verticali: un comportamento, un test, il minimo codice, poi il successivo5455## Casi specifici del workflow5657- **Modifiche backend (Laravel/Node)**: esegui i test rilevanti + un curl reale o chiamata dell'endpoint58- **Modifiche frontend (Vue/React)**: build + caricamento pagina nel browser (non solo HMR)59- **Modifiche Flutter**: `flutter analyze` + build release per la piattaforma toccata60- **Modifiche Docker/Traefik**: `docker compose config` + `docker compose up` in ambiente locale o di staging + curl al servizio esposto61- **Modifiche KB / project-memory**: rileggi il file dopo la scrittura, verifica frontmatter valido62- **Modifiche presentazioni didattiche**: build + apertura in browser, verifica che le slide non siano vuote o rotte63- **Commit/push**: dopo il push, verifica con `git log origin/<branch>` che il commit sia arrivato6465## Eccezioni legittime6667Non serve verifica per:68- Pura lettura/esplorazione senza modifiche69- Task esplicitamente di sola ricerca ("trovami dove sta X")70- Quando l'utente dice "non testare, voglio solo vedere il diff"7172In tutti gli altri casi: **se hai modificato, verifica**.7374Idee adattate da mattpocock/skills@59db609 (MIT, © 2026 Matt Pocock).