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>
34 lines
1.6 KiB
Markdown
34 lines
1.6 KiB
Markdown
# DD-019 — Il branch dei commit lo decide l'utente
|
|
|
|
**Data:** 4 settembre 2026
|
|
**Stato:** Accettata — sostituisce [DD-003](DD-003.md)
|
|
|
|
**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.
|
|
- `develop` esiste 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.
|