← Back to Template Library
Engineeringengineeringarchitecturedecisionsadrdesign

Architecture Decision Record

Captures the options considered, the constraints that drove the choice, the tradeoffs accepted, and the conditions under which the decision should be revisited. The reasoning survives the engineer who made it.

7 questions~25 min to complete

Use this template

Create a draft session from this template, then customize it before publishing.


Questions

1.

What decision did you make, and what problem was it solving?

Describe both the choice and the underlying problem it addressed — not just 'we chose Postgres' but why Postgres was the answer to that specific question.

Long textRequired
2.

What were the other options you seriously considered?

Include the options that were ruled out early and why — those often contain the most important context.

Long textRequired
3.

What constraints made some options impossible or impractical?

Team expertise, existing infrastructure, performance requirements, cost, compliance, timeline, other teams' systems.

Long textRequired
4.

How confident were you in this decision at the time?

Distinguish between 'this was clearly right' and 'this was the least-bad option given what we knew'.

Rating scaleRequired
5.

What tradeoffs did you accept, and were they explicit at the time?

What does this decision make harder? What did you knowingly give up? Did the team agree on those tradeoffs?

Long textRequired
6.

Under what conditions should this decision be revisited?

Scale thresholds, team size changes, new tooling, a specific failure mode, a dependency being deprecated.

Long textRequired
7.

What do you wish you'd known before making this decision?

The thing that would have changed the analysis — or confirmed it faster.

Long textOptional

What you'll get

After each completed session, Mayetik generates a structured AI summary. Here's an example of the output format — the actual content reflects each respondent's answers.

Sample AI summary

Key themes from this session

The respondent's answers highlighted three recurring themes — each supported by specific examples drawn from their experience. The summary captures what was said, not what was expected.

Standout insights

Two responses stood out as unusually detailed and pointed to an area worth following up on. The full text of each answer is preserved below the summary.

Suggested next steps

Based on the patterns in this session, the AI identified three concrete actions for the project team to consider. These are drawn directly from the respondent's own suggestions.

Generated from 7 questions · ~25 min session


Ready to start from this template?

The template will be created as a draft session, so you can adjust the title, questions, and wording before publishing.