תבנית רשומת החלטה של מייקל נייגארד

זוהי התבנית מתוך Documenting architecture decisions - Michael Nygard. אפשר להשתמש ב-adr-tools לניהול קובצי ה-ADR.

בכל קובץ ADR, כתבו את הסעיפים האלה:

כותרת

מצב

מהו המצב, כמו מוצעת, התקבלה, נדחתה, הוצאה משימוש, הוחלפה וכדומה?

הקשר

מהי הבעיה שאנחנו רואים ומניעה את ההחלטה או השינוי הזה?

החלטה

מהו השינוי שאנחנו מציעים ו/או עושים?

השלכות

מה נעשה קל יותר או קשה יותר לביצוע בגלל השינוי הזה?