Add AGENTS.md

Problem

add an AGENTS.md or CLAUDE.md file to this repository to standardize development with AI agents and orient them to the repo structure. This is becoming standard practice in open-source codebases.

Solution

Something with a structure like this maybe:

Project overview

Brief purpose and main workflows.

Repo layout

Key directories and what they contain.

Development commands

install, Test, lint, format, type check, docs, examples.

Coding conventions

Style, architecture boundaries, naming, error handling.

Testing expectations

Which tests to run for different change types.

Documentation practices

style, format, "Write so that a new developer to this codebase can understand your writing, don’t assume your audience are experts in the topic/area you are writing about."

Pull request checklist

What must be true before submitting changes.

Additional context

No response

Code of Conduct

• I agree to follow this project's Code of Conduct and Contributing Guidelines

Start by inspecting the repository layout and any existing contributing guidance to identify the main workflows, commands, conventions, and testing expectations. Add an AGENTS.md or CLAUDE.md covering the requested sections and orienting new contributors to the C++ repository. Done means the file accurately reflects the repository and provides actionable guidance for development and pull requests.