Architecture Decision Record

Active theme: Light

← skjöl

Tillögur að góðum ADR

Einkenni góðrar ADR:

  • Rökstuðningur: Útskýrðu ástæður þess að gera tiltekna AD-ákvörðun. Þetta getur falið í sér samhengi (sjá hér að neðan), kosti og galla ýmissa mögulegra valkosta, samanburð á eiginleikum, umræður um kostnað og ávinning og fleira.

  • Afmörkuð: Hver ADR ætti að fjalla um eina AD-ákvörðun, ekki margar.

  • Tímastimplar: Tilgreindu hvenær hvert atriði í ADR er skrifað. Þetta er sérstaklega mikilvægt fyrir þætti sem geta breyst með tímanum, svo sem kostnað, tímaáætlanir, stækkun og þess háttar.

  • Óbreytanleg: Breyttu ekki fyrirliggjandi upplýsingum í ADR. Bættu heldur við nýjum upplýsingum til að breyta ADR, eða láttu nýja ADR leysa hana af hólmi.

Einkenni góðs kafla um „samhengi“ í ADR:

  • Útskýrðu stöðu stofnunarinnar og viðskiptaforgangsröðun.

  • Taktu með rökstuðning og sjónarmið byggð á félagslegri samsetningu og færni teymanna þinna.

  • Taktu með kosti og galla sem skipta máli og lýstu þeim á þann hátt sem samræmist þörfum þínum og markmiðum.

Einkenni góðs kafla um „afleiðingar“ í ADR:

  • Útskýrðu hvað leiðir af því að taka ákvörðunina. Þetta getur falið í sér áhrif, niðurstöður, afurðir, eftirfylgni og fleira.

  • Taktu með upplýsingar um allar síðari ADR-skrár. Það er tiltölulega algengt að ein ADR kalli á fleiri ADR-skrár, til dæmis þegar ein ADR tekur stórt yfirgripsmikið val sem aftur skapar þörf fyrir fleiri smærri ákvarðanir.

  • Taktu með öll ferli til rýni eftir á. Algengt er að teymi rýni hverja ADR mánuði síðar, til að bera upplýsingar ADR saman við það sem gerðist í raun og læra og vaxa.

Ný ADR getur komið í stað fyrri ADR:

  • Þegar tekin er AD-ákvörðun sem kemur í stað eða ógildir fyrri ADR, ætti að búa til nýja ADR