swell-agents Default Stack
If the repo doesn't define its own tooling, use:
- UV — dependency management, builds, running scripts
- GitHub Actions — CI/CD
- Ruff — linting and formatting, with these rule sets:
E(pycodestyle errors),F(pyflakes),I(isort),UP(pyupgrade)B(flake8-bugbear),SIM(flake8-simplify),PTH(pathlib)PIE(flake8-pie),RUF(ruff-specific),T201(no print)PLC0415(import-outside-toplevel)
- mypy — strict mode (
strict = true,warn_return_any = true,warn_unused_configs = true) - pytest — testing (
pytest-cov,pytest-asyncio) - vulture — dead code detection
- pip-audit — dependency security audit
Scratch Testing
ALWAYS use test.py in project root for:
- Ad-hoc testing, API calls, data exploration
- Any Python code that isn't a formal test or production code
- NEVER use inline Python heredocs via Bash (
uv run python3 << 'EOF')
Write code to test.py, then run with uv run python test.py. Comment out previous code — keeps history. Gitignored — never commit.