CLAUDE.md

CLAUDE.md

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

Commands

Testing

# Run all tests
julia --project=. -e 'import Pkg; Pkg.test()'

# Run tests matching a pattern (e.g. "basic", "rules", "iddict")
julia --project=. -e 'import Pkg; Pkg.test(; test_args=["<pattern>"])'

Code Formatting

# Format changed files relative to a branch
git runic <base-branch>

# Install pre-commit hook for automatic formatting
pre-commit install

CI enforces Runic formatting on all PRs.

Coding Conventions

• Avoid Closures: Avoid using anonymous functions / closures (e.g. _ -> foo) and inner/local functions in runtime and compiler helper methods, as local functions suffer from the same closure allocation and type instability issues. Prefer using Returns(val) (e.g., ntuple(Returns(x), Val(W))), callable structs, or top-level functions instead.