Scegliere lo strumento per capacità, non per abitudine

Tipo

Pratica

La scelta dello strumento dovrebbe partire dalle proprietà che l'artifact deve avere. Il testo strutturato è adatto quando contano rationale, assunzioni, vincoli e decisioni. Gli strumenti di diagrammazione sono utili quando il valore principale è rendere visibili relazioni, boundary, dipendenze o flussi. Tabelle e matrici funzionano bene per confronti, ownership, copertura e mapping tra dimensioni. I modelli strutturati sono utili quando serve coerenza semantica, riuso e viste multiple della stessa realtà. I formati machine-readable sono preferibili quando un contratto può essere validato o consumato da strumenti automatici, come per API, eventi o schema dati. Il versionamento è importante quando l'artifact deve evolvere insieme al software o quando serve una storia delle modifiche verificabile. Gli spazi collaborativi sono utili durante discovery, workshop e fasi esplorative, ma il loro contenuto non diventa automaticamente evidenza durevole. Le domande discriminanti sono: l'artifact deve essere collaborativo o principalmente consumato? Deve essere verificabile da una macchina? Deve vivere accanto al codice? Deve supportare review e storia delle modifiche? Deve offrire viste diverse dello stesso modello? Deve essere leggibile da stakeholder non tecnici? Nessuno strumento eccelle in tutte queste dimensioni, quindi cercare un tool unico per ogni artifact tende a spostare il compromesso dal contenuto alla piattaforma. Il criterio migliore è scegliere la capacità minima che preserva chiarezza e mantenibilità.