diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..595f0f7
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,65 @@
+## Agent skills
+
+### Issue tracker
+
+Gitea Issues at git.fossellini.top:SirStone/SirRoboGarage. See `docs/agents/issue-tracker.md`.
+
+### Triage labels
+
+Default label vocabulary. See `docs/agents/triage-labels.md`.
+
+### Domain docs
+
+Single-context layout. See `docs/agents/domain.md`.
+
+### Folders
+
+## SirGarage Directory Layout
+
+**SirGarage** (root directory)
+
+- botname_garage (name of the bot+ "_garage")
+  - src
+    - botname.nim
+    - botname.json
+    - botname.sh
+    - config.nim
+    - botname
+      - lib1.nim
+      - module.nim
+      - lib2.nim
+      - ...
+  - tests
+    - test1.nim
+    - test2.nim
+    - ...
+  - out
+    - bin1
+    - bin2
+    - ...
+- docs (directory)
+  - all generic documentation, valid for all project
+- tools (directory)
+  - all generic tools, valid for all project, like battle runners, scripts, etc.
+- common_lib (directory)
+  - all generic libraries, valid for all bots, like common modules, etc.
+- AGENTS.md
+- CONTEXT.md
+- README.md
+- .gitignore
+- worktrees
+  - worktree 1
+  - worktree 2
+  - ...
+- exported (sharable folder)
+  - botname
+    - botname (binary)
+    - botname.json (metadata)
+    - botname.sh (linux/mac launcher)
+    - botname.cmd (windows launcher)
+
+## How to use
+
+- These indications are for files that are always present, for files not mentioned here should be claer from context where belongs too.
+- Each bot development must be done in each folder in isolation.
+- If the bot requires extra folders during runtime, these must be created by the bot itself if not present already.
diff --git a/CLAUDE.md b/CLAUDE.md
deleted file mode 100644
index 5d0d67e..0000000
--- a/CLAUDE.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## Agent skills
-
-### Issue tracker
-
-Gitea Issues at git.fossellini.top:SirStone/SirRoboGarage. See `docs/agents/issue-tracker.md`.
-
-### Triage labels
-
-Default label vocabulary. See `docs/agents/triage-labels.md`.
-
-### Domain docs
-
-Single-context layout. See `docs/agents/domain.md`.
diff --git a/research/rl-algorithm-choice.md b/docs/rl-algorithm-choice.md
similarity index 100%
rename from research/rl-algorithm-choice.md
rename to docs/rl-algorithm-choice.md