> ## 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.

# Pianificazione Linear

> Il pacchetto di pianificazione canonico e il modello operativo Linear raccomandato per questo repository.

# Pianificazione Linear

Questo repository ora dispone di un pacchetto di pianificazione dedicato per Linear sotto `planning/linear/`.

Quel pacchetto è il ponte di esecuzione previsto tra:

* documenti sorgente estesi in `docs/`
* gestione attiva dei progetti in Linear
* lavoro di implementazione a livello di issue
* scoperte significative emerse durante l'implementazione

## File canonici

* `planning/linear/README.md`
* `planning/linear/OPERATING_MODEL.md`
* `planning/linear/PROJECT_BRIEF.md`
* `planning/linear/BACKLOG.yaml`
* `planning/linear/ISSUE_TEMPLATES.md`

## Struttura raccomandata in Linear

* un team primario per l'esecuzione attiva
* iniziative per i flussi strategici
* progetti per risultati concreti
* milestone per i checkpoint
* un documento `Overview` per progetto
* issue per porzioni di lavoro delle dimensioni di una PR

Il workspace attuale utilizza un portfolio di iniziative/progetti piuttosto che un progetto ombrello ridondante.

## Perché esiste

Il repository aveva accumulato:

* un PRD esteso
* una sequenza di implementazione numerata
* pianificazione delle migrazioni
* backlog di hardening
* strategia dei feature-flag
* revisione della personalizzazione e del builder

Questi documenti restano ancora validi, ma dovrebbero essere materiale sorgente, non superfici di esecuzione parallele.

## Regola generale

Se un artefatto di pianificazione non si mappa chiaramente su:

* iniziativa
* progetto
* milestone
* issue
* documento di progetto

allora probabilmente non dovrebbe diventare un nuovo documento di pianificazione.

## Comportamento di sincronizzazione

`pnpm linear:sync` e `pnpm linear:sync:apply` trattano `planning/linear/*` come la fonte per:

* iniziative
* progetti
* milestone
* un documento `Overview` di progetto per progetto
* issue seed

Gli aggiornamenti di progetto seminati sono disponibili, ma sono espliciti piuttosto che automatici:

```bash theme={null}
pnpm linear:sync:apply:with-updates
```

Blocchi significativi, lacune di parità e lacune architetturali riscontrate durante lo sviluppo non dovrebbero restare nei log delle chat o nel testo delle PR. Dovrebbero diventare una issue Linear creata o aggiornata prima della chiusura della sessione.

## Prossima lettura

* [Roadmap](/it/roadmap)
* [Adversarial Review](/it/operations/adversarial-review)
* [Platform Architecture](/it/platform/architecture)