From 8c6b8464c80626da2ee40ccfcb9f7922bae3d4b0 Mon Sep 17 00:00:00 2001
From: Admin_IT-one <admin_it-one@local.invalid>
Date: Fri, 21 Aug 2026 12:15:09 +0200
Subject: [PATCH] Add public docs-and-guidelines architecture guide

---
 README.md | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c44f137..2e4687d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,20 @@
 # docs-and-guidelines
 
-Knowledge base, prompt engineering, and engineering policy.
\ No newline at end of file
+## Public IT-One engineering policy
+
+The IT-One organization is public by design. The twelve top-level repositories are shared work areas. All changes should use a branch and pull request.
+
+### AI repositories
+
+- `agent-<name>` for autonomous agents.
+- `swarm-<name>` or `orch-<name>` for orchestrators.
+- `eval-<agent-name>-benchmark` for benchmarks.
+- Prompts, tool schemas, memory behavior, and eval cases are versioned.
+
+### Quality and secrets
+
+Agent pull requests must pass the Eval Gate at 95% or higher. Provider keys, vector database credentials, and registry tokens belong only in organization-level Gitea Actions Secrets. Use `${{ secrets.SECRET_NAME }}` in workflows; never commit a real value.
+
+### Archive
+
+`projects-archive` is public read-only for organization participants. New work belongs in the active area and is moved to the archive only after review.