subagent-runner

Subagent Runner

Автоматический запуск субагентов для параллельной обработки сложных задач.

Когда использовать

✅ Используй когда:

• Задача разбивается на 2+ независимых подзадачи
• Нужна параллельная обработка (исследование + написание + дизайн)
• Большой объём работы, который можно распараллелить
• Разные части задачи требуют разных специализаций

❌ НЕ используй когда:

• Задача простая, выполнима за 1-2 шага
• Подзадачи зависят друг от друга (нужна последовательность)
• Результат одной подзадачи нужен для начала другой

Workflow

1. Анализ задачи

Определи:

• Можно ли разбить на независимые части?
• Сколько субагентов нужно? (обычно 2-4)
• Какая специализация у каждого?

2. Запуск субагентов

Используй HTTP API daemon-а (localhost:4632):

# Отправь progress сообщение
bun ~/.claude/plugins/cache/claudeclaw/claudeclaw/1.0.0/commands/progress.ts "🤖" "Запускаю 3 субагента для задачи: [название]"

# Запусти субагента через REST API
curl -X POST http://localhost:4632/api/subagent/run \
  -H "Content-Type: application/json" \
  -d '{"name": "researcher", "prompt": "Исследуй тему X, найди 5 источников"}'

# Получи task_id из ответа:
# {"ok":true,"taskId":"uuid-here","name":"researcher","prompt":"..."}

Сохрани task_id для мониторинга:

TASK_ID="полученный-uuid"

3. Мониторинг

Проверяй статус через API:

# Получи статус субагента
curl http://localhost:4632/api/subagent/status/$TASK_ID

# Ответ:
# {"ok":true,"status":{"id":"uuid","name":"researcher","status":"running|completed|failed",...}}

# Или дождись результата (блокирующий вызов, таймаут 60 сек по умолчанию)
curl "http://localhost:4632/api/subagent/wait/$TASK_ID?timeout=120000"

# Ответ при успехе:
# {"ok":true,"result":"текст результата субагента"}

Альтернатива - читай файлы напрямую:

# Проверь все запущенные субагенты
ls -la ~/.claude/claudeclaw/subagents/

# Читай результаты по мере готовности
cat ~/.claude/claudeclaw/subagents/$TASK_ID.txt