docs: add AGENTS.md guidance for generated files (#454)

* Add repository guidance for generated files

* Remove stale generated headers from owned SDK files

Author: louis-sanna-dev

AGENTS.md

@@ -0,0 +1,37 @@
+# Repository Guide
+
+This repository is mostly generated code.
+
+Before editing or approving a PR, check the top of the file:
+
+```python
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+```
+
+If that marker is present, do not hand-edit the file. Changes should be made in the upstream source or generator inputs, then regenerated.
+
+## What We Own
+
+The main hand-maintained surface is listed in `.genignore`.
+
+At the repo root, that currently includes files such as:
+
+- `pyproject.toml`
+- `examples/*`
+- `utils/*`
+- `src/mistralai/extra/*`
+- `pylintrc`
+- `scripts/prepare_readme.py`
+
+There are also package-specific ownership files:
+
+- `packages/gcp/.genignore`
+- `packages/azure/.genignore`
+
+If a file is not listed in the relevant `.genignore` and it has the generated header, assume it should not be edited directly.
+
+## PR Review Rule Of Thumb
+
+- Prefer PRs that change hand-owned files listed in `.genignore`.
+- Be skeptical of direct edits to generated SDK files under `src/`, `docs/`, or `packages/*/src/`.
+- If a generated file changed, look for the corresponding source/config change that explains the regeneration.

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

packages/azure/src/mistralai/azure/client/sdk.py

@@ -1,5 +1,3 @@
-"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
-
 from .basesdk import BaseSDK
 from .httpclient import AsyncHttpClient, ClientOwner, HttpClient, close_clients
 from .sdkconfiguration import SDKConfiguration

packages/gcp/src/mistralai/gcp/client/sdk.py

@@ -1,5 +1,3 @@
-"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
-
 from .basesdk import BaseSDK
 from .httpclient import AsyncHttpClient, ClientOwner, HttpClient, close_clients
 from .sdkconfiguration import SDKConfiguration