docs: seed AGENTS.md

Author: caffeine-ci-generic-rw[bot]

AGENTS.md

@@ -0,0 +1,27 @@
+# AGENTS.md
+
+A Motoko client library for the OpenAI REST API, distributed as a [mops](https://mops.one) package.
+
+## Generated code — do not hand-edit
+
+The entire `src/` tree is produced by the [OpenAPI Generator](https://openapi-generator.tech) (`MotokoClientCodegen`); the exact list of generated paths is in `.openapi-generator/FILES`. Do not hand-edit generated files — changes are lost on regeneration. Files listed in `.openapi-generator-ignore` are preserved across regeneration. `README.md` and `CHANGELOG.md` are also generator-managed.
+
+This package ships a curated subset of the upstream OpenAPI surface (Chat, Completions, Models, Embeddings, Images, Audio, Moderations, Files) plus the models they transitively reference; other APIs are pruned.
+
+## Layout
+
+- `src/Config.mo` — shared `Config` type and `defaultConfig` (base URL, cycles, auth).
+- `src/Apis/` — one module per API group (e.g. `ChatApi.mo`).
+- `src/Models/` — request/response type modules, one per type.
+
+## Toolchain
+
+- Motoko compiler is pinned in `mops.toml`: `moc = "1.4.1"`. Use that version.
+- Dependencies are declared in `mops.toml` and locked in `mops.lock`; install them with `mops install`.
+- The `files` field in `mops.toml` defines what the published package contains (`src/Config.mo`, `src/Apis/**/*.mo`, `src/Models/**/*.mo`).
+
+## Notes
+
+- `.mops/` is a local install directory and is gitignored.
+- There are no CI workflows, tests, lint, or format scripts in this repository; do not assume any exist.
+- The client makes HTTP outcalls via the IC management canister, which require cycles at runtime; this is a deployment concern, not a build step.

CLAUDE.md

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