diff --git a/.gitignore b/.gitignore
index 41c41e5..a0de171 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,8 @@
 __pycache__/
 *.pyc
 
-# project-local installs (harness install agent --scope project)
+# Временные файлы (фикстуры, логи, эксперименты) — только здесь, не в /tmp
+tmp/
+
+# project-local installs (harness agent --scope project)
 .opencode/
diff --git a/README.md b/README.md
index 0e85b0b..8572fbb 100644
--- a/README.md
+++ b/README.md
@@ -314,6 +314,15 @@ permission:
 - **Скиллы** — `SKILL.md` с YAML frontmatter (`name`, `description`); родной формат OpenCode и Hermes.
 - **Агенты** — `<name>.md` с frontmatter (`description`, `mode`, ...); формат OpenCode.
 
+## Конвенции репозитория
+
+- **Временные файлы — только в `tmp/`** репозитория: фикстуры, логи, эксперименты,
+  распакованные архивы. Не в `/tmp`, не в корне. `tmp/` в `.gitignore`.
+- Источники каталога — git submodule'ы, а не копии файлов.
+- Агенты — `agents/<имя>.md`, имя агента = имя файла без расширения.
+- Все списочные команды — через `render_listing()` (см. «Правила вывода списков»).
+- Идентичность коммитов — как в остальных репах: `eka <eeeeka@itphx.loc>`.
+
 ## Совместимость
 
 | Фича | Hermes | OpenCode |