Architecture Decision Record

Active theme: Light

← dokument

Vem kan skapa en ADR?

Tänk på områden som specifika personer, specifika roller, specifika team eller specifika avdelningar; överväg också om det finns personer, roller, team eller avdelningar som kan beställa en ADR, det vill säga begära en som någon annan kommer att skriva.

Exempelsvar: Vem som helst i vår organisation som har läst README-sidan om arkitekturbeslutsposter kan föreslå en ADR, vilket innebär att personen kan börja skriva den och dela den med teamet.

Vad motiverar att man tar upp en ADR?

Tänk på områden som din organisations teams arbetssätt, ditt programvarusystems struktur, samordning mellan team, långsiktig underhållbarhet, externa gränssnitt, vem du vill ska dra nytta, och liknande.

Exempelsvar: Vi vill skapa en ADR när vi vill att framtida utvecklare ska förstå ”varför” bakom det vi gör.

Vad motiverar att man inte tar upp en ADR?

Tänk på områden som beslut som inte handlar om arkitektur, eller är små, till exempel minimal risk eller fristående eller för en enda utvecklare, eller redan helt täcks någon annanstans, till exempel av standarder, policyer eller dokumentation, eller är tillfälliga, till exempel tillfälliga lösningar, koncepttest eller experiment.

Exempelsvar: Vi vill hoppa över en ADR när ett beslut är begränsat i omfattning, tid, risk och kostnad, eller redan täcks någon annanstans.

Vad är en ADR:s livscykel?

Tänk på områden som skapandeprocess, undersökningsprocess, beslutsprocess, genomförandeprocess och avvecklingsprocess. Överväg hur man spårar ADR:ens livscykel över tid, till exempel hur man flyttar ADR:en från ett tillstånd till nästa, och även hur man kommunicerar detta till intressenterna.

Exempelsvar: Vi vill att en ADR ska ha fem livscykelsteg: Inleda (Initiating) → Undersöka (Researching) → Utvärdera (Evaluating) → Genomföra (Implementing) → Underhålla (Maintaining) → Avveckla (Sunsetting).

Vilka är kriterierna för en ADR:s livscykelsteg?

Tänk på områden som godkännandekriterier för en ADR, det vill säga hur vet du att den är tillräckligt bra för att gå från ett livscykelsteg till nästa? Är problemet tydligt formulerat? Har alternativen övervägts? Är avvägningarna tillräckligt väl förstådda och dokumenterade? Finns allt relevant sammanhang på plats? Är alla relevanta intressenter involverade? Har all återkoppling arbetats in?

Exempelsvar: Vi vill att en ADR röstas om av intressenter när det aktiva teamet har 1) slutfört sin undersökning, 2) slutfört sin utvärdering, 3) publicerat ADR-förslaget för intressenterna med en begäran om kommentarer och en tidsram på en vecka, 4) alla kommentarer från intressenterna har arbetats in och åtgärdats.

Vilka roller och ansvar samverkar med en ADR?

Tänk på roller som förslagsställare, undersökare, utvärderare, granskare, godkännare, underhållare och liknande. Tänk på ansvar som kommunikation med intressenter, att säkerställa att förväntningar uppfylls, delning på webbplatsen eller intranätet och periodisk granskning av arbetet, särskilt när relevanta förändringar sker.

Exempelsvar: Vi vill att varje ADR alltid ska ha en primär kontaktperson, en sekundär kontaktperson och ett ansvarigt team; dessa ansvarar för kommunikation, publicering, underhåll, periodisk granskning minst en gång per år och eventuell avveckling vid behov.

Hur samverkar styrning med en ADR?

Tänk på områden som din organisations arbetssätt, eventuella särskilda efterlevnadsbehov, till exempel gällande juridiska aspekter eller personalaspekter, hur du vill hantera samsyn kontra konflikt kontra eskalering. Finns det områden eller personer eller team som kan ha större inflytande än andra när det gäller en ADR, till exempel genom att kunna godkänna den, rösta om den eller lägga in veto mot den?

Exempelsvar: Styrningen av en ADR sker i denna prioritetsordning: vd:n, teknikchefen, juridikchefen, teamet som genomför en ADR, experterna i teamet som har mest kunskap om ADD:n. Ingen annan har styrning om det inte beskrivs i ADR:en.

Vilka principer samverkar med en ADR?

Tänk på områden som din organisations arbetssätt, som omfattar att röra sig snabbt kontra att röra sig långsamt, beslutssamsyn kontra beslutskonflikt, och riskpreferenser kontra säkerhetspreferenser, offentlig diskussion kontra privat diskussion, och liknande.

Exempelsvar: Vi använder ledarskapsprinciperna handlingsbenägenhet (bias for action), oenighet-och-åtagande (disagree-and-commit), 70 % uppskattningar är tillräckligt bra för lätt reversibla, lätt isolerbara beslut, och offentliga arbetssätt med undantag för konfidentiell information såsom beskrivs i vår organisations sekretessavtal.