| name | run-quality-gate |
| description | Execute quality gate validation with configurable blocking behavior. Use when running type-check, build, tests, lint, or custom validation commands in orchestrators or workers to enforce quality standards. |
| allowed-tools | Bash, Read |
Run Quality Gate
Execute validation commands as quality gates with structured error reporting.
When to Use
- Type-check, build, test, lint validation
- Orchestrator phase validation
- Worker self-validation
Input
{
"gate": "type-check|build|tests|lint|custom",
"blocking": true,
"custom_command": "pnpm custom-validate"
}
Gate Commands
| Gate | Command |
|---|
| type-check | pnpm type-check |
| build | pnpm build |
| tests | pnpm test |
| lint | pnpm lint |
| custom | custom_command value |
Process
- Map gate to command - Validate custom_command if gate="custom"
- Execute via Bash - Timeout: 5 minutes, capture stdout/stderr
- Parse result - Exit code 0 = passed, non-zero = failed
- Extract errors - Lines with "error", "failed", TS#### codes
- Determine action:
- Passed → action="continue"
- Failed + blocking → action="stop"
- Failed + non-blocking → action="warn"
Output
{
"gate": "type-check",
"passed": true,
"blocking": true,
"action": "continue",
"errors": [],
"exit_code": 0,
"duration_ms": 2345,
"command": "pnpm type-check",
"timestamp": "2025-10-18T14:30:00Z"
}
Examples
Blocking gate passes:
{ "gate": "type-check", "blocking": true }
→ { "passed": true, "action": "continue", "errors": [] }
Blocking gate fails (stops workflow):
{ "gate": "build", "blocking": true }
→ { "passed": false, "action": "stop", "errors": ["Module not found: missing-module"] }
Non-blocking gate fails (warns only):
{ "gate": "lint", "blocking": false }
→ { "passed": false, "action": "warn", "errors": ["Missing semicolon"] }
Error Handling
- Timeout (5 min): Return failed with timeout error
- Missing custom_command: Return error
- Command not found: Return failed with exit_code=127
Notes
- Exit code 0 always = success regardless of output
- Blocking flag only affects action, not passed status
- Error extraction is best-effort
