{
  "title": "Architecture Decision Record",
  "description": "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.",
  "language": "en",
  "questions": [
    {
      "hint": "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.",
      "text": "What decision did you make, and what problem was it solving?",
      "type": "text",
      "order": 1,
      "required": true
    },
    {
      "hint": "Include the options that were ruled out early and why — those often contain the most important context.",
      "text": "What were the other options you seriously considered?",
      "type": "text",
      "order": 2,
      "required": true
    },
    {
      "hint": "Team expertise, existing infrastructure, performance requirements, cost, compliance, timeline, other teams' systems.",
      "text": "What constraints made some options impossible or impractical?",
      "type": "text",
      "order": 3,
      "required": true
    },
    {
      "hint": "Distinguish between 'this was clearly right' and 'this was the least-bad option given what we knew'.",
      "text": "How confident were you in this decision at the time?",
      "type": "rating_scale",
      "order": 4,
      "options": {
        "max": 5,
        "min": 1,
        "maxLabel": "Very confident",
        "minLabel": "Not confident"
      },
      "required": true
    },
    {
      "hint": "What does this decision make harder? What did you knowingly give up? Did the team agree on those tradeoffs?",
      "text": "What tradeoffs did you accept, and were they explicit at the time?",
      "type": "text",
      "order": 5,
      "required": true
    },
    {
      "hint": "Scale thresholds, team size changes, new tooling, a specific failure mode, a dependency being deprecated.",
      "text": "Under what conditions should this decision be revisited?",
      "type": "text",
      "order": 6,
      "required": true
    },
    {
      "hint": "The thing that would have changed the analysis — or confirmed it faster.",
      "text": "What do you wish you'd known before making this decision?",
      "type": "text",
      "order": 7,
      "required": false
    }
  ]
}