selectools: Skill for Claude Code

Release Process

Preparing release version: $ARGUMENTS

Live Project State

• Current version: !grep -m1 __version__ src/selectools/__init__.py
• pyproject.toml version: !grep -m1 "version" pyproject.toml
• Tests: !pytest tests/ --collect-only -q 2>/dev/null | tail -1
• Examples: !ls examples/*.py | wc -l | tr -d ' '
• Models: !grep -c "ModelInfo(" src/selectools/models.py
• StepTypes: !python3 -c "from selectools.trace import StepType; print(len(StepType))" 2>/dev/null
• Observer events (sync): !python3 -c "from selectools.observer import AgentObserver; print(len([m for m in dir(AgentObserver) if m.startswith('on_')]))" 2>/dev/null
• Last example: !ls examples/*.py | tail -1

CRITICAL: Git Workflow Rules

• Never push without explicit user approval — commit locally, then ask
• Always use PRs — never push directly to main
• Keep feature work on one branch — don't merge WIP to main
• No co-author lines in commits

---

Phase 1: Quality Gate — Lint, Tests, E2E

Run /lint (fix mode) to auto-format and check code quality. ALL must pass (the repo uses ruff + mypy + bandit — NOT black/isort/flake8):

• ruff check src/ tests/ (lint; isort+flake8 replacement)
• ruff format src/ tests/ --check (format; black replacement)
• mypy src/
• bandit -c pyproject.toml -r src/

Then run the full test suite (use the project venv, e.g. .venv/bin/python -m pytest):

pytest tests/ -q          # full suite — do NOT shortcut to a subset

E2E hard gate (real API, before tagging). Per feedback_evals_before_release, real-LLM e2e tests must run before every release — mock tests passed while a real SYSTEM-role bug shipped. Run the named gate files with whatever provider keys are set (each provider's tests skip if its key is absent):

python -u -m pytest tests/test_orchestration_evals.py tests/test_orchestration_e2e.py --run-e2e -v

Tip: do NOT pipe through tail (it block-buffers and hides progress); use -u and read the output file. If only one provider key is available, a scoped -k <provider> run validates that provider's real path quickly.