Definizione breve

Deliverable scritto che raccoglie, per una data opportunità di prodotto, ciò che il team sa del suo ambiente — business, prodotto, cliente, utente, tecnica, regole di settore, norme, cultura di campo, concorrenza, decisioni già prese — e che qualifica ogni elemento a seconda che sia saputo, creduto, dubbio o taciuto.

Definizione dettagliata

Il termine non ha una definizione consolidata: nella maggior parte dei team, «il contesto» è un paragrafo introduttivo in testa a una specifica, scritto per orientare il lettore prima di entrare nella soluzione.

Negli articoli di questo blog, il documento di contesto è un artefatto autonomo, precedente alla specifica e indipendente da essa. Ha uno stato (bozza, in revisione, validato), un responsabile e una data di ultimo aggiornamento; le sue sezioni sono legate ai rischi di prodotto che esaminano anziché alle discipline che le redigono.

Una differenza di scala lo separa dal Contesto: il contesto è lo spazio di lavoro durevole legato a uno scopo, il documento di contesto è uno scritto datato che ne restituisce lo stato per un'opportunità precisa.

Uso nel dominio

Usato per designare il deliverable che acquista valore quando la capacità di produrre software smette di essere rara, e per contrapporre alla specifica e alla roadmap un artefatto che inquadra il problema invece di descrivere la soluzione.

Sinonimi e varianti

«Il 00-context», dal nome del file che lo ospita in testa alla cartella di un'opportunità; «il contesto di un'opportunità».

Da non confondere con

• specifica — descrizione del comportamento atteso del prodotto, scritta per essere costruita. Presuppone l'inquadramento già fatto; il documento di contesto lo produce.
• nota di inquadramento — sintesi breve che fissa un perimetro e un obiettivo per avviare un lavoro. Decide; il documento di contesto espone ciò su cui si decide, dubbi compresi.
• roadmap — sequenza datata di ciò che verrà costruito. Ordina decisioni già prese; il documento di contesto prepara quelle che non lo sono ancora.
• Contesto — spazio di lavoro durevole che raccoglie attorno a uno scopo fonti, note, decisioni e bozze. Il documento ne è una restituzione scritta e datata, non lo spazio stesso.

Esempi

Il modello 00-context.md annotato con i rischi che esamina — sostenibilità del business, valore lato acquirente, valore e usabilità, fattibilità.

I quattro registri di qualificazione che impone: ciò che so, ciò che credo, ciò che mi fa dubitare, ciò che non si dice.

Ambiguità / dibattiti

L'uso corrente — un capitolo di contesto dentro una specifica — e l'uso adottato qui non designano lo stesso oggetto, pur avendo lo stesso nome. La differenza sta nell'autonomia: un capitolo esiste per introdurre una soluzione già prevista, il documento esiste prima che sia stata scelta alcuna soluzione.