From 925ba41f34c838fa073943c72278096d4b2f4284 Mon Sep 17 00:00:00 2001
From: Admin_IT-one <admin_it-one@local.invalid>
Date: Fri, 21 Aug 2026 12:14:59 +0200
Subject: [PATCH] Add public ai-evals architecture guide

---
 README.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 03ea181..b52647d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,12 @@
 # ai-evals
 
-Datasets, benchmarks, and quality metrics for agents.
\ No newline at end of file
+Datasets, benchmarks, and evaluation metrics for AI agents. Name benchmark repositories `eval-<agent-name>-benchmark`.
+
+This public repository is a top-level area of the [IT-One](https://git.it-one.pro/IT-One) organization.
+
+## Collaboration
+
+- Use short-lived branches and pull requests.
+- Keep credentials out of Git; use organization-level Gitea Actions secrets.
+- Add a focused README to every project repository created in this area.
+- Use the [AI agent template](https://git.it-one.pro/IT-One/agent-template) for agent projects.