// шаг 1·регистрация

Добро пожаловать в Operon

AI-команда разработки в твоём чате

или
используйте уникальный пароль
У меня уже есть аккаунт // займёт меньше минуты
дальше — создать проект
// шаг 2·создать проект

Создай первый проект

Один проект = одна доска задач, один Telegram-чат, один набор агентов

используется в идентификаторах: PRJ-1, PRJ-2 …
operon.app/p/my-project
дальше — выбрать путь
// развилка·выбери путь

С чего начнём?

Оба пути одинаково рабочие — выбери, что ближе к твоей ситуации

Не уверен — начни с «Новый проект». В любой момент сможешь подключить репо и импортировать задачи из // настройки → интеграции.
// нажми карточку, чтобы продолжить
Назад // шаг 3·telegram

Подключи Telegram-бота

NedimaBot будет ловить задачи из ваших разговоров — текстом, голосом, фото

  1. Открой @NedimaBot в Telegram Открыть в браузере · или нажми кнопку в мобильном Telegram
  2. Нажми /startбот пришлёт приветствие и попросит код подключения
  3. Скопируй код подключения сюда:
    или код вручную:
    — создаю код —
  4. Готово!Ждём подключения...
// превью бота в Telegram
NedimaBotбот · онлайн
сегодня
Привет! Я NedimaBot — буду ловить задачи из вашего чата.
14:21
Введи код подключения, который ты видишь в Operon:
14:21
— ввод кода —
OP-CONNECT-A7F3-9D2C
14:22
— подключение —
Подключён к проекту Гейминг Гудс.
Теперь напиши мне задачу — текстом, голосом или фото.
14:22
сообщение...
Ждём, пока ты введёшь код в бота...
дальше — подключить Claude Code
Назад // шаг 4·claude code · mcp

Подключи Claude Code — твоего первого агента

Claude Code будет брать задачи с доски, задавать вопросы и отдавать на ревью. 14 MCP-tools

// self-hosted · ключ ваш · BYOK — используется твой ключ Claude, Operon не перепродаёт токены · подробнее →
  1. Сгенерируй API-токен Operon
    нажми «Сгенерировать» →
    // показывается только один раз — сохрани в безопасное место
  2. Добавь в Claude Code settingsфайл ~/.config/claude-code/mcp.json
    {
      "mcpServers": {
        "operon": {
          "command": "npx",
          "args": ["@operon/mcp"],
          "env": {
            "OPERON_TOKEN": "<вставится-при-copy>",
            "OPERON_PROJECT": "{{PROJECT_ID}}"
          }
        }
      }
    }
    // токен подставится при «копировать» — он не записывается в DOM
  3. Перезапусти Claude Codeили выполни /mcp reload
  4. Готовоагент сам подключится и появится в // флоте
// статус подключения
Ждём подключения Claude Code...
// токен сгенерирован
// handshakeожидание...
// MCP tools
Claude Code подключён// 14 MCP-tools доступны · handshake 0с · BYOK ✓агент сможет: брать задачи, задавать вопросы, оставлять комментарии
Не знаешь, где конфиг? Открой Claude Code → Settings → MCP Servers, или инструкция для macOS / Linux / Windows →
дальше — поставить первую задачу
Назад // шаг 5·первая задача
Готово. Поставь первую задачуЛюбым способом — текстом в Telegram, голосом или прямо на доске
// прошло3:42
Опционально: подключи репозиторий — агент сможет открывать PR. Можно сделать сейчас или позже в // настройки. подключить →пропустить
Aв telegram
Напиши боту

«надо сделать форму регистрации» — NedimaBot оформит её в задачу через диалог

NedimaBot
надо сделать форму регистрации
Окей, оформляю в задачу...
жду первое сообщение... Открыть Telegram
Bголосом
Поговори с Operon

Расскажи о проекте голосом — Marin запишет action items и отправит на доску

голос Marin · ru Начать звонок
@ Пригласи командуOperon работает в паре с людьми — добавь коллегу, чтобы он видел доску и принимал работу агентов
поздравляем

Ты в Operon

Дальше — наблюдай, как агенты разбирают доску. Заходи в Mission Control для приёмки работы.

Перейти к доске время от регистрации: 3:42· цель < 5:00 ✓
Назад // шаг 3·репозиторий

Подключи репозиторий с кодом

Operon прочитает код, чтобы агент понимал проект — и чтобы потом открывать PR

Авторизация через GitHub OAuth — запросим доступ только на чтение, без записи без твоего разрешения. Operon не пушит в твой репо до тех пор, пока ты явно не подтвердишь PR.
всеprivatenode.js
kirillsil/operon privateNode.js · Vue 3 · 14 МБ · обновлён вчера
main
kirillsil/gg-platform publicGo · React · 87 МБ · обновлён 2 дня назад
main
gg-team/marketplace orgVue · TypeScript · 124 МБ · обновлён 4 часа назад
develop
+ ещё 23 репозитория · показать все
// self-hosted · ключ ваш · BYOK · подробнее →
// возможные состояния этого шага
// defaultсписок репопосле OAuth — выбираешь один или несколько
// state · selectedвыбрано 1+CTA становится primary, появляется счётчик
// state · errorнет доступанедостаточно прав — открой Settings → Apps
// state · lockприватный репомы запросим явный consent на чтение
дальше — собрать контекст проекта
Назад // шаг 4·контекст · aha

Operon читает код и собирает контекст…

// займёт ~2 минуты · 124 файла · 14 интеграций
// читаю package.json
// нашёл Nuxt 3 + Go backend
// сканирую структуру... 124 файла
// нашёл миграции PostgreSQL: 18 файлов в /db/migrations
// определил frontend/backend split: nuxt + go-chi
// 14 интеграций обнаружено в .env.example
// читаю README.md (4 KB)
// собираю ARCHITECTURE.md...
// обычно агенту нужны эти доки — мы их черновики составляем сами67% · ~40 сек
// phase b — review the draft

Готово — проверь черновик контекста

Это черновик из твоего кода. Поправь, что не так — агенты будут опираться на это.

PROJECT_OVERVIEW.md5.2 KB
Operon — AI-команда разработки в Telegram-чате
Stack: Nuxt 3 (frontend), Go (backend), PostgreSQL
Team: 2 человека · 1 агент (Claude Code)
Цель MVP: time-to-first-task < 5 мин
ARCHITECTURE.md3.3 KB
Микросервисная архитектура: 4 сервиса + MCP-шлюз
Frontend: Nuxt 3 SSR + Pinia store
Backend: Go-chi REST + PostgreSQL + Redis
MCP: 14 tools для агентов (read-only по умолчанию)
TECH_STACK.md2.1 KB
Nuxt 3.12 · Vue 3.4 · TypeScript 5.4
Go 1.22 · go-chi · sqlc · pgx
Postgres 16 · Redis 7 · S3 (yandex)
Whisper (self-hosted) · OpenAI · Anthropic
INTEGRATIONS.md4.7 KB
14 интеграций: Telegram Bot API · GitHub · GitLab
Vercel · Cloudflare · S3 · SendGrid
Sentry · PostHog · Grafana · OpenTelemetry
Anthropic · OpenAI · Whisper · ElevenLabs
// возможные состояния этого шага
// state · scanningскан в процессеphase A · live log + breathing orb
// state · readyчерновик готовphase B · 4 .md документа на ревью
// state · editправка одногооверлей с редактором markdown
// state · failedparse failedрепо большой/empty — fallback на ручной ввод
дальше — импорт задач
Назад // шаг 5·импорт задач

Откуда импортировать задачи?

Operon не заменяет твой трекер сразу. Можно импортировать сейчас и решить, как жить с ним дальше.

// jira подключена — phase b: маппинг и превью

Привязка статусов и полей

Их 7 статусов → наши 6 колонок. Проверь маппинг.

// status mapping · jira → operon
BacklogБэклог
Selected for DevК работе
In ProgressВ работе
Code ReviewРевью
QAРевью// внимание: 2 их статуса (Code Review + QA) → 1 наша колонка
DoneГотово
Cancelled✗ Пропустить
// можно перетащить — изменишь маппинг
// field mapping · 4 поля
assignee · кому назначеноих assignee → наш исполнитель
priority · приоритетLowest / LowнетMedium!High / Highest!!
labels · меткиих labels → наши теги
comments · комментарииимпортировать всю историю комментариев ☑ да
// фильтр импорта
Только открытые задачипо умолчанию
Закрытые младше 30 дней
Только в моей назначке
// импортируется 47 задач · пропущено 128 (закрытые) · из них 12 без приоритета
// режим сосуществования с jira
Только новые инициативы — старое остаётся в JiraИмпортируем 47 текущих задач для контекста, но новые ставите в Operon. Jira продолжает жить параллельно. Рекомендуем.
One-way импорт + бэклинк на источникЗадачи копируются в Operon, в каждой карточке сохраняется ссылка на Jira. Изменения только в одну сторону: Jira → Operon.
Two-way sync — двусторонняя синхронизация скороИзменения в любой из систем зеркалятся в другую. Сейчас в работе, ожидаем Q3 2026.
// каждая импортированная карточка сохранит бэклинк на источник: «Jira: PROJ-1234»
// импорт в процессе100% · 0:08
// загрузка из Jira... 47/47
// маппинг полей и приоритетов...
// создание карточек на доске... 47/47
// прикрепление файлов и комментариев...
// готово — задачи на доске
// возможные состояния этого шага
// 1выбор источника7 интеграций
// 2oauth идётpopup в провайдер
// 3 · currentмаппингстатусы + поля
// 4превьюN задач для импорта
// 5импортпрогресс + лог
// 6готово ✓47 на доске
// edgetracker no responseretry + fallback на CSV
// edge0 open tasks«импортируй закрытые или скип»
// edgeдубликатыоффер merge / skip / keep both
// edgestatus conflict2 их → 1 наш (gold-highlight)
дальше — подключить агента
Назад // шаг 6·claude code · mcp

Подключи Claude Code — твоего первого агента

Подключение репозитория уже выполнено — агент будет открывать PR в kirillsil/operon

// self-hosted · ключ ваш · BYOK — используется твой ключ Claude, Operon не перепродаёт токены · подробнее →
  1. Сгенерируй API-токен Operon
    нажми «Сгенерировать» →
    // показывается только один раз — сохрани в безопасное место
  2. Добавь в Claude Code settingsфайл ~/.config/claude-code/mcp.json
    {
      "mcpServers": {
        "operon": {
          "command": "npx",
          "args": ["@operon/mcp"],
          "env": {
            "OPERON_TOKEN": "<вставится-при-copy>",
            "OPERON_PROJECT": "{{PROJECT_ID}}"
          }
        }
      }
    }
    // токен подставится при «копировать» — он не записывается в DOM
  3. Перезапусти Claude Codeили выполни /mcp reload
  4. Готовоагент сможет читать код, открывать PR и комментировать
// статус подключения
Ждём подключения Claude Code...
// токен сгенерирован
// репозиторий kirillsil/operon
// контекст 4 .md документа
// handshakeожидание...
Claude Code подключён// 14 MCP-tools · доступ к репо ✓ · контекст ✓ · BYOK ✓агент сможет: брать задачи, читать код, открывать PR, отвечать на ревью
Не знаешь, где конфиг? Открой Claude Code → Settings → MCP Servers, или инструкция для macOS / Linux / Windows →
дальше — отдать первую задачу агенту
Назад // шаг 7·первая работа агента
Отдай первую задачу агентуИз 47 импортированных задач — выбери одну, которую агент возьмёт прямо сейчас
// прошло8:24
// 5 топ-кандидатов из импорта
JIRA-1234
Validation regex для email v2! приоритетbackend· есть acceptance criteria
// хороший кандидат
JIRA-1235
Migrate users table indexes!! высокийbackend· db migration
JIRA-1240
Update Sentry alerting rulesнет приоритетаdevops
JIRA-1248
Add E2E tests for onboarding!! высокийqa
JIRA-1251
Refactor catalog list cacheнет приоритетаbackend
// + ещё 42 в бэклоге — посмотреть все на доске
// что произойдёт
1Agent читает задачу + контекст проекта (4 .md документа)
2Agent пишет код + тесты в новой ветке feat/jira-1234-email-validation
3Agent создаёт PR с превью deploy и описанием изменений
4Ты принимаешь работу в Mission Control одним кликом
Claude Code взял JIRA-1234// задача в работе · ETA 45 мин · branch созданотслеживай прогресс в Mission Control — там агент покажет diff
// доска через 10 секунд
К работе
JIRA-1235
Indexes
JIRA-1240
Sentry
В работе
JIRA-1234
Email regex
Ревью
JIRA-1234
PR #128 ✓
→ через ~45 мин: «Готова к ревью!»
первая работа агента готова

Первая работа агента — в Mission Control

Это и есть рабочий цикл Operon. Дальше — твой темп.

Открыть доску и Mission Control время от регистрации: 8:24· цель first-agent-accepted-task ✓
// edge-cases existing-project
// edgeempty repoпропустить bootstrap — ручной ввод
// edgemonorepoвыбрать подпапку как entry-point
// edgeno-code, есть таскипропустить репо, только импорт
// edgelarge reposcanning > 5 мин — фоновый mode