{
  "context": "Tests hiding vendor/framework details behind a stable adapter and designing APIs around caller intent and actionable errors.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Design brief",
      "description": "Includes a design discussion before or with code for this non-trivial boundary change.",
      "max_score": 7
    },
    {
      "name": "Stable types",
      "description": "Public API uses stable domain/application types rather than vendor DTOs or raw provider responses.",
      "max_score": 10
    },
    {
      "name": "Vendor hidden",
      "description": "Hides provider-specific IDs, statuses, retry/idempotency mechanics, and response quirks inside the boundary where possible.",
      "max_score": 12
    },
    {
      "name": "Caller intent",
      "description": "Names the main operation by subscription/business intent rather than provider mechanics.",
      "max_score": 8
    },
    {
      "name": "Actionable errors",
      "description": "Exposes only errors or outcomes the subscription caller can meaningfully act on.",
      "max_score": 10
    },
    {
      "name": "Retries/fallbacks",
      "description": "Places retry, fallback, timeout, or idempotency decisions inside the payment boundary rather than in callers.",
      "max_score": 8
    },
    {
      "name": "Two designs",
      "description": "Compares at least two possible designs for the provider boundary.",
      "max_score": 8
    },
    {
      "name": "Split rationale",
      "description": "Splits domain subscription policy from provider infrastructure because they hide different knowledge/change for different reasons.",
      "max_score": 8
    },
    {
      "name": "No pass-through",
      "description": "Avoids an adapter that merely forwards charge/create calls with the same vendor-shaped parameters and returns.",
      "max_score": 10
    },
    {
      "name": "Contract comments",
      "description": "Documents interface contract details such as invariants, side effects, defaults, and non-goals.",
      "max_score": 9
    },
    {
      "name": "Result summary",
      "description": "Summarizes hidden complexity, created interfaces, rejected alternatives, and remaining tradeoffs.",
      "max_score": 10
    }
  ]
}