alirezarezvani/claude-skills / engineering/human-gate/skills/human-gate
human-gate
UnverifiedUse before shipping anything that needs human sign-off (a plan, spec, report, page, migration or irreversible action). Builds a review page with review_page_builder.py and runs human_gate.py, which refuses to close with an open blocker or no named reviewer.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.8 KB |
| assets/batch.v1.schema.json | config | 3.5 KB |
| assets/example_review_sidecar.md | markdown | 1.9 KB |
| references/feedback_batching.md | markdown | 7.7 KB |
| references/human_in_the_loop_canon.md | markdown | 6.5 KB |
| references/review_loop_discipline.md | markdown | 8.1 KB |
| scripts/feedback_parser.py | script | 16.3 KB |
| scripts/human_gate.py | script | 24.1 KB |
| scripts/review_page_builder.py | script | 33.6 KB |
assets/batch.v1.schema.json
View on GitHub{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/alirezarezvani/claude-skills/engineering/human-gate/batch.v1.schema.json",
"title": "human-gate feedback batch (batch.v1)",
"description": "One round of batched human review feedback, produced by feedback_parser.py from a review sidecar and consumed by human_gate.py.",
"type": "object",
"required": ["schema", "target", "round", "reviewer", "approved", "blocking_open", "counts", "items"],
"additionalProperties": false,
"properties": {
"schema": { "const": "batch.v1" },
"target": {
"type": "string",
"description": "Basename of the artifact under review."
},
"round": {
"type": "integer",
"minimum": 1,
"description": "1-based review round. Capped by human_gate.py --max-rounds."
},
"reviewer": {
"type": "string",
"description": "Named human reviewer. Empty fails gate rule G3 — approval belongs to a person, not a team."
},
"approved": {
"type": "boolean",
"description": "True only when an APPROVE item exists AND no BLOCKER/MAJOR item is open. Absence of blockers alone is not approval."
},
"blocking_open": {
"type": "integer",
"minimum": 0,
"description": "Count of open BLOCKER + MAJOR comment items. Non-zero fails gate rule G2."
},
"counts": {
"type": "object",
"description": "Item tally keyed by BLOCKER/MAJOR/MINOR/NIT/EDIT/APPROVE.",
"additionalProperties": { "type": "integer", "minimum": 0 }
},
"items": {
"type": "array",
"items": { "$ref": "#/$defs/item" }
},
"overall_note": {
"type": "string",
"description": "Unanchored commentary from ## NOTE sections, joined by blank lines."
}
},
"$defs": {
"item": {
"type": "object",
"required": ["id", "kind", "severity", "block", "quote", "feedback"],
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^f[0-9]+$",
"description": "Stable within a round: f1, f2, ..."
},
"kind": {
"enum": ["comment", "edit", "approve"],
"description": "comment = a change request; edit = a verbatim replacement the reviewer already wrote; approve = explicit sign-off."
},
"severity": {
"enum": ["BLOCKER", "MAJOR", "MINOR", "NIT"],
"description": "BLOCKER/MAJOR block the gate. Google Code Review Developer Guide ladder; matches markdown-html/md-review."
},
"block": {
"type": "string",
"description": "Block anchor id assigned by review_page_builder.py (b1, b2, ...). Empty for unanchored items."
},
"quote": {
"type": "string",
"description": "Verbatim text the reviewer selected. Checked against the artifact by feedback_parser.py --target; a mismatch is reported as a problem, not silently ignored."
},
"feedback": {
"type": "string",
"description": "What needs to change, and why."
},
"before": {
"type": "string",
"description": "EDIT items only: the exact current text."
},
"after": {
"type": "string",
"description": "EDIT items only: the reviewer's exact replacement. MUST be carried across verbatim — never paraphrased, never reverted, and applied to the generating source as well as the rendered artifact."
}
}
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |