CLAUDE.md

This project is worked on by several coding agents. CLAUDE.md is the lowest file in Hermes's priority order — if you are adding Hermes-specific behavior, use .hermes.md so it does not affect the other tools. This file keeps the rules every agent shares.

Project

CLI tool for syncing product catalogs (Python 3.12, uv, pytest).

Commands

uv sync                 # install deps
uv run pytest           # tests (fast; run them, they are not optional)
uv run ruff check .     # lint
uv run catsync --help   # the tool itself

Rules

• pyproject.toml is the single source of dependency truth. No pip install into the environment, no requirements files.
• Public functions keep their docstrings updated — the docs site builds from them. A signature change without a docstring change fails review.
• Network calls live in catsync/transport/ and nowhere else, so tests can stub one seam.
• Do not bump the version; the release workflow owns it.

Verification

Before declaring anything done: uv run pytest && uv run ruff check . and paste the tail of the output. If a test is skipped, say which and why.