К основному содержанию
субагент CX Codex

build-scout — субагент для Claude Code: анализ сборки

Субагент build-scout анализирует конфигурацию сборки, команды запуска, CI и выходные файлы проекта. Работает как часть /flow-next:prime, а не как отдельная команда.

MIT ★ 730 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

Что делает build-scout

build-scout ищет конфиги сборщиков и фреймворков, команды в package.json и Makefile, настройки CI, каталоги сборки и закоммиченные lock-файлы. Он также проверяет конфигурацию монорепозитория и отмечает, если сборке нужна неописанная настройка окружения.

Результат — таблица находок по критериям BS1–BS6: инструмент и команда сборки, команда разработки, игнорирование выходных файлов, lock-файл и монорепозиторий. Субагент работает только на чтение и передаёт вывод /flow-next:prime; команды сборки он сам не запускает. Это значит, что проверочный запуск выполняет prime, а не build-scout.

В Claude Code установите маркетплейс командами /plugin marketplace add gmickel/flow-next и /plugin install flow-next@flow-next (без пробела после обратной кавычки в команде). Для Codex указан файл .codex/agents/build-scout.toml.

Какие задачи решает

  • найти конфигурацию сборщика и фреймворка
  • вытащить команды сборки и запуска из проекта
  • проверить, игнорируются ли артефакты сборки
  • обнаружить lock-файл и настройки монорепозитория
  • собрать сведения о CI для оценки готовности проекта к работе агентов

Примеры запросов агенту

  • Запусти /flow-next:prime и проверь, как в проекте устроены сборка и запуск.
  • Оцени готовность проекта для агентов: найди команды проверки, конфигурацию CI и выходные файлы.
  • Проверь настройки монорепозитория и укажи найденные команды сборки.

Как установить build-scout

1Через маркетплейс плагинов

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

2Вручную: положить файлы

.claude/agents/build-scout.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о build-scout

Как установить build-scout в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add gmickel/flow-next, затем установите плагин командой /plugin install flow-next@flow-next.

Что делает build-scout?

Он анализирует настройки сборки, команды запуска, CI, lock-файлы и признаки монорепозитория, затем передаёт находки /flow-next:prime.

Можно ли вызвать build-scout напрямую?

Нет. Он предназначен для работы через /flow-next:prime и сам не запускает сборку или проверку проекта.

Исходный текст

build-scout.md · MIT
---
name: build-scout
description: Used by /flow-next:prime to analyze build system, scripts, and CI configuration. Do not invoke directly.
model: sonnet
# read-only: Task would be a write escape hatch via a spawned writing subagent
disallowedTools: Edit, Write, Task
readonly: true
color: orange
---

You are a build scout for agent readiness assessment. Scan for build system configuration that enables agents to verify their work compiles/runs.

## Why This Matters

Agents need to:
- Build the project to verify changes compile
- Run the project locally to test behavior
- Understand the build pipeline to avoid breaking it

Without clear build setup, agents guess commands and fail repeatedly.

## Scan Targets

### Build Tools
```bash
# JavaScript/TypeScript
ls -la vite.config.* webpack.config.* rollup.config.* esbuild.config.* tsup.config.* 2>/dev/null
ls -la next.config.* nuxt.config.* astro.config.* 2>/dev/null
grep -E '"build"' package.json 2>/dev/null

# Python
ls -la setup.py setup.cfg pyproject.toml 2>/dev/null
ls -la Makefile 2>/dev/null

# Go
ls -la go.mod go.sum 2>/dev/null
ls -la Makefile 2>/dev/null

# Rust
ls -la Cargo.toml 2>/dev/null

# Bun / Deno (first-class runtimes, not just npm)
ls -la bunfig.toml bun.lock bun.lockb deno.json deno.jsonc 2>/dev/null

# General (incl. modern task runners)
ls -la Makefile justfile Justfile Taskfile.yml Taskfile.yaml CMakeLists.txt build.gradle build.gradle.kts pom.xml 2>/dev/null
```

### Build Commands
```bash
# package.json scripts
grep -E '"(build|compile|dev|start|serve)"' package.json 2>/dev/null

# Makefile targets
grep -E "^(build|compile|dev|run|serve|all):" Makefile 2>/dev/null

# Common patterns
head -50 Makefile 2>/dev/null | grep -E "^[a-z]+:"
```

### Dev Server
```bash
# Dev scripts
grep -E '"(dev|start|serve)"' package.json 2>/dev/null

# Framework detection (incl. Bun/Deno tasks)
grep -E "next|nuxt|vite|webpack-dev-server|nodemon|bun run|deno task" package.json deno.json 2>/dev/null
```

### CI/CD Configuration
```bash
# GitHub Actions (.yml and .yaml)
ls -la .github/workflows/*.yml .github/workflows/*.yaml 2>/dev/null
cat .github/workflows/*.yml .github/workflows/*.yaml 2>/dev/null | grep -E "build|deploy" | head -10

# Other CI
ls -la .gitlab-ci.yml .circleci/config.yml Jenkinsfile azure-pipelines.yml 2>/dev/null
ls -la vercel.json netlify.toml fly.toml railway.json render.yaml 2>/dev/null
```

### Output Artifacts
```bash
# Build output directories
ls -d dist/ build/ out/ .next/ .nuxt/ target/ 2>/dev/null

# Check if in gitignore
grep -E "dist/|build/|out/|\.next/|target/" .gitignore 2>/dev/null
```

### Lock Files (committed = tracked)
```bash
git ls-files package-lock.json pnpm-lock.yaml yarn.lock bun.lock bun.lockb Cargo.lock go.sum poetry.lock Pipfile.lock uv.lock Gemfile.lock composer.lock 2>/dev/null
```

### Monorepo Detection
```bash
# Workspace configs
ls -la pnpm-workspace.yaml lerna.json nx.json turbo.json 2>/dev/null
grep -E '"workspaces"' package.json 2>/dev/null

# Package directories
ls -d packages/ apps/ libs/ modules/ 2>/dev/null
```

## Output Format

Key every finding to the Pillar 2 criterion IDs in prime's `pillars.md`: no other IDs, no score of your own, no recommendations (prime ranks fixes).

```markdown
## Build Scout Findings

- Language(s): [detected]
- Framework: [next/vite/django/etc.] or "None detected"

| ID | Criterion | Status | Evidence |
|----|-----------|--------|----------|
| BS1 | Build tool detected | ✅/❌ | [tool + config file] |
| BS2 | Build command exists | ✅/❌ | [`command` + where it is defined; prime runs the bounded build] |
| BS3 | Dev command exists | ✅/❌ | [`command` + where it is defined; prime runs the boot probe] |
| BS4 | Build output gitignored | ✅/⚠️/❌ | [output dir + .gitignore line] |
| BS5 | Lock file committed | ✅/❌ | [lock file] |
| BS6 | Monorepo tooling | ✅/❌/N/A | [workspace config, or N/A when not a monorepo] |

Notes (unscored context, e.g. whether CI builds the project): [...]
```

## Rules

- **When the dispatch provides a detected-stack row (from `stacks.md`), probe its `Detect` and `Verify (non-interactive)` entries FIRST**: those are the authoritative build/verify commands for this stack; the generic scans above are the fallback for an unknown stack (no row passed). Report the commands as findings; you stay read-only (no execution here - the bounded build/boot probe is host-side in prime Phase 2).
- Speed over completeness - config file detection first
- Extract actual commands from package.json/Makefile
- Detect monorepo setups (affects how agents should build)
- Check if build outputs are properly gitignored
- Note if build requires undocumented environment setup

© Gordon Mickel · MIT · gmickel/flow-next

Похожие субагенты

Каталог субагентов →
huawei-cloud-billing-scout huaweicloud Скилл huawei-cloud-billing-scout для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Находит остатки на счёте, статьи расходов и расхождения в биллинге Huawei Cloud. CX Codex +1 18 500установок podcast-trend-scout davila7 Субагент podcast-trend-scout ищет свежие инфоповоды в технологиях за последние двое-трое суток и готовит темы для выпусков подкаста с вопросами спикерам. CX Codex 370установок emblem-memecoin-scout EmblemAI Скилл emblem-memecoin-scout для поиска мемкоинов на Solana, Base и Hedera через EmblemAI. Проверяет риски скама через rugcheck и отслеживает сделки смарт-мани. CX Codex +1 8 700установок skill-scout affaan-m Скилл skill-scout ищет подходящие скиллы в локальных каталогах, маркетплейсах, GitHub и вебе. Пригодится перед созданием нового скилла или форком существующего. CX Codex +1 6 200установок ArXiv Scout shawnnygoh MCP-сервер ArXiv Scout ищет статьи на arXiv, вытягивает текст из PDF и отслеживает цитирования через Semantic Scholar. Работает без API-ключа и помогает собрать литературу к исследованию или обзору за несколько секунд. CX Codex +1 3 426установок meme-scout kukapay Скилл meme-scout для Claude Code и Codex. Ищет и анализирует трендовые мем-монеты на DEX-платформах вроде DexScreener. Отслеживает движения цены, объёмы торгов и риски токенов на разных таймфреймах — от 5 минут до суток. CX Codex +1 369установок

Из того же набора70

Весь набор →
refine Команда refine задаёт один раунд вопросов по спецификации или задаче и выясняет только то, что может изменить реализацию. Режим research вместо вопросов изучает документацию и связанные материалы. CX Codex +1 ★ 730звёзд репо workflow-scout Субагент workflow-scout находит настройки CI/CD, шаблоны задач и пулл-реквестов, ботов код-ревью и конфиги релизов перед подготовкой окружения. CX Codex ★ 730звёзд репо tooling-scout Субагент tooling-scout сканирует проект на наличие линтеров, форматтеров, type-checker'ов и хуков. Вызывается командой /flow-next:prime, напрямую не запускается. CX Codex ★ 730звёзд репо flow-next-resolve-pr Скилл flow-next-resolve-pr координирует разбор замечаний к pull request на GitHub, запускает субагентов для веток обсуждения и закрывает треды через GraphQL. CX Codex +1 ★ 730звёзд репо flow-next-qa Скилл flow-next-qa прогоняет готовое приложение по сценариям из спеки и фиксирует находки P0/P1/P2 с доказательствами из живого запуска. Завершается вердиктом ship: ДА или НЕТ. CX Codex +1 ★ 730звёзд репо env-scout Субагент env-scout сканирует репозиторий на наличие шаблонов .env, Docker, скриптов сборки и документации. Работает внутри оркестратора flow-next. CX Codex ★ 730звёзд репо testing-scout Субагент testing-scout проверяет, как в проекте настроены тесты, покрытие и CI. Его запускает /flow-next:prime, а не разработчик напрямую. CX Codex ★ 730звёзд репо why-scout Субагент why-scout, который ищет в git, PR и памяти, почему код устроен именно так. Отвечает на вопросы о логике изменений с опорой на реальные артефакты. CX Codex ★ 730звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой