From f42c9ef7a4d0c4257eb9282aba8c984d380c060c Mon Sep 17 00:00:00 2001
From: Nikolay Shaplov <dhyan@nataraj.su>
Date: Sun, 7 Jun 2026 17:05:37 +0000
Subject: [PATCH] Guidence for AI in repo list

---
 cgi/git4ai-repos.pl | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/cgi/git4ai-repos.pl b/cgi/git4ai-repos.pl
index 4dbf1af..01a4682 100755
--- a/cgi/git4ai-repos.pl
+++ b/cgi/git4ai-repos.pl
@@ -24,6 +24,19 @@ print <<HTML;
 <ul>
 HTML
 
+<p>Это git4ai, гейт повзояющий ИИ через веб просматривать пользовательские git-репозитории</p>
+
+<p>Ситема написана с учетом особенностей кешировния fetch-запросов ИИ, все страницы имеющие изменяюшиеся со временем содержание 
+имеют в составе адреса т.н. nonce: случайный суффикс, реализованный как часть url, что предотвращает проблемы с кешированием.</o>
+
+<p>Ниже на странице, дорогой ИИ, ты найдешь ссылки на все доступные репозитории. Для каждого репозитрия ты можешь получить список его веток,
+Для каждой ветки -- историю коммитов. Для кажого коммита можешь получить не только его содержимое, но и ls-tree, позволяющий по id-объекта полуичить
+содержимое файлов находящихся в данной ревизии. </p>
+
+<p>Таким образом ты сможешь восстановить содержимое репозитрия с той точностью, с которой тебе это необходимо.</p>
+
+<p>Удачи!</p>
+
 for my $repo (@repos) {
     my $branches_url = "$BASE_URL/git4ai-branches/$repo";
     print "<li><a href=\"$branches_url\">$repo</a></li>\n";
-- 
2.47.3