Lärstig 06Lektion 6 / 6

Dokumentera ett beslut som går att granska senare

Dokumentera problemet, alternativen, underlaget, accepterade begränsningar och villkor för omprövning. Gör beslutet att bygga eller köpa begripligt efter mötet.

Grundnivå9 minGranskad

Publicerad av Så skriver vi

Det här lär du dig

  • Skilj krav, antaganden och observationer åt i ett beslut.
  • Jämför realistiska alternativ med samma omfattning.
  • Ange ett villkor för omprövning som kan ändra beslutet.

Bevara resonemanget

Ett beslutsmöte ger ett val. En beslutsanteckning bevarar varför valet var rimligt.

Utan resonemanget kan ett senare team missta en tillfällig begränsning för en permanent princip. Teamet kan också upprepa en utvärdering som organisationen redan har genomfört.

AWS beskriver architectural decision records som ett sätt att dokumentera beslut och deras sammanhang. Samma kortfattade struktur kan hjälpa med en verksamhetsmodell för AI-utveckling. Håll anteckningen tillräckligt kort för att de ansvariga ska läsa den.

Jämför realistiska alternativ

Ett fiktivt företag behöver underhålla sin avtalsapplikation. Det överväger tre alternativ:

AlternativHuvudsakligt kvarstående ansvarFråga som kan ändra beslutet
Behåll nuvarande arbetsflöde med individuella AI-verktygKoppla samman kontext, granskning, release och underlag interntKan teamet upprätthålla samordningsarbetet?
Bygg en intern utvecklingsplattformUtforma, integrera och driva förmåganHar organisationen finansierat långsiktigt ansvar?
Skaffa en programvarufabrik som tjänstStyra användningen och integrera kvarstående ansvarUppfyller tjänsten nödvändiga kontroller och gränssnitt?

Använd samma applikationsomfång, tidsperiod, dataantaganden och förväntningar på tjänsten. Undvik att jämföra en mogen köpt tjänst med bara prototypkostnaden för ett internt system.

En kombination kan också passa. En befintlig plattform kan tillhandahålla miljöer och driftsättning medan en programvarufabrik samordnar utvecklingen. Förklara gränssnittet och ansvaret i stället för att tvinga fram ett konstlat val mellan allt eller inget.

Skriv sex delar

  1. Sammanhang. Ange problemet och konsekvensen av att lämna det oförändrat.
  2. Krav. Lista villkoren som ett alternativ måste uppfylla.
  3. Alternativ. Dokumentera de seriösa alternativen och deras viktigaste avvägningar.
  4. Underlag. Länka utvärderingar, kostnadsantaganden och olösta frågor.
  5. Beslut. Ange valt alternativ, omfattning, ansvarig och accepterade begränsningar.
  6. Omprövning. Definiera datumet eller den observerbara händelsen som kräver en ny bedömning.

Skilj vad du observerade från vad du förväntar dig. ”Utvärderingen slutförde denna underhållsändring” är en observation. ”Tjänsten halverar den årliga underhållskostnaden” är en prognos som behöver underlag och uttryckliga antaganden.

Ta med den starkaste invändningen

För avtalsapplikationen kan en köpt tjänst minska integrationsarbetet men skapa ett beroende av en extern leverantör. Dokumentera invändningen och exportövningen som hanterar en del av den. Ta inte bort invändningen för att teamet föredrar alternativet.

Ange vilka olösta punkter som blockerar aktivering. Tilldela resten ansvariga och datum. Ett beslut att gå vidare förvandlar inte en obesvarad kontrollfråga till ett verifierat resultat.

Ompröva anteckningen när krav eller underlag förändras. Lägg till ett nytt beslut när valet ändras och bevara det tidigare resonemanget. Fortsätt till praktiska Taigascenarier för att tillämpa principerna i produktens arbetsflöden.

Gör övningen

Skriv ett beslut på en sida för lektionens fiktiva avtalsapplikation. Jämför tre alternativ. Ta med ett skäl att avvisa ditt föredragna alternativ, ett olöst antagande och ett mätbart villkor för omprövning.

Ladda ned övningsblad (Markdown)

Kontrollera din förståelse

Vilket påstående ger det mest användbara villkoret för omprövning?

Källor och vidare läsning

Relaterad läsning från Taiga