From 9d6fd273e6db1d7584cef1bbed17eb5739091834 Mon Sep 17 00:00:00 2001
From: "Volodymyr Shcherbinin (vovin)" <vovin@lurk.kiev.ua>
Date: Thu, 23 Apr 2026 19:58:43 +0300
Subject: [PATCH] chore: add AGENTS.md per workspace doc layering convention

Single voice per repo; ## Purpose / Module / Build / Entry
Points / Notes; explicit override declarations only when
deviating from context defaults.
---
 AGENTS.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..5970f5b
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,29 @@
+# tradecloud-docs-api-v2
+
+## Purpose
+
+External-facing API v2 documentation for the TC1 platform. Covers
+order, shipment, forecast, connectors, security, support, plus
+guides and a checklist.
+
+## Module / Stack
+
+Markdown (likely GitBook-rendered -- see `SUMMARY.md`).
+
+## Build
+
+No build. Authoring is direct in `.md` files. Render via the
+hosting tool (GitBook or equivalent).
+
+## Entry Points
+
+- `SUMMARY.md` -- navigation tree
+- `api/`, `connectors/`, `forecast/`, `order/`, `shipment/`,
+  `security/`, `guide/` -- topic dirs
+- `checklist.md`, `support.md` -- standalone refs
+
+## Notes
+
+- Public-facing -- review changes for clarity and accuracy.
+- Align with `tradecloud-sdk-dotnet` and the API surface in
+  `tradecloud-microservices`.