Skip to main content
subagent CX Codex

scout · rohitg00 — Claude Code subagent: task assessment and setup

scout examines a codebase before implementation and rates readiness across five dimensions. Use it to see whether the task is ready to start or needs more investigation.

MIT ★ 2,966 updated 2026-09-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Open on GitHub

What scout does

The subagent explores the task and project, then scores scope clarity, familiarity with existing patterns, dependency awareness, edge-case coverage, and the test plan. Its report gives a score out of 100 and a GO or HOLD verdict. If the score is low, scout looks for missing context and rates the task again.

It runs in the background in an isolated worktree, using Read, Glob, Grep, and Bash. scout must not edit files, so it handles investigation rather than implementation. A score of 70 or more earns GO; if the score stays below that after two rounds, it escalates the question to the user. This makes it a readiness check for unfamiliar or complex work, not a substitute for testing the changes.

What it helps with

  • check whether a project is ready for implementation
  • locate files likely to change for a task
  • identify gaps in dependency or edge-case understanding
  • work out how to verify a change with tests

Example prompts for the agent

  • Ask scout to inspect the project before implementation and rate whether there is enough context.
  • Have scout find relevant files and existing patterns, then return a GO or HOLD verdict.
  • Ask scout to review dependencies, edge cases, and the test plan for this task.

How to install scout

1Plugin marketplace

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

2Manually: put the files in place

.claude/agents/scout.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about scout

How do I install scout in Claude Code?

In Claude Code, run /plugin marketplace add rohitg00/pro-workflow, then run /plugin install pro-workflow@pro-workflow. The subagent file is at .claude/agents/scout.md.

What does scout do?

It explores the codebase, scores readiness across five dimensions, and returns GO or HOLD. On HOLD, it gathers more context and recalculates the score.

Can scout edit project files?

No. It is limited to read-only exploration and uses Read, Glob, Grep, and Bash.

Source text

scout.md · MIT
---
name: scout
description: Confidence-gated exploration that assesses readiness before implementation. Scores 0-100 across five dimensions and gives GO/HOLD verdict.
tools: ["Read", "Glob", "Grep", "Bash"]
background: true
isolation: worktree
omitClaudeMd: true
---

# Scout - Confidence-Gated Exploration

Assess whether there's enough context to implement a task confidently.

Runs in the background so you can continue working while it explores.

## Trigger

Use before starting implementation of unfamiliar or complex tasks.

## Workflow

1. Receive task description
2. Explore the codebase to understand scope
3. Score confidence (0-100)
4. If >= 70: GO with findings
5. If < 70: Identify what's missing, gather more context, re-score

## Confidence Scoring

Rate each dimension (0-20 points):

- **Scope clarity** - Do you know exactly what files need to change?
- **Pattern familiarity** - Does the codebase have similar patterns to follow?
- **Dependency awareness** - Do you know what depends on the code being changed?
- **Edge case coverage** - Can you identify the edge cases?
- **Test strategy** - Do you know how to verify the changes work?

## Output

```
SCOUT REPORT
Task: [description]
Confidence: [score]/100

Dimensions:
  Scope clarity:        [x]/20
  Pattern familiarity:  [x]/20
  Dependency awareness: [x]/20
  Edge case coverage:   [x]/20
  Test strategy:        [x]/20

VERDICT: GO / HOLD
```

## Rules

- Never edit files. Read-only exploration.
- Be honest about gaps. A false GO wastes more time than a HOLD.
- Re-score after gathering context. If still < 70 after 2 rounds, escalate to user.
- Runs in isolated worktree to avoid interfering with main session.

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

scout by other authors comes first.

scout parcadei scout — a subagent for systematic codebase research. Maps architecture, discovers naming conventions and patterns, then writes a detailed report so you can understand project structure at a glance. CX Codex ★ 3,951repo stars parallel-exploring spencerpauly parallel-exploring launches several explore subagents at once so you can map a large codebase fast. Useful for onboarding and for tracing a feature across layers. CX Codex +1 511installs zoom-out haowjy zoom-out spawns parallel explorers across structure, knowledge, and decision history, then merges their reports into a single orientation map of the area. CX Codex +1 443installs explore OrchestKit explore spawns 3–5 agents in parallel to map code structure, trace data flows, identify architecture patterns, and assess code health. Useful for quickly understanding an unfamiliar repo or discovering how a large system is designed. CX Codex +1 224installs gem-researcher official github gem-researcher is a GitHub Copilot subagent that explores codebases and maps architectural relationships. It joins research tasks where the agent should inspect a project without editing its code. CX Codex +1 ★ 41,430repo stars ArXiv Scout shawnnygoh ArXiv Scout searches arXiv, extracts text from PDFs, and tracks citations through Semantic Scholar. No API key required; gather research materials and build literature reviews in seconds. CX Codex +1 3,426installs meme-scout kukapay meme-scout — a skill for scouting and analyzing trending meme coins on DEX platforms like DexScreener. Tracks price movements, trading volumes, and token risks across multiple timeframes from 5 minutes to 24 hours. CX Codex +1 369installs

From the same set83

The whole set →
learn-rule learn-rule extracts session mistakes into one-line rules and saves them to your project memory after explicit confirmation. CX Codex +1 ★ 2,966repo stars wrap-up The wrap-up skill audits code changes, runs quality checks, and records what to pick up next. Use it when you are about to end a coding session. CX Codex +1 ★ 2,966repo stars incremental-verify incremental-verify keeps the agent on one failing test at a time: the smallest change that passes it, then a commit, before the next behavior starts. CX Codex +1 ★ 2,966repo stars token-efficiency token-efficiency cuts token burn in Claude Code by removing conversational filler, enforcing read-before-write, and stopping unwanted refactoring loops. CX Codex +1 ★ 2,966repo stars core-rules core-rules — a rule file for your project: commit checks, Git habits, context discipline and the way the agent replies. Paste it into CLAUDE.md or keep it standalone. CX Codex +1 ★ 2,966repo stars context-optimizer The context-optimizer command checks context window fill rates in Claude Code and helps cut token waste before responses degrade. CX Codex +1 ★ 2,966repo stars module-map The module-map skill builds a compact map of an unfamiliar codebase area, covering entry points, core modules, data flow, and callers. Use it when you need to get oriented. CX Codex +1 ★ 2,966repo stars parallel Run multiple Claude Code sessions in parallel with isolated git worktrees. Ideal for working on features, testing, and code review simultaneously without file conflicts. CX Codex +1 ★ 2,966repo stars

Project sponsors

Companies that keep this analytics open