.hermes.md

Hermes checks this file first (.hermes.md → HERMES.md → AGENTS.md → CLAUDE.md) and uses the first one it finds. Because this file shadows the others, keep it for what is genuinely specific to this project — boilerplate that belongs to every project belongs in your global setup.

This project

Payment reconciliation service. Boring on purpose. Correctness beats cleverness everywhere in this repo.

Overrides

• Money is integer cents, everywhere. A float in a money path fails review, including in tests.
• Tests run with make test, not the language's native runner — the Makefile wires up the database container the tests need.
• main deploys on merge. There is no staging. Act accordingly.

Quirks you would otherwise rediscover the hard way

• fixtures/bank-2024.json is real anonymized data with real edge cases — regenerating it loses the edge cases. Never touch it.
• The flaky test in reconcile_timeout_test is a known race (#412). Rerun once before investigating; mention it if it fails twice.
• docs/adr/ holds the decisions. Check there before proposing an architecture change that was already rejected.