CLAUDE.org

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

Authors & Contributors

• Author: Aidan Pace <apace@defrecord.com>
• Co-author: Claude <claude@anthropic.com>
• Reviewer/Sign-off: Jason Walsh <jwalsh@defrecord.com>

Build & Test Commands

• Python: pytest tests/ (all tests)
• Single Python test: pytest tests/path/to/test.py::test_function_name -v
• Install dependencies: pip install -r requirements.txt
• Lint: ruff check . (Python)
• Type checking: mypy . (Python)
• Format code: black . (Python)

Code Style Guidelines

• Python: PEP 8, type annotations, docstrings (Google style)
• Imports: stdlib → third-party → local, with blank line separation
• Naming: snake_case for variables/functions, PascalCase for classes
• Error handling: Use specific exceptions with meaningful messages
• Documentation: Use org-mode for documentation files
• Testing: Write unit tests with pytest