---

name: code-quality-gate description: Ensure complete compliance with code quality standards. Use before commit, before PR creation, or when quality issues are detected.

Code Quality Gate Skill

Ensure complete compliance with code quality standards.

Trigger Conditions

• Before commit
• Before PR creation
• When quality issues are detected
• When explicitly requested

Quality Checks

Quality commands are loaded from .claude/workflow-config.json:

Copy{
  "quality": {
    "lint": "uv run ruff check --fix .",
    "format": "uv run ruff format .",
    "typecheck": "uv run mypy .",
    "test": "uv run pytest",
    "all": "uv run ruff check --fix . && uv run ruff format . && uv run mypy ."
  }
}

Check Sequence

1. Ruff Linter

   Copyuv run ruff check .
   uv run ruff check --fix .  # Auto-fix
   

2. Ruff Formatter

   Copyuv run ruff format --check .
   uv run ruff format .  # Auto-format
   

3. Mypy Type Checker

   Copyuv run mypy .
   

All-in-One Command

Copyuv run ruff check --fix . && uv run ruff format . && uv run mypy .

Gate Criteria

PASS condition: All checks complete without errors

Copy✓ ruff check: 0 errors
✓ ruff format: No changes needed
✓ mypy: Success: no issues found

FAIL condition: Any check has errors → Block commit/PR creation

Report Format

Copy## Code Quality Gate Report

### Check Results
| Tool | Status | Details |
|------|--------|---------|
| ruff check | ✓ PASS | 0 errors |
| ruff format | ✓ PASS | No changes |
| mypy | ✓ PASS | No issues |

### Overall Result: PASS

Failure Report Format

Copy## Code Quality Gate Report

### Check Results
| Tool | Status | Details |
|------|--------|---------|
| ruff check | ✗ FAIL | 3 errors |
| ruff format | ✓ PASS | No changes |
| mypy | ✗ FAIL | 2 issues |

### Details

#### ruff check errors:
- src/auth.py:10: E501 line too long
- src/auth.py:20: F401 unused import

#### mypy issues:
- src/auth.py:15: error: Incompatible types

### Overall Result: FAIL

Commit blocked. Please fix the issues above.

Instructions for Claude

Before committing code:

1. Check if quality gate is enabled

   • Read .claude/workflow-config.json
   • Check workflow.quality_gate_required

2. If enabled:

   • Run the quality.all command
   • Parse the output
   • If any errors:
     • Block the commit
     • Report the errors
     • Offer to fix automatically
   • If no errors:
     • Allow the commit
     • Report success

3. Auto-fix behavior:

   • ruff check --fix automatically fixes many issues
   • ruff format automatically formats code
   • Re-run checks after fixes
   • Only block if issues remain after auto-fix

Language-Specific Commands

Python (default)

Copyuv run ruff check --fix . && uv run ruff format . && uv run mypy .

TypeScript

Copynpm run lint -- --fix && npm run format && npm run typecheck

Go

Copygolangci-lint run --fix && go fmt ./... && go vet ./...

Rust

Copycargo clippy --fix --allow-dirty --allow-staged && cargo fmt && cargo check