Lint

Lint

Deterministic quality check workflow.

Input

Scope: $ARGUMENTS

Steps

1. Detect the repo's configured checkers from .pre-commit-config.yaml and CI config
2. Run deterministic checks that already exist in the project
3. Run plugin policy checks when appropriate
4. Report failures grouped by category
5. Fix only when the user asked for fixing; otherwise review and explain

Commands to Run

# Linting, formatting, and type checking
uv run prek run --files $ARGUMENTS
# Fallback when no .pre-commit-config.yaml:
# uv run ruff format --check $ARGUMENTS
# uv run ruff check $ARGUMENTS

# Tests (if scope includes test files)
uv run pytest $ARGUMENTS -v --tb=short

Policy Checks

# Typing boundary policy (Any outside boundary modules)
bash ${CLAUDE_PLUGIN_ROOT}/scripts/check-typing-boundaries.sh $ARGUMENTS

Output

Group results by category:

## Lint Results

### Formatting
✅ Pass / ❌ Fail (N issues)

### Linting
✅ Pass / ❌ Fail (N issues: list rule IDs)

### Type Checking
✅ Pass / ❌ Fail (N issues)

### Policy
✅ Pass / ❌ Fail (Any usage outside boundary modules: list files)