С чего начать и кто что должен сделать?

#Что понадобится

• Аккаунт. Бесплатный, карта не нужна.
• Машина, на которой лежит код. Windows, macOS или Linux. Программа для неё опубликована для пяти платформ: Windows на x86-64, macOS на Intel и на Apple silicon, Linux на x86-64 и на ARM64.
• Кодовый агент на этой машине. Claude Code или Codex. Анализ делает тот агент, которым вы уже пользуетесь, на его собственных условиях.
• Человек у этой машины минут на пять. Ваш разработчик, ваше агентство или вы сами. Он выполняет две строки в своём терминале и говорит одну фразу. Дальше агент работает сам.

#Создайте проект

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

Страница проекта дальше сама говорит, что ей нужно. На этом этапе ей нужна машина, с которой его анализировать.

#Подключите машину

Страница подключения в кабинете даёт человеку у машины две строки, для PowerShell на Windows или для терминала на macOS и Linux. Обе он выполняет в своём терминале сам, а не кодовый агент.

1. Установите 1adk-agent

   Строка установки скачивает программу с того же адреса, на котором человек вошёл в кабинет, сверяет её с опубликованной контрольной суммой и только потом устанавливает. Один раз на машину. Обновление делается той же строкой, а кабинет говорит, когда машина отстала.

   На Windows программа ставится в папку внутри локальных данных приложений и попадает в PATH. На macOS и Linux она ставится в локальную папку bin пользователя.

2. Подключите папку проекта

   Строка подключения несёт код сопряжения, который срабатывает один раз и истекает через несколько минут. Её выполняют в папке репозитория и указывают кодового агента через --for claude или --for codex, и 1adk-agent регистрирует себя как локальный сервер инструментов для этого агента.

   Один раз на репозиторий. У проекта одновременно одно живое подключение.

Учётные данные, которые в итоге хранит машина, не показываются ни на одной странице. Они создаются во время обмена, хранятся у 1adk-agent на этой машине, и подключение можно завершить из кабинета.

#Запустите анализ

Откройте кодового агента в той же папке. Если он уже был открыт, перезапустите его, чтобы он загрузил сервер инструментов, который зарегистрировала строка подключения. Потом скажите:

Больше никаких инструкций не нужно. Агент просит работу у 1adk-agent, делает по одной небольшой порции и возвращает каждый ответ через те же инструменты. Кабинет показывает, как движется анализ и подключена ли машина. Та же фраза продолжает работу после любого перерыва.

#Когда анализ закончен

Подключённый анализ после проверки попадает в проект сам. На странице проекта появляются карта системы, реестр её интерфейсов, доказательства под каждым утверждением, то, что ещё неизвестно, и то, насколько система изучена.

Сравнение начинается со второго анализа. Кнопка «Продолжить изучение» на странице проекта просит у той же подключённой машины следующий проход, и человек у машины открывает кодового агента и снова говорит фразу. 1ADK не может запустить кодового агента удалённо и не пытается. Бесплатный тариф включает два принятых анализа одного проекта, после этого проект остаётся доступным для чтения, а следующие анализы ждут.

Страница «Как читать результат» проходит по каждой части проекта.

#Кто что делает