> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Flusso di contribuzione

> Flusso previsto per proporre, implementare, convalidare e documentare le modifiche.

# Flusso di contribuzione

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

## Flusso predefinito

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

## Controlli locali minimi

```bash theme={null}
pnpm lint
pnpm docs:lint
pnpm typecheck
pnpm test
pnpm build
```

Usa esecuzioni mirate quando restringi i fallimenti:

```bash theme={null}
pnpm --filter app test
pnpm --filter api test
pnpm --filter control-plane test
pnpm --filter worker test
```

## Cosa include una buona PR

* un insieme di modifiche coerente
* codice tipizzato
* test per il comportamento modificato
* aggiornamenti alla documentazione
* una breve nota su rollout, replay o impatto operativo se rilevante

Quando un branch vivrà più a lungo di una piccola correzione, preferisci un worktree separato. Vedi [Worktree](/it/contributing/worktrees).

## Cosa evitare

* 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

## Leggi anche

* [Worktree](/it/contributing/worktrees)
* [Etichetta per issue e PR](/it/contributing/issue-pr-etiquette)
* [Processo di release](/it/contributing/release-process)
* [CI/CD](/it/operations/cicd)