run-quality-gate

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

1. Map gate to command - Validate custom_command if gate="custom"

2. Execute via Bash - Timeout: 5 minutes, capture stdout/stderr

3. Parse result - Exit code 0 = passed, non-zero = failed

4. Extract errors - Lines with "error", "failed", TS#### codes

5. 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