human-gate-designer

name	human-gate-designer
license	Apache-2.0
description	Designs human-in-the-loop review points for DAG workflows. Determines what to present to the human, how to collect feedback, and how to route approve/reject/modify decisions back into the DAG. Use when adding approval gates, designing review UX, or handling human feedback in agent workflows. Activate on "human review", "approval gate", "human-in-the-loop", "human gate", "approval workflow", "user review step". NOT for executing human gates at runtime (use dag-runtime with Temporal signals), general UX design, or chatbot conversation design.
allowed-tools	Read,Write,Edit
metadata	{"category":"Design & Creative","tags":["human","gate","designer","human-review","approval-gate"],"pairs-with":[{"skill":"task-decomposer","reason":"Task decomposition identifies which DAG nodes require human approval gates"},{"skill":"output-contract-enforcer","reason":"Human gate inputs and outputs need schema validation before routing decisions"},{"skill":"reactflow-expert","reason":"Human gates are visualized as interactive approval nodes in DAG dashboards"}]}
category	Agent & Orchestration
tags	["human-in-the-loop","approval-gates","safety","oversight","workflow"]

Human Gate Designer

Designs human-in-the-loop review points in DAG workflows: what to present, how to collect feedback, how to route decisions back into the DAG.

---

When to Use

✅ Use for:

• Deciding WHERE in a DAG to place human gates
• Designing WHAT the human sees at each gate
• Defining HOW feedback routes back (approve/reject/modify)
• Balancing automation speed with human oversight

❌ NOT for:

• Runtime execution of human gates (use dag-runtime + Temporal signals)
• General UI/UX design (use design skills)
• Chatbot conversation flow (different pattern)

---

Gate Placement Decision Tree

flowchart TD
  A{Is the action irreversible?} -->|Yes| G1[Gate BEFORE the action]
  A -->|No| B{Is output user-facing?}
  B -->|Yes| G2[Gate AFTER generation, BEFORE delivery]
  B -->|No| C{Cost > $0.50 for remaining nodes?}
  C -->|Yes| G3[Gate at the cost threshold]
  C -->|No| D{Confidence score < 0.7?}
  D -->|Yes| G4[Gate on low-confidence outputs]
  D -->|No| N[No gate needed]

Where to Place Gates

Situation	Gate Position	Why
Irreversible action (deploy, send email, submit)	Before the action	Can't undo
User-facing deliverable (report, website, PR)	After generation, before delivery	Quality check
High cost remaining (>$0.50)	Before expensive phase	Budget confirmation
Low confidence output (<0.7)	After the uncertain node	Expert judgment needed
Ambiguous task decomposition	After planning, before execution	Validate the plan
First run of a new template DAG	After each phase	Build trust gradually

---

Gate Presentation Design

What the Human Sees

┌──────────────────────────────────────────────────────┐
│  🔍 Human Review: [Node Name]                        │
│                                                      │
│  Context: [1-2 sentences: what happened so far]      │
│                                                      │
│  Output to Review:                                   │
│  ┌──────────────────────────────────────────────────┐│
│  │ [The node's output, formatted for readability]   ││
│  │ [Key decisions highlighted]                      ││
│  │ [Confidence: 0.82]                               ││
│  └──────────────────────────────────────────────────┘│
│                                                      │
│  Cost so far: $0.08 / $0.50 budget                  │
│  Remaining nodes: 4 (est. $0.12)                    │
│                                                      │
│  [✅ Approve]  [✏️ Modify]  [❌ Reject]              │
│                                                      │
│  If modifying, what should change?                   │
│  ┌──────────────────────────────────────────────────┐│
│  │ [text input for human feedback]                  ││
│  └──────────────────────────────────────────────────┘│
└──────────────────────────────────────────────────────┘