# Руководство: Подготовка новых репозиториев для работы с Роем (Token-Saving)

Чтобы любой ваш новый или существующий проект на VPS был готов к автоматической работе Роя по расписанию без раздувания контекста (экономия токенов), в его корневом каталоге должны находиться файлы-манифесты и лениво загружаемые скиллы.

---

## 📋 1. Чек-лист файлов в целевом репозитории

| Файл / Директория | Описание | Зачем нужен Рою |
|---|---|---|
| **`AGENTS.md`** | Легковесный указатель. | Содержит краткие инструкции для ручного девелопмента человеком, чтобы не раздувать контекст ИИ при ручных сессиях. Ссылается на `tasks.md` для Роя. |
| **`tasks.md`** | Очередь задач (Checklist). | Список задач, которые должен выполнить Рой. Он считывает первую активную задачу `[ ]`, определяет нужный скилл из описания, выполняет её, отмечает как выполненную `[x]` и коммитит изменения. |
| **`.geminiignore`** | Файл исключений. | Содержит список папок (например, `node_modules`, `venv`, `.git`), которые Рой **не должен сканировать**, чтобы экономить токены контекста и работать в 10 раз быстрее. |
| **`.agents/settings.json`** | Конфигурация телеметрии. | Настраивает запись технического лога Роя в файл `.agents/telemetry.log`. |
| **`.agents/skills/`** | Директория скиллов. | Содержит накопленный опыт и лучшие практики проекта. Скиллы загружаются лениво (lazy loading) только при необходимости. |

---

## ⚡ 2. Универсальный Бутстрап-промпт для подготовки репозитория

Скопируйте этот текст, перейдите в папку нового проекта на VPS, запустите `agy` (или скормите его вашему текущему ИИ-ассистенту в этой папке) и отправьте этот промпт. Он сам создаст всю необходимую структуру.

```markdown
Ты — агент инициализации воркспейса Antigravity Swarm. Подготовь текущую директорию к работе, минимизируя размер стартового контекста (token-saving structure).

Создай следующие файлы в корне текущей директории:

1. Создай ультра-легкий `AGENTS.md` (только для ручной работы):
---
# Project Instructions (Developer Mode)

For manual development, run tests using `npm test` or `pytest`. 
If you are running as the automated Swarm, see task details in `tasks.md`.
---

2. Создай файл `tasks.md` (очередь задач для Роя):
---
# Swarm Tasks Queue

## Активные задачи
- [ ] 1. Написать SEO-статью про преимущества AI-агентов. [использовать скилл: write-article]

## Инструкция по исполнению для Роя:
1. Прочитай первую активную задачу `[ ]`.
2. Прочитай специализированную инструкцию из скилла `.agents/skills/<название_скилла>/SKILL.md`.
3. Выполни задачу по инструкции, обнови статус на `[x]` и сделай git commit.
---

3. Создай `.geminiignore` (исключение всего лишнего):
---
node_modules/
venv/
.git/
.agents/telemetry.log
swarm.log
*.db
tmp/
---

4. Создай каталог `.agents/` и файл `settings.json`:
---
{
  "telemetry": {
    "enabled": true,
    "target": "local",
    "traces": true,
    "outfile": ".agents/telemetry.log"
  }
}
---

5. Создай заготовки для двух базовых скиллов:
- В файле `.agents/skills/write-article/SKILL.md`:
---
---
name: write-article
description: "Паттерн написания SEO-статей и технического контента"
---
# Инструкция по написанию статей
1. **Исследование:** Используй Tavily MCP для поиска свежих материалов по теме.
2. **Структура:** Статья должна содержать H1 (один), разделы H2, списки, выделения важных мыслей и заключение.
3. **SEO:** Интегрируй ключевые слова органично. Избегай переспама.
---

- В файле `.agents/skills/code-audit/SKILL.md`:
---
---
name: code-audit
description: "Паттерн аудита и оптимизации производительности кода"
---
# Инструкция по аудиту кода
1. Проверь сложность циклов и избегай избыточных вложенных операций.
2. Убедись, что все внешние API запросы выполняются с таймаутами.
3. Проверь код на предмет утечек памяти и неиспользуемых импортов.
---

После создания выведи markdown-таблицу со всеми созданными файлами и подтверди готовность.
```

---

## 🛠️ 3. Пример использования

Если вы готовите, например, репозиторий `project-a-proposals` на VPS:
1. Зайдите в папку: `cd /opt/project-a-proposals`
2. Запустите: `agy`
3. Вставьте скопированный промпт выше.
4. Агент за 10 секунд сгенерирует файлы, и проект будет полностью готов к тому, чтобы Рой заходил в него по расписанию и выполнял задачи.