Skip to content

If a Quality Gate Fails

Quality gate failures are normal. They’re part of the process. Claude handles them automatically in most cases.

  • Claude monitors the PR after it’s opened
  • If a gate fails, Claude reads the failure details, fixes the issue, and pushes an update
  • The gates rerun on the new commit
  • This cycle repeats until all gates pass

Claude will surface the issue to you if it can’t resolve it automatically.

This usually means the failure reveals an ambiguity in your requirements, or the fix requires a product decision.

Describe what behaviour you want and Claude will implement it.

Don’t skip gates or bypass CI. The gates exist to keep main clean.

If a gate seems wrong (for example, a security rule that’s too strict for your use case), tell Claude. It can adjust the configuration rather than bypass the check.