96 lines
3.5 KiB
Markdown
96 lines
3.5 KiB
Markdown
# 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
|
||
|