biz-bud/CLAUDE.local.md

CLAUDE.local.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

Testing

# Run all tests with coverage (uses pytest-xdist for parallel execution)
make test

# Run tests in watch mode
make test_watch

# Run specific test file
make test TEST_FILE=tests/unit_tests/nodes/llm/test_unit_call.py

# Run single test function
pytest tests/path/to/test.py::test_function_name -v

# Run crash tests for resilience testing
python tests/crash_tests/run_crash_tests.py

# Run specific test categories
pytest -m "not slow"  # Skip slow tests
pytest -m integration # Only integration tests
pytest -m e2e        # Only end-to-end tests
pytest -m unit       # Only unit tests

Code Quality

# Run all linters (ruff, basedpyright, pyrefly, codespell) - ALWAYS run before committing
make lint-all

# Format code with ruff
make format

# Run pre-commit hooks (recommended)
make pre-commit

# Advanced type checking with Pyrefly
pyrefly check .

# Lint single file
make lint-file FILE_PATH=path/to/file.py

# Format single file
make black FILE_PATH=path/to/file.py

# Generate coverage report
make coverage-report

Development Services

# Start docker services (postgres, redis, qdrant)
make start

# Stop development services
make stop

# Quick setup for new developers
make setup

# Complete environment setup
./scripts/setup-dev.sh

Package Management

The project uses UV for all package management:

# Install main project with all packages
uv pip install -e ".[dev]"

# Install main project in development mode
uv pip install -e .

# Sync dependencies
uv sync

Notes for Execution

• Use make lint-all or make pyrefly for comprehensive code quality checks

The rest of the file remains unchanged. I've added the new memory as a note in the "Code Quality" section to highlight the available commands for linting.