# CLAUDE.md

## Project Context
Rust CLI application using clap for argument parsing, tokio for async, and anyhow for error handling.

## Code Style
- Use thiserror for library errors, anyhow for application errors
- Prefer Result<T, anyhow::Error> in application code
- Use clap derive macros for CLI arguments
- Follow Rust API Guidelines: https://rust-lang.github.io/api-guidelines/

## Patterns
- Builder pattern for complex structs
- From/Into implementations for type conversions
- Use tracing for structured logging (not println!)
- Prefer iterators over manual loops

## Error Handling
- Never use .unwrap() in library code
- Use .context("description") with anyhow
- Custom error types with thiserror for public APIs

## Testing
- cargo test before committing
- Integration tests in tests/ directory
- Use assert_cmd + predicates for CLI testing
- Snapshot testing with insta

## Dependencies
- cargo clippy -- -W clippy::all before committing
- cargo fmt always
- Minimize dependency count