Skip to content

Conversation

@aaronspring
Copy link
Collaborator

Summary

This PR adds a CLAUDE.md file to provide comprehensive guidance for Claude Code instances working in this repository.

What's Included

The CLAUDE.md file contains:

  1. Development Commands - All essential commands for:

    • Running tests (full suite, individual tests, with markers)
    • Running doctests
    • Code quality checks (pre-commit, ruff, mypy)
    • Building documentation
    • Installation options
  2. Architecture Documentation - High-level architecture that requires reading multiple files to understand:

    • Core module structure and responsibilities
    • Key design patterns (xr.apply_ufunc, dimension preprocessing, xarray/NumPy separation)
    • xarray accessor pattern
    • Testing infrastructure
  3. Important Considerations - Critical knowledge about:

    • Temporal metrics constraints
    • NumPy version compatibility
    • Dimension and NaN handling
    • Dask support
  4. Contributing Workflow - Standard workflow for making changes

Rationale

This file helps future Claude Code instances (and human developers) quickly understand the codebase architecture and be productive when making changes. It focuses on the "big picture" that isn't immediately obvious from reading individual files.

🤖 Generated with Claude Code

aaronspring and others added 2 commits October 15, 2025 18:17
This file provides comprehensive guidance for Claude Code instances working in this repository, including:
- Essential development commands (testing, linting, documentation)
- Core architecture and design patterns
- Key considerations for metrics implementation
- Contributing workflow

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants