Add CLAUDE.md for Claude Code development guidance

[paddymul]

Summary

• Add CLAUDE.md with project-specific guidance for Claude Code
• Covers build/test commands, architecture notes, code style, and common pitfalls
• Consolidates tribal knowledge from .cursorrules and development experience

Test plan

• Verify CLAUDE.md renders correctly on GitHub
• No code changes — documentation only

🤖 Generated with Claude Code

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 14086e05f3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Fix JavaScript commands to use current working directory

This command sequence is internally inconsistent: after cd packages && pnpm install, the shell is already in packages/, so cd packages/buckaroo-js-core resolves to packages/packages/buckaroo-js-core and fails. Anyone following the Build & Test block verbatim will not be able to run the JS build/tests, so the documented workflow is currently broken.

Useful? React with 👍 / 👎.

[github-actions]

📦 TestPyPI package published

pip install --index-strategy unsafe-best-match --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ buckaroo==0.12.12.dev22444200187

or with uv:

uv pip install --index-strategy unsafe-best-match --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ buckaroo==0.12.12.dev22444200187

MCP server for Claude Code

claude mcp add buckaroo-table -- uvx --from "buckaroo[mcp]==0.12.12.dev22444200187" --index-strategy unsafe-best-match --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ buckaroo-table