deploy-agent

deploy-agent — это агент для поэтапного деплоя full-stack приложений. Он проводит вас через весь процесс: сборка → тестирование → GitHub → Cloudflare Pages, с обязательным подтверждением человека на каждом этапе.

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

# Установка через ClawHub
clawhub install deploy-agent

# Инициализация нового деплоя
deploy-agent init my-app

# Проверка статуса
deploy-agent status my-app

# Продолжение процесса
deploy-agent continue my-app

Этапы workflow

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

• Шаг 1 — init: запуск деплоя и переход к этапу дизайна
• Шаг 2 — build: сборка приложения
• Шаг 3 — test: локальное тестирование
• Шаг 4 — push: отправка кода в GitHub
• Шаг 5 — deploy: деплой в Cloudflare Pages

Основные команды

Ниже приведены ключевые команды для управления процессом деплоя:

# Инициализация
deploy-agent init my-app

# Проверка статуса
deploy-agent status my-app

# Подсказка следующего шага
deploy-agent continue my-app

# Сборка (шаг 2)
deploy-agent build my-app

# Тестирование (шаг 3)
deploy-agent test my-app

# Публикация в GitHub (шаг 4)
deploy-agent push my-app [repo-name]

# Деплой (шаг 5)
deploy-agent deploy my-app [custom-domain]

# Отмена
deploy-agent cancel my-app

# Список деплоев
deploy-agent list

Пример сессии

$ deploy-agent init my-blog
🚀 Deployment initialized: my-blog
Step 1: Design your app with C.R.A.B

$ deploy-agent build my-blog
🚀 Build complete!
Step 2: Local Testing

cd my-blog && npm run dev

$ deploy-agent push my-blog
🚀 GitHub repository ready!
Say 'deploy-agent deploy my-blog' to deploy to Cloudflare

$ deploy-agent deploy my-blog my-blog.sheraj.org
🎉 Deployment complete!
App live at: https://my-blog.sheraj.org

Управление состоянием

Каждый деплой хранит своё состояние локально, что позволяет продолжать процесс между сессиями.

~/.clawdbot/skills/deploy-agent/state/{deployment-name}.json

Пример структуры состояния:

{
 "name": "my-blog",
 "step": 5,
 "status": "deployed",
 "created_at": "2026-01-18T08:00:00Z",
 "repo_url": "https://github.com/user/my-blog",
 "domain": "https://my-blog.sheraj.org"
}

Требования

• gh — работа с GitHub
• wrangler — деплой в Cloudflare Pages
• git — контроль версий
• jq — обработка JSON

Конфигурация

Для работы с Cloudflare необходимо указать API-токен:

~/.wrangler.toml

[account]
api_token = "your-cloudflare-token"

Заметки

• Каждый деплой полностью изолирован
• Состояние сохраняется между сессиями
• На каждом этапе требуется подтверждение пользователя
• Процесс можно отменить в любой момент через cancel

Деплой Next.js + Cloudflare D1

Агент также включает рекомендации и решения типичных проблем при деплое Next.js-приложений с использованием D1 на Cloudflare Pages.

---