Flusso di contribuzione

Questo repository privilegia pull request ristrette e revisionabili rispetto a grandi riscritture della piattaforma.

Flusso predefinito

Apri o confermi prima un issue se la modifica riguarda comportamento, architettura o policy per i contributori.
Crea un branch o worktree focalizzato.
Implementa la fetta completa più piccola che possa essere revisionata autonomamente.
Aggiorna la documentazione in apps/docs per le modifiche di comportamento visibili all’utente o al contributore.
Aggiorna le note a livello di repo in docs/*.md quando la modifica riguarda architettura, CI/CD, migration o postura operativa.
Esegui il set di verifica locale prima di richiedere una revisione.

pnpm lint
pnpm docs:lint
pnpm typecheck
pnpm test
pnpm build

Usa esecuzioni mirate quando restringi i fallimenti:

pnpm --filter app test
pnpm --filter api test
pnpm --filter control-plane test
pnpm --filter worker test

Quando un branch vivrà più a lungo di una piccola correzione, preferisci un worktree separato. Vedi Worktree.

mescolare refactor non correlati in una PR di funzionalità
cambiare i contratti delle route senza aggiornare la documentazione
pubblicare nella documentazione affermazioni architetturali che il codice non soddisfa ancora
unire un ampio churn di dipendenze a modifiche del comportamento del prodotto