docs: prerequisites and Ollama setup in §4, RAG primer in §8, gh/Cursor troubleshooting

Made-with: Cursor

docs/openclaude-with-repositories.md

@@ -106,6 +106,18 @@ git remote set-url origin git@github.com:OWNER/REPO.git
 - Смешивание нескольких аккаунтов в одном credential helper.
 - Отсутствуют локальные зависимости проекта (тесты не запускаются).
 
+### GitHub CLI: `Could not resolve to a Repository` или `Repository not found`
+
+На **вашей машине** `gh repo view OWNER/REPO` может работать (например, после `gh auth login` или с корректным классическим token), а в **другой среде** (CI, удалённый агент, «облачная» сессия без вашего локального credential store) — нет: там часто **нет той же авторизации** или репозиторий **приватный** и для этой среды не выдан доступ.
+
+Что проверить:
+
+1. **Fine-grained PAT**: в разделе доступа к репозиториям явно добавлен нужный репозиторий (или группа «All repositories», если так задумано). Один только заголовок в UI не гарантирует, что токен передан в ту среду, где выполняется команда.
+2. **Permissions**: для `gh repo view` как минимум чтение метаданных репозитория (в терминах GitHub — **Metadata** read и при необходимости **Contents** read).
+3. **Контекст агента**: удалённый агент должен работать в **workspace = клон нужного репозитория** и иметь способ подставить токен (`GH_TOKEN`, `gh auth login` в этой среде и т.д.). Локальный успех команды у вас в PowerShell не переносится автоматически в облако.
+
+Если цель — чтобы автоматизация сама делала коммиты/PR в приватный репозиторий, выдайте секрет с PAT в этой среде и ограничьте права токена минимально необходимыми scope.
+
 ## 9) Рабочий чек-лист перед началом
 
 ```bash