Add CLAUDE.md

[feruzm]

Adds repository guidance for AI-assisted development: project overview, commands, the merge-to-main-deploys-production warning, architecture map, the behavioral invariants that must not be "fixed" (JS-parity serialization that feeds signature hashing, Express-compatible response semantics, the always-present upstream request body, the get_accounts null-vs-"null" distinction, quiet logging), failover design summary, testing (golden vectors + parity harness), and conventions. Docs only.

Summary by CodeRabbit

• Documentation
  • Added repository guidance for Claude Code, including architecture, development commands, deployment instructions, and testing workflows.
  • Documented important compatibility requirements for JSON handling, signing, HTTP responses, upstream requests, failover behavior, and logging.

[greptile-apps]

Greptile Summary

This PR adds repository guidance for AI-assisted development.

• New CLAUDE.md with project overview and common commands.
• Deployment warning for merges to main.
• Architecture map for the .NET API service.
• Critical behavior invariants for parity with the prior Node service.
• Testing and convention notes for future changes.

Confidence Score: 5/5

This looks safe to merge.

• No blocking issues found in the changed documentation.

Important Files Changed

Filename	Overview
CLAUDE.md	Adds development guidance, deployment notes, architecture context, invariants, and testing conventions.

_{Reviews (1): Last reviewed commit: "docs: add CLAUDE.md (project guidance fo..." | Re-trigger Greptile}

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds CLAUDE.md with repository context, development commands, architecture guidance, critical behavioral invariants, failover expectations, and testing conventions.

Changes

Repository Guidance

Layer / File(s)	Summary
Claude Code repository guidance CLAUDE.md	Documents the C#/.NET minimal API structure, commands, deployment guidance, architecture, serialization and signing invariants, JavaScript and HTTP compatibility rules, RPC failover behavior, and testing procedures.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Poem

I’m a small rabbit with notes in my nest,
Mapping the code so each hop does its best.
Byte strings stay steady, signatures shine,
Failover paths follow a well-marked line.
With tests and commands tucked safely away,
Claude can help code more clearly each day.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately and concisely describes the main change: adding the CLAUDE.md documentation file.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/claude-md

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CLAUDE.md`:
- Line 32: Update the fenced Markdown code block in CLAUDE.md to include an
explicit language identifier, using text for the block, while preserving its
contents.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5f4c1c9f-66b6-4841-92f4-0786c8b10ba1

📥 Commits

Reviewing files that changed from the base of the PR and between ad8bc82 and f18a458.

📒 Files selected for processing (1)

• CLAUDE.md

[coderabbitai]

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Specify the fenced-block language.

Add a language identifier such as text to satisfy Markdown linting and improve rendering.

Proposed fix

-```
+```text

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

```

🧰 Tools

🪛 markdownlint-cli2 (0.22.1)

[warning] 32-32: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CLAUDE.md` at line 32, Update the fenced Markdown code block in CLAUDE.md to
include an explicit language identifier, using text for the block, while
preserving its contents.

Source: Linters/SAST tools