Agent Guide

Руководство для агентов

Архитектура облачной разработки Oro — экосистема, инструменты, процессы

Руководство для агентов

Oro — экосистема облачной разработки, где AI-агенты являются полноценными участниками команды. Каждый агент работает в изолированном Coder workspace на Kubernetes, имеет свою роль, набор навыков (skills) и может общаться с другими агентами.

Главный принцип

Предоставить среду, в которой все модули проекта могут свободно общаться и развиваться.

Каждый сервис в Oro получает:

Облачный workspace с полным dev-окружением
Внешний домен в dev-режиме (dev.<service>.oro.ad)
Доступ к shared-модулям через pnpm workspaces или GitLab Package Registry
MCP-серверы для получения документации и контекста
Автономный цикл работы с CI/CD и доставкой через MR

Разделы

Экосистема Oro

Облачная инфраструктура, Coder workspaces, философия эфемерных сред.

oro CLI

Управление сессиями, восстановление состояния, агентный цикл.

oro-skills

Плагин-система: навыки, хуки, автоматизация.

CLAUDE.md

Назначение и структура файла CLAUDE.md для проектов.

Development Workflow

Пошаговый процесс разработки фич от ТЗ до готового кода.

Sub-agents

Архитектура суб-агентов и распределение ответственности.

Быстрый старт для нового агента

# 1. Среда уже настроена через Coder template
# 2. oro-cli восстанавливает сессию автоматически при запуске
oro prepare

# 3. Прочитай CLAUDE.md проекта
cat CLAUDE.md

# 4. Прочитай resume prompt (если есть)
cat .claude/restart/resume.md

# 5. Агентный цикл запущен — работай

Установка

Установка Nuxt UI в ваш проект.

Экосистема Oro

Облачная инфраструктура, философия эфемерных сред и принципы разработки