davideandClaude Sonnet 5.5
8f25143aa5
- Spezza il registro delle decisioni in docs/decisions/DD-XXX.md, con indice - Ripulisce DATABASE.md dalla storia delle migration e aggiunge la sezione Lettura - Riduce PROJECT_STATE.md a una pagina; la procedura di allestimento passa in OPERATIONS.md - Aggiunge OPERATIONS.md, GLOSSARIO.md, trappole note e checklist in ARCHITECTURE.md - Sintetizza la copertura test di badge.md e documenta docs/archive - Allinea AGENTS.md, README.md e la regola Cursor (tolto l'obbligo di develop, in contrasto con DD-019) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
1.6 KiB
DD-019 — Il branch dei commit lo decide l'utente
Data: 4 settembre 2026
Stato: Accettata — sostituisce DD-003
Contesto
DD-003 prevedeva di lavorare su develop e portare su main solo dopo i test. Nella pratica
è successo il contrario: main è arrivato a 43 commit di vantaggio su develop, che è rimasto
fermo. Una regola che nessuno segue è peggio di nessuna regola, perché rende inaffidabile tutto
il resto del documento — e con più assistenti AI in gioco il rischio vero non era il branch
sbagliato, ma un agente che committa o pusha per conto suo.
Decisione
È l'utente a dire su quale branch va un commit. L'assistente può consigliare un branch
dedicato quando la modifica è rischiosa o parallela ad altro lavoro, ma non cambia branch, non
committa, non fa push e non apre PR di propria iniziativa. In assenza di indicazioni si lavora
dove si trova il repository, di fatto main.
Alternative scartate
- Tenere DD-003 e riallineare
develop→ si sarebbe rotta di nuovo alla prima fretta. - Dismettere
develop→ si perderebbero le preview Vercel, utili quando servono davvero.
Conseguenze
mainè insieme produzione e branch di lavoro: ogni commit deve lasciare l'app funzionante, quindi la rete di sicurezza sono i test (vedi DD-020), non il branch.developesiste ancora ma è indietro: la sua preview Vercel non rappresenta lo stato attuale finché non viene riallineata.
Riesame
Se il team cresce oltre una persona che scrive codice, o se un lavoro lungo ha bisogno di stare
fuori produzione per più di qualche giorno.