Veďte záznam rozhodnutí v Jira: pamatujte si, proč jste zvolili tento přístup

Šest týdnů po vydání se někdo zeptá, proč tým zvolil e-mailová oznámení místo denního souhrnu. Úkoly v Jira vysvětlují, co se vytvořilo. Komentář říká „dohodnuto při plánování“. Lidé, kteří si diskusi pamatují, nemají čas a nikdo si není jistý, které omezení rozhodlo.

Záznam rozhodnutí tuto mezeru vyplní. Zaznamenává situaci, možnosti, volbu a její důsledky na místě, které tým najde. S Decision Log v Power Pack je tento záznam u úkolu v Jira, blízko práce, kterou vysvětluje.

Příručka sleduje fiktivní tým zákaznického portálu při psaní jednoho užitečného záznamu, jeho propojení s realizací a přehodnocení při změně potřeb zákazníků.

Rozhodněte, co si zaslouží záznam

Záznam rozhodnutí nemusí zachycovat každý rozhovor. Začněte volbami, které mohou budoucí kolegové oprávněně zpochybnit: způsob realizace, závislost, hranice vydání nebo vědomý kompromis s důsledky přesahujícími jeden malý úkol.

Pro náš tým portálu je doručování oznámení vhodným tématem. Volba okamžitého e-mailu ovlivňuje implementaci, testování, pokyny podpory i očekávání zákazníků. Tým zvažoval alternativy a očekává nové posouzení, pokud vzroste objem zpráv.

Naopak oprava překlepu v popisku tlačítka nejspíš vlastní záznam rozhodnutí nepotřebuje. Rozdíl je praktický: pomohlo by pochopení důvodů někomu později výsledek udržovat, měnit nebo vysvětlovat?

Užitečným vzorem jsou záznamy architektonických rozhodnutí, často nazývané ADR. Původní článek Michaela Nygarda popisuje stručné záznamy zachovávající kontext, rozhodnutí, stav a důsledky, přičemž nahrazená rozhodnutí zůstávají s odkazem na novou volbu. Zdroj je uveden níže. Náš příklad tento lehký přístup používá pro realizační rozhodnutí v Jira.

Dejte rozhodnutí jasné místo

Vyberte úkol v Jira, který nejlépe zastupuje práci ovlivněnou volbou. V příkladu tým používá úkol koordinující oznámení zákaznického portálu. Ten už směřuje čtenáře k implementaci a testování.

Řekněte týmu, kde záznam je. Decision Log v Power Pack patří k úkolu, proto vytvořte jednoduchý zvyk pro jeho hledání. Poznámka v koordinačním úkolu může uvádět, že rozhodnutí o oznámeních se vedou tam. Pokud tým má samostatný index projektu, přidejte úkol běžným postupem i tam.

Nerozšiřujte kopie mezi několik úkolů s očekáváním, že zůstanou shodné. Jiné úkoly mohou čtenáře odkázat na zvolené místo. Exportované kopie jsou užitečné pro diskusi, ale tým má vědět, který záznam uvádí aktuální stanovisko.

Napište kontext před závěrem

Kontext vysvětluje, proč otázka existuje. Má rozlišit fakta, omezení a předpoklady, aby budoucí čtenář poznal, která část se změnila.

Tým portálu píše: „Zákazníci potřebují vědět, když se požadavek na podporu významně změní. Současná služba už posílá e-maily. První vydání portálu neobsahuje schránku. Očekáváme, že většina požadavků bude mít málo zákaznicky viditelných změn stavu, ale objem oznámení po spuštění jsme dosud neměřili.“

Tento odstavec je užitečnější než „e-mail je nejjednodušší možnost“. Vysvětluje výchozí bod a zviditelňuje předpoklad. Vyhýbá se i tvrzení, že e-mail bude vždy správným kanálem.

Podle potřeby přidejte odkazy na podpůrný průzkum. Pokud volbu ovlivnil technický experiment, označte úkol Jira s jeho výsledky. Pokud záleží na zákaznické zpětné vazbě, shrňte relevantní vzorec bez zbytečného kopírování soukromých informací do rozhodnutí.

Kontext má novému kolegovi umožnit pochopit situaci bez rekonstrukce celé schůzky. Zachovejte podrobnosti ovlivňující volbu a nesouvisející diskusi ponechte na původním místě.

Porovnejte skutečné alternativy

Užitečný záznam ukazuje, co tým mohl udělat. Zahrňte vážně zvažované alternativy s poctivou výhodou a nevýhodou každé z nich.

Jde o ilustrativní hodnocení tohoto fiktivního systému. Jiný tým už může mít schránku nebo souhrnnou službu, což srovnání úplně změní. Dobré zaznamenávání rozhodnutí tuto závislost na kontextu zviditelňuje.

Neoslabujte zamítnuté možnosti jen proto, aby vybraná vypadala nevyhnutelně. Souhrn má skutečnou výhodu: méně samostatných zpráv. Tým jej pro toto vydání nevolí, protože při současných předpokladech více záleží na rychlosti a rozsahu implementace.

Rozlišujte také možnost od samostatného rozhodnutí. Zda ukazovat celý zákazníkův text v e-mailu může vyžadovat vlastní kontrolu. Sloučení všech otázek oznámení do jedné položky ztěžuje pochopení, co bylo skutečně dohodnuto.

Vyjádřete volbu a její důsledky

Napište rozhodnutí úplnou větou: „Pro první vydání portálu budeme posílat e-mail při významné zákaznicky viditelné změně stavu požadavku na podporu. Interní úpravy zprávu nespustí.“

Pak vysvětlete proč: „Využije se existující doručovací kanál a zákazníci získají rychlé aktualizace pokroku při zvládnutelném rozsahu vydání.“ Věta popisuje důvod tohoto příkladu; netvrdí, že e-mail je obecně levnější nebo spolehlivější.

Důsledky zaslouží stejnou pozornost. Tým potřebuje společnou definici významné změny. Testování musí pokrýt opakované aktualizace a duplicity. Podpora musí vysvětlit, které události vytvářejí zprávy. Zákazníci s aktivními požadavky mohou stále dostávat více e-mailů, než chtějí.

Užitečný důsledek přirozeně vede k následné práci. Zde zaznamenejte dopad a úkol řiďte v Jira. Záznam rozhodnutí má pomáhat zjistit, proč je práce nutná, aniž by se stal druhým backlogem s konkurenčními stavy a vlastníky.

Vytvořte záznam v Power Pack

Otevřete Power Pack u příslušného úkolu v Jira a použijte Decision Log (ADR Lite). Přidejte položku s názvem vyjadřujícím skutečnou volbu, například „Použít okamžitý e-mail pro běžné aktualizace stavu portálu“.

Vyberte kategorii vhodnou pro tým a začněte stavem Proposed, dokud je výsledek v diskusi. Přidejte rozhodující osobu a po volbě i datum rozhodnutí. Pole rozhodující osoby zaznamenává vlastníka volby; zadání jména za vás neprovede schvalovací proces.

Vyplňte kontext, přidejte alternativy s klady a zápory, vyberte zvolenou možnost a napište důsledky. Obsah udržujte srozumitelný člověku, který se diskuse neúčastnil.

Podle potřeby přidejte klíče dotčených úkolů Jira. Editor přijímá odkazy na úkoly oddělené čárkami, které mohou určit implementační a testovací úkoly ovlivněné rozhodnutím. Berte je jako zaznamenané reference; pro vztah mezi úkoly použijte zvlášť běžné propojení Jira.

Projděte hotový záznam se zapojenými lidmi. Zkontrolujte shodu vybrané možnosti a písemného vysvětlení. Než kolegy požádáte, aby se spolehli na nejnovější verzi, potvrďte stav uložení, zejména při lokálním nebo offline stavu.

Vyjasněte aktuální stanovisko pomocí stavu

Power Pack nabízí Proposed, Accepted, Rejected a Superseded. Dohodněte jejich používání, aby čtenář odlišil nápad čekající na rozhodnutí od volby, která už řídí realizaci.

Když Maya, produktová manažerka, rozhodne o oznámeních, tým zaznamená datum a označí položku Accepted. Stav popisuje postavení rozhodnutí. Nedokazuje dokončení implementace, úspěch testů ani povolení vydání.

Stejné rozlišení je důležité pro Rejected. Není-li návrh přijat, krátké vysvětlení může dalšímu člověku ušetřit opakování průzkumu, o němž neví, že už proběhl. Zachovejte užitečné odůvodnění, i když nenásleduje realizační úkol.

Přehodnoťte rozhodnutí při změně předpokladů

Po spuštění si představte rozšíření portálu o zákazníky s mnoha aktivními požadavky. Podpora hlásí, že někteří dostávají několik běžných e-mailů denně. To je nový kontext přímo související s původním předpokladem nízkého objemu zpráv.

Tým před návrhem změny otevře starý záznam. Nyní může oddělit dřívější rozumný kompromis od dnešní otázky produktu. Existující rozhodnutí vysvětluje volbu okamžitého e-mailu; nebrání lepšímu přístupu za jiných podmínek.

Vytvořte novou položku Proposed pro denní souhrn. Power Pack umožňuje duplikovat položku do záznamu Proposed jako výchozí bod. Pečlivě zkontrolujte každé zkopírované pole: staré předpoklady, data a důsledky už nemusejí platit.

Po přijetí nové volby označte starý záznam Superseded a v poli náhrady odkažte na nové rozhodnutí. Původní odůvodnění ponechte čitelné, nepřepisujte je, jako by tým souhrn zamýšlel od začátku.

Jde o týmovou dokumentační praxi. Záznamy zůstávají editovatelné, proto dohodněte vytváření náhradních položek pro podstatné změny a běžné úpravy vyhraďte opravám či upřesnění. Nepovažujte záznam za neměnnou auditní stopu.

Používejte záznam při každodenní práci

Využijte jej při příchodu nového člena, návrhu přepracování nebo otázce, proč úkol obsahuje neobvyklý požadavek. Hledání a filtry pomohou najít položku v záznamu daného úkolu. Power Pack umí také exportovat Markdown ve stylu ADR pro kontrolu nebo jiný dokumentační proces.

Před sdílením exportu ověřte, že odpovídá aktuální položce, a označte úkol, kde tým záznam udržuje. Stažený dokument je snímek; budoucí úpravy úkolu neaktualizují kopii již odeslanou jinam.

Začněte nedávným rozhodnutím, ke kterému se tým pravděpodobně vrátí. Napište kontext, skutečné alternativy, zvolený přístup a důsledky. Umístěte záznam vedle práce v Jira do Power Pack a požádejte kolegu, který u diskuse nebyl, aby jej přečetl. Dokáže-li vysvětlit smysl volby a co by odůvodnilo změnu, záznam odvádí užitečnou práci.

• Michael Nygard: dokumentování architektonických rozhodnutí