# AI Documentation

Документация для AI агентов и разработчиков проекта mnemo_cards.

## 🤖 AI Agent 24/7 Automation System

Система автоматизированной разработки с использованием AI агентов для Forgejo.

### Быстрый старт

1. **За 5 минут**: [agent/QUICKSTART.md](./agent/QUICKSTART.md)
2. **За 30 минут**: [agent/FORGEJO_SETUP.md](./agent/FORGEJO_SETUP.md)
3. **Полная документация**: [agent/README.md](./agent/README.md)

### Что это?

AI агенты которые:
- 📋 Анализируют проект и создают задачи (Planning Agent)
- 💻 Пишут код автоматически (Development Agent)
- ✅ Тестируют и деплоят (Test & Deploy)
- 🔄 Работают 24/7 параллельно на разных компонентах

### Документация

- [**QUICKSTART.md**](./agent/QUICKSTART.md) - запуск за 5 минут
- [**FORGEJO_SETUP.md**](./agent/FORGEJO_SETUP.md) - пошаговая настройка
- [**README.md**](./agent/README.md) - полная документация
- [**CONFIGURATION.md**](./agent/CONFIGURATION.md) - детальная конфигурация
- [**AGENT_SYSTEM_SUMMARY.md**](./AGENT_SYSTEM_SUMMARY.md) - краткое описание системы

### Структура

```
ai_docs/
├── README.md (этот файл)
├── AGENT_SYSTEM_SUMMARY.md
└── agent/
    ├── README.md                    # Полная документация
    ├── QUICKSTART.md                # Быстрый старт
    ├── FORGEJO_SETUP.md             # Пошаговая настройка
    ├── CONFIGURATION.md             # Детальная конфигурация
    ├── web_v2/                      # Состояние агента web_v2
    ├── backend/                     # Состояние агента backend
    ├── common/                      # Состояние агента common
    ├── global_lock.json             # Глобальная блокировка
    └── prompts/                     # Промпты для агентов
        ├── development_prompt.md
        └── planning_prompt.md
```

### Workflows

```
.github/workflows/
├── agent-planning.yml      # Planning Agent
├── agent-development.yml   # Development Agent
└── agent-test-deploy.yml   # Test & Deploy
```

### Scripts

```
tools/agent/
├── config.py                # Конфигурация
├── task_manager.py          # Менеджер задач
├── cursor_cli_wrapper.py    # Wrapper для Cursor CLI
├── agent_orchestrator.py    # Главный оркестратор
└── planning_agent.py        # Planning агент
```

## 🚀 Как использовать

### 1. Настройте систему

Следуйте инструкции: [agent/FORGEJO_SETUP.md](./agent/FORGEJO_SETUP.md)

### 2. Запустите Planning Agent

```
Actions -> AI Agent - Planning -> Run workflow -> выберите компонент
```

### 3. Наблюдайте за работой

Development Agent запустится автоматически и начнет писать код.

## 📚 Дополнительно

- [Cursor CLI Docs](https://cursor.com/docs/cli/headless)
- [Forgejo Actions Docs](https://forgejo.org/docs/latest/user/actions/)

---

**Версия**: 1.0  
**Дата**: 2025-11-20