{
  "example_kind": "invented job and manual worksheet",
  "slug": "ambiguous-done-handoff",
  "title": "Stop a done handoff from becoming the next team’s surprise",
  "layout": "handover",
  "story": "When a sender says done but the receiver has not tried the result, I want the completion boundary stated so the next team knows what it can safely use.",
  "problem": "A builder reports an export done after an internal test. The receiver has not opened the delivered file and later finds a missing field.",
  "symptoms": [
    "The sender’s internal completion is read as receiving acceptance.",
    "The receiving action is implicit rather than requested.",
    "A file arrives without a named owner for corrections."
  ],
  "failed_workaround": "A stronger done label cannot replace the receiver opening the actual delivered artifact.",
  "before": "Export done. You can use it now.",
  "after": "Handoff boundary: implementation was checked internally; receiving acceptance is pending. Please open the delivered file and verify the required fields before use. The missing field remains owned by the builder for correction. Close the handoff only when the receiver checks the corrected file and acknowledges the agreed use.",
  "success_check": "The receiver knows which boundary passed, which artifact to inspect and who owns the gap it finds.",
  "choices": [
    [
      "Only internal checks passed",
      "Request receiving verification",
      "A delivery label is not proof of usability in the receiving context."
    ],
    [
      "The receiver finds a concrete gap",
      "Keep correction owned",
      "The handoff remains open for the agreed missing condition."
    ],
    [
      "Receiving use is demonstrated",
      "Record the accepted boundary",
      "Retain the artifact/version that supports the conclusion."
    ]
  ],
  "route": [
    {
      "label": "Describe the actual stage",
      "capability": "task-record",
      "action": "Keep the delivery work identified and its state accompanied by a boundary note.",
      "human_check": "Use the actual states available in the account."
    },
    {
      "label": "Request the receiving check",
      "capability": "task-comment",
      "action": "Name the delivered version, required fields and receiver’s next action.",
      "human_check": "The receiver opens the actual artifact rather than relying on its label."
    },
    {
      "label": "Keep the correction visible",
      "capability": "daily-report",
      "action": "State the missing field and next receiving review in the update.",
      "human_check": "Close only after the agreed receiving evidence exists."
    }
  ],
  "editor": {
    "heading": "Prepare a receiving brief",
    "fields": [
      {
        "key": "sender",
        "label": "What the sender actually checked",
        "example": "Internal implementation test",
        "help": "Do not expand this into receiving acceptance."
      },
      {
        "key": "artifact",
        "label": "Delivered artifact or version",
        "example": "Export file v2",
        "help": "Name what the receiver will inspect."
      },
      {
        "key": "receiver",
        "label": "Receiving action",
        "example": "Open the file and check required fields",
        "help": "Make the next action usable."
      },
      {
        "key": "gap",
        "label": "Known gap and owner",
        "example": "Missing field; builder owns correction",
        "help": "Keep the gap attached to an owner."
      },
      {
        "key": "close",
        "label": "Receiving closure check",
        "example": "Receiver checks the corrected file and confirms agreed use",
        "help": "Describe the actual closure proof."
      }
    ],
    "template": "Completion-boundary handoff\nVerified by sender: {sender}.\nArtifact for receiving review: {artifact}.\nReceiver action: {receiver}.\nOpen gap: {gap}.\nClosure evidence: {close}.\nDo not treat sender completion as receiving acceptance without that check."
  },
  "limitations": "The file and missing field are illustrative. Task labels do not certify external artifacts or receiving readiness.",
  "tasks": [
    [
      "State the sender’s completed boundary",
      "Builder",
      "Internal test completion is evidenced without claiming receiving acceptance."
    ],
    [
      "Perform the receiving check",
      "Receiving owner",
      "The actual delivered file is opened and required fields inspected."
    ],
    [
      "Retain correction responsibility",
      "Handoff coordinator",
      "The missing field has an owner and a corrected-file receiving check."
    ]
  ],
  "faqs": [
    [
      "Is the sender’s internal test worthless?",
      "No. It is useful evidence for that boundary; it does not prove the receiver can use the delivered file."
    ],
    [
      "Should we change the official task status vocabulary?",
      "Use the states available in your account and explain the receiving boundary in a note rather than inventing a native state."
    ],
    [
      "How does TeamBoost support this handoff?",
      "Documented task state, ownership and comments let you keep the sender’s evidence and receiver’s request tied to the work. Receiving acceptance is still a human decision."
    ]
  ]
}