chore: add AI coding assistant context files

[piotrzajac]

Summary

• Adds AGENTS.md — comprehensive project context for all AI coding assistants (Claude Code, GitHub Copilot, OpenAI Codex, Cursor). Covers repository layout, build/test/pack commands, architecture (with Mermaid diagrams), public API, test conventions, coding conventions, CI/CD overview, and AI agent working rules.
• Adds CLAUDE.md — Claude Code entry point that imports AGENTS.md and adds the single Claude-specific instruction (plan mode for non-trivial changes).
• Updates README.md — adds an Installation section with dotnet add package commands and a Contributing section pointing to AGENTS.md.

Why

AI coding assistants give generic advice without project context. These files allow them to give convention-aware, accurate assistance from the first message of any session — without re-exploring the repository each time.

AGENTS.md is the single source of truth. CLAUDE.md imports it rather than duplicating content. GitHub Copilot reads AGENTS.md directly (no separate instructions file needed as of the current Copilot documentation).

Test plan

• Verify Mermaid diagrams render correctly on GitHub
• Verify CLAUDE.md @AGENTS.md import resolves in Claude Code
• Verify dotnet add package commands in README match published package names

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Added installation instructions to README with dotnet add package commands for each supported mocking framework variant
  • Added contributing section with guidance on project architecture, coding conventions, and development guidelines

[coderabbitai]

📝 Walkthrough

Walkthrough

Three documentation files are added or modified to establish contributor guidance, project architecture overview, and installation instructions. No code logic, APIs, or build processes are altered—only documentation is introduced to inform developers and AI assistants.

Changes

Cohort / File(s)	Summary
New Contributor & Architecture Documentation AGENTS.md, CLAUDE.md	Comprehensive guide (AGENTS.md) covering project purpose, repository structure, build commands, architectural extension model, public APIs, testing conventions, dependency management, versioning, CI/CD, local setup, and working rules for AI assistants. Claude-specific instructions file (CLAUDE.md) adds tool requirements including plan mode for non-trivial changes.
README.md Updates README.md	Added "Installation" section with dotnet add package commands for supported mocking frameworks (AutoMoq, AutoNSubstitute, AutoFakeItEasy) and "Contributing" section referencing AGENTS.md for project context and working guidelines.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 Hop, hop—new docs take flight!
AGENTS guide the way so bright,
CLAUDE calls for plans before the code,
README shows the installation road,
A roadmap written true and kind,
For humans and machines aligned! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'chore: add AI coding assistant context files' accurately and concisely summarizes the main change—adding documentation files (AGENTS.md, CLAUDE.md, and README updates) intended for AI coding assistant context.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/ai-ready-repository

---

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 and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@AGENTS.md`:
- Around line 111-148: The Mermaid classDiagram uses an invalid combined
stereotype `<<abstract, Core>>` on AutoDataBaseAttribute; change it to a single
stereotype `<<abstract>>` on the AutoDataBaseAttribute declaration and, if you
need a separate "Core" visual marker, define a CSS class via classDef (e.g.,
classDef Core ...) and attach it to AutoDataBaseAttribute with a class statement
(e.g., class AutoDataBaseAttribute Core) so the diagram shows both the abstract
stereotype and the Core styling separately.

🪄 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: bc41bbcf-a376-4f9f-856b-2fb90e23a054

📥 Commits

Reviewing files that changed from the base of the PR and between b6495c7 and 38dcab2.

📒 Files selected for processing (3)

• AGENTS.md
• CLAUDE.md
• README.md