| name | hitl-blocker |
| description | Convert human-only blockers into visible GitHub issues. Use when work is blocked by missing credentials, secrets, DNS, billing, account permissions, approvals, or other user-held external state. |
HITL Blocker
Use this before reporting a blocker back to the user.
Workflow
- Identify the exact missing human-held item.
- Create or reuse labels:
HITL task and high priority when launch/work is blocked.
- Create a GitHub issue in the most relevant repo.
- Include where to set or obtain the value.
- Include why it blocks the work.
- Include the verification command to rerun afterward.
- Link the failed run, PR, deployment, or command output when available.
Issue Must Include
- Missing item
- Owner/action needed
- Where to enter it
- Why it blocks launch/work
- Verification after completion
Guardrails
- Never include secret values in the issue.
- Do not bury human-only blockers in chat only.
- Do not keep retrying automation when credentials or account permissions are missing.