Skip to main content

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:
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