Skip to content

alivirgo/Major-AI-Skills / plugins/mas-ai-workflows/skills/ai-human-handoff-contract

ai-human-handoff-contract

Verified

Define and test AI→human handoff as a versioned state machine with multi-signal triggers, review packets, approval binding, and no silent consent. Use for escalations, approvals, and irreversible agent actions.

AI Human Handoff Contract AI Skill Guide (Claude)

Overview & Engine Architecture

Handoff is architecture, not a confidence fallback. Model confidence ≠ risk. Production contracts combine deterministic policy triggers, UX friction signals, and calibrated scores—with a never-auto list no score can override.

Claude operates as a Principal Agent Operations Designer for state machines, multi-signal escalation, minimum-sufficient review packets, and approval binding.

┌─────────────────────────────────────────────────────────────┐
│  Triggers → state (active|awaiting_review|approved|…)       │
│  → review packet → human transition → resume or stop        │
│  Silence / timeout ≠ approval                               │
└─────────────────────────────────────────────────────────────┘

Actions the contract must name

ActionWhen
ResolveLow risk, covered knowledge
ClarifyAmbiguous; budget N questions
RouteWrong team/queue
Escalate / approveJudgment, high stake, policy
StopWould require unauthorized guess

Triggers (multi-signal; per-intent thresholds)

  • Explicit human request (always honor)
  • Policy/risk flags (refunds, legal, medical, money movement)
  • Loop detection (N turns unresolved)
  • Sentiment / severity / account tier / $ value
  • Tool/schema failure / citation verify fail
  • Calibrated confidence per intent (verify calibration first)
  • Never-answer list (hard escalate/stop)

Owner configures thresholds; agent must not self-approve.


States & rules

active → awaiting_review → approved|rejected|expired|cancelled

  • Define permitted tools per state (mutating tools blocked while awaiting).
  • Bind approval to hash(action + critical inputs); material change → re-review.
  • Timeout policy: pending stays pending or expires—never auto-approve on silence.
  • Unavailable reviewer → fallback queue + user messaging.

Review packet (minimum sufficient)

User goal · verified facts · evidence links · actions attempted · proposed action · uncertainty/risk reason · expiry/SLA · owner · workflow version. Minimize PII (@ai-pii-redaction-review). Prefer links over full transcript dumps.


Tests required

Missing evidence · reviewer unavailable · conflicting approvals · expiry · cancel · duplicate notify · approval after input mutation · agent attempting self-approve.


Deliverable

Versioned contract YAML/doc + eval cases + reviewer template. Weekly calibration: false escalations vs misses; promote incidents into @ai-evaluation-dataset.

Related skills

@prompt-regression-gate, @llm-json-contract-check, @ai-pii-redaction-review, @ai-citation-verification

Agent Operational Directive

MANDATORY: Derive triggers from risk, not confidence alone. Block irreversible actions without bound approval. Silence is not permission. Agents cannot approve themselves.

Sources

Human escalation architecture briefs; multi-signal CS handoff guides; per-intent confidence calibration playbooks; agent-led escalation patterns.

finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall