Code Quality Gate

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:

{
  "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

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

2. Ruff Formatter

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

3. Mypy Type Checker

   uv run mypy .
   

All-in-One Command

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

Gate Criteria

PASS condition: All checks complete without errors

✓ 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

## 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

## 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)

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

TypeScript

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

Go

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

Rust

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.