AGENTS.md

see @docs/AGENTS.md

Ignore the "archived" directory.

Definition of done

• format.sh is passing without errors or warnings
• build.sh is passing without errors or warnings
• Test coverage is greater than 80% and coverage.sh is not failing
• Problems are not hidden, problems are addressed.
• Report breaking changes and ask how to handle them, do not assume migrations are required.

C# Code Style

• Use .NET 10 and C# 14
• Always use this. prefix
• Keep magic values and constants in a centralized Constants.cs file
• One class per file, matching the class name with the file name
• Sort class methods by visibility: public first, private at the end
• Sort class fields and const by visibility: private, const, props
• Keep all fields and consts at the top of classes
• Ensure dirs and paths logic is cross-platform compatible
• Avoid generic/meaningless names like "Utils" "Common" "Lib"
• Use plural for Enum names, e.g. "EmbeddingsTypes"
• Always use explicit visibility
• Don't use primary constructors
• Use DateTimeOffset, don't use DateTime