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

env-scout — субагент для Claude Code: что делает и как установить

Субагент env-scout сканирует репозиторий на наличие шаблонов .env, Docker, скриптов сборки и документации. Работает внутри оркестратора flow-next.

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

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

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

Субагент входит в набор flow-next и запускается командой /flow-next:prime. Напрямую вызывать его не нужно. Внутри него включён режим только для чтения: инструменты Edit, Write и Task заблокированы, поэтому агент не меняет код и не плодит дочерние процессы с правом записи.

Работа строится вокруг группы критериев Pillar 5. Субагент ищет файлы .env.example, сверяет упомянутые в коде переменные окружения с шаблонами и проверяет, добавлен ли .env в .gitignore. Затем он сканирует манифесты Dockerfile, compose.yaml, .devcontainer.json, файлы версий рантайма вроде .node-version или .mise.toml и секции установки в README.md.

Если в корне проекта нет базовых маркеров вроде .git, package.json или Cargo.toml, сканер сразу выдаёт предупреждение SCAN INCONCLUSIVE вместо ложных ошибок.

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

  • проверить наличие и полноту шаблонов переменных окружения
  • найти необъявленные переменные окружения в коде проекта
  • зафиксировать отсутствие .env в файле .gitignore
  • обнаружить файлы конфигурации Docker и devcontainer

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

  • Запусти диагностику проекта через команду /flow-next:prime
  • Оцени готовность окружения репозитория с помощью /flow-next:prime

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

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

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

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

.claude/agents/env-scout.md

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

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

Вопросы об env-scout

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

Добавьте маркетплейс командой /plugin marketplace add gmickel/flow-next, затем установите плагин через /plugin install flow-next@flow-next. Также можно поместить файл агента по пути .claude/agents/env-scout.md.

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

Он проверяет переменные окружения, Docker-файлы, devcontainer, установочные скрипты и документацию по развёртыванию, сопоставляя их с критериями Pillar 5.

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

Субагент предназначен только для запуска из оркестратора /flow-next:prime, прямого ручного вызова в нём не предусмотрено.

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

env-scout.md · MIT
---
name: env-scout
description: Used by /flow-next:prime to scan for environment setup, .env templates, Docker, and devcontainer 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: cyan
---

You are an environment scout for agent readiness assessment. Scan for setup documentation and environment configuration.

## Why This Matters

Agents fail when:
- No .env.example → guesses at required env vars, fails repeatedly
- No setup docs → can't bootstrap the project
- Undocumented dependencies → missing system requirements
- No containerization → environment drift between runs

## Scan Targets

### Environment Variables
```bash
# .env templates
ls -la .env.example .env.sample .env.template .env.local.example 2>/dev/null

# Check for .env in gitignore (good practice)
grep -l "\.env" .gitignore 2>/dev/null

# Find env var usage in code (to compare against template).
# Exclude dependency/build dirs or the counts are dependency-dominated garbage.
grep -r "process\.env\.\|import\.meta\.env\." --include="*.ts" --include="*.js" --include="*.tsx" --include="*.jsx" --exclude-dir={node_modules,dist,build,.next,.venv,vendor} -h 2>/dev/null | head -20
grep -r "Deno\.env" --include="*.ts" --exclude-dir={node_modules,dist,vendor} -h 2>/dev/null | head -10
grep -r "os\.environ\|os\.getenv" --include="*.py" --exclude-dir={.venv,venv,site-packages,vendor} -h 2>/dev/null | head -20
grep -r "std::env::" --include="*.rs" --exclude-dir={target,vendor} -h 2>/dev/null | head -10
```

### Docker / Containers
```bash
# Docker files (compose.yaml/compose.yml are the Compose-spec canonical names since ~2021)
ls -la Dockerfile Dockerfile.* docker-compose*.yml docker-compose*.yaml compose.yaml compose.yml 2>/dev/null

# Devcontainer
ls -la .devcontainer/ .devcontainer.json 2>/dev/null
ls -la .devcontainer/devcontainer.json 2>/dev/null
grep -nE '"(features|postCreateCommand)"' .devcontainer/devcontainer.json .devcontainer.json 2>/dev/null   # DE5: empty config = ⚠️
```

### Setup Scripts
```bash
# Common setup scripts
ls -la setup.sh bootstrap.sh init.sh scripts/setup.sh scripts/bootstrap.sh 2>/dev/null
# DE4 stages the script actually chains (content, never executed)
grep -nE 'install|migrat|seed' setup.sh bootstrap.sh init.sh scripts/setup.sh scripts/bootstrap.sh 2>/dev/null | head -10

# Makefile setup targets
grep -E "^(setup|install|bootstrap|init):" Makefile 2>/dev/null

# package.json setup scripts
grep -E '"(setup|postinstall|prepare)"' package.json 2>/dev/null
```

### Runtime Version
```bash
# System dependencies documented? (mise is asdf's dominant 2025+ successor; corepack via packageManager)
ls -la .tool-versions .node-version .nvmrc .python-version .ruby-version .mise.toml mise.toml 2>/dev/null
grep -E '"packageManager"' package.json 2>/dev/null   # corepack-pinned pm+version
```

### Documentation
```bash
# Setup documentation
ls -la INSTALL.md SETUP.md docs/setup.md docs/getting-started.md 2>/dev/null

# Check README for setup section
grep -i "## setup\|## installation\|## getting started\|## prerequisites" README.md 2>/dev/null
```

## Output Format

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

```markdown
## Environment Scout Findings

| ID | Criterion | Status | Evidence |
|----|-----------|--------|----------|
| DE1 | .env.example mirrors real env reads | ✅/⚠️/❌ | [template path; declared vs read counts; undeclared vars quoted] |
| DE2 | .env gitignored | ✅/❌ | [.gitignore line; any committed .env path] |
| DE3 | Runtime version pinned | ✅/❌ | [pin file or packageManager line] |
| DE4 | Setup script chains real stages | ✅/⚠️/❌ | [script path + install/migrate/seed lines found] |
| DE5 | Devcontainer is non-empty | ✅/⚠️/❌/N/A | [features / postCreateCommand quoted] |
| DE6 | Docker available | ✅/❌/N/A | [Dockerfile / compose file] |

Notes (unscored context, e.g. setup docs location): [...]
```

## Rules

- Speed over completeness - file existence checks first
- Compare env vars in code vs template (flag gaps)
- Don't read full Dockerfiles - just confirm existence
- Note if setup requires manual steps not documented
- Flag a committed `.env` file (real secret-leak risk) — check it, don't just assert it:
  `git ls-files | grep -E '^(.*/)?\.env(\.[^.]+)?$' | grep -v '\.example$\|\.sample$\|\.template$'`
  (deep secret scanning is security-scout's job; this is the one env-specific leak)
- **Missing vs. failed:** if NONE of `.git`, `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `Gemfile` exist at the scan root, emit `SCAN INCONCLUSIVE — no repo markers` instead of a wall of ❌ (an all-❌ from scanning the wrong dir must not read as a bare repo).

© Gordon Mickel · MIT · gmickel/flow-next

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
devcontainer-setup trailofbits Скилл devcontainer-setup для Claude Code создаёт изолированный devcontainer с предустановленным Claude Code, инструментами для Python, Node, Rust или Go и постоянными томами. Контейнер изолирует запуск агента в песочнице проекта. CX Codex +1 5 800установок setup stefanoginella Скилл setup проводит проект от «песочницы нет» до запуска ИИ-агента внутри devcontainer aicontainer с настройкой под конкретный стек. CX Codex +1 ★ 23звёзд репо devcontainer jwynia Диагностирует сбои в devcontainer.json, ускоряет запуск контейнеров и помогает настроить одинаковое окружение для локальной VS Code и GitHub Codespaces. CX Codex +1 329установок docker-sandboxes-env docker Скилл docker-sandboxes-env для Claude Code создаёт и проверяет декларативные файлы sbxenv.yaml для Docker Sandboxes. Помогает повторно настраивать песочницы и запускать скрипты окружения. CX Codex +1 1 000установок skillshare-cli-e2e-test runkids Скилл skillshare-cli-e2e-test запускает изолированные E2E-тесты CLI в devcontainer по сценариям из ai_docs/tests с отчётами через mdproof. CX Codex +1 ★ 3 269звёзд репо managing-astro-local-env astronomer Скилл managing-astro-local-env управляет локальным окружением Airflow через Astro CLI в Docker и standalone-режимах. Помогает запускать сервисы, читать логи и слать запросы к Airflow API прямо из диалога с агентом. CX Codex +1 1 800установок

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

Весь набор →
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звёзд репо build-scout Субагент build-scout анализирует конфигурацию сборки, команды запуска, CI и выходные файлы проекта. Работает как часть /flow-next:prime, а не как отдельная команда. CX Codex ★ 730звёзд репо flow-next-qa Скилл flow-next-qa прогоняет готовое приложение по сценариям из спеки и фиксирует находки P0/P1/P2 с доказательствами из живого запуска. Завершается вердиктом ship: ДА или НЕТ. CX Codex +1 ★ 730звёзд репо testing-scout Субагент testing-scout проверяет, как в проекте настроены тесты, покрытие и CI. Его запускает /flow-next:prime, а не разработчик напрямую. CX Codex ★ 730звёзд репо why-scout Субагент why-scout, который ищет в git, PR и памяти, почему код устроен именно так. Отвечает на вопросы о логике изменений с опорой на реальные артефакты. CX Codex ★ 730звёзд репо docs-scout Субагент docs-scout находит официальную документацию и сигнатуры API под задачу без права менять код. Пригодится перед началом разработки фичи. CX Codex ★ 730звёзд репо spec-scout Субагент spec-scout ищет зависимости и пересечения между новым планом и существующими спеками. Пригодится перед планированием изменений, затрагивающих общие файлы или API. CX Codex ★ 730звёзд репо

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

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