Decisioun record templat for business case

This ADR templat emphasises makin a business case for a decisioun, includin criteria, candidates, an costs.

Top-level

• Title
• Status
• Evaluation criteria
• Candidates tae consider
• Research an analysis o each candidate
  • Daes/doesna meet criteria an why
  • Cost analysis
  • SWOT analysis
  • Opinions an feedback
• Recommendation

Law-level deep dive

Title:

• A short present tense imperative phrase, less than 50 characters, like a git commit message.

Status:

• Ane o proposed, accepted, rejected, deprecated, superseded, etc.

Evaluation criteria:

• Summary: explain briefly whit we seek tae discover an why.

• Specifics

Candidates tae consider:

• Summary: explain briefly hoo we discoverit candidates, an draw attention tae onie outliers.

• List aw candidates an relatit options; whit are we evaluatin as potential solutiouns?

• Specifics

Research an analysis o each candidate:

• Summary: explain briefly the research methods, an draw attention tae patterns, clusters, an outliers.

• Daes/doesna meet criteria an why

  • Summary

  • Specifics

• Cost analysis

  • Summary

  • Examples

    • Licensin, sic as contract agreements an legal commitments

    • Trainin, sic as upskillin an chynge management

    • Operatin, sic as support an maintenance

    • Meterin, sic as bandwidth an CPU uisage

• SWOT analysis

  • Summary

  • Strengths

  • Weaknesses

  • Opportunities

  • Threats

• Internal opinions an feedback

  • Summary

  • Examples

    • Bi the team, ideally written bi the actual person

    • Frae ither stakeholders

    • Quality attributes a.k.a. cross-functional requirements

• External opinions an feedback

  • Summary

  • Wha is providin the opinion?

  • Whit are ither candidates ye consideret?

  • Whit are ye makin?

    • Examples

      • B2B or B2C

      • external-facin or employee-only

      • desktop or mobile

      • pilot or production

      • monolith or microservices

  • Hoo did ye evaluate the candidates?

  • Why did ye chuise the winner?

  • Whit is happenin since than?

    • Examples

      • Hoo is the winner performin?

      • Whit % o real-warld production user traffic is flowin throu the winner?

      • Whit kinds o integratiouns are involved, sic as wi continuous delivery pipelines, content management systems, analytics an metrics, etc.?

      • Kennin whit ye ken noo, whit wud ye advise fowk tae dae differently?

• Anecdotes

Recommendation:

• Summary

• Specifics