Readiness Scouts

/flow-next:prime answers a single question: is this repository ready for agents to work in it effectively, and ready for production? It does that by dispatching eight specialized scouts in parallel, each owning one pillar of readiness. Every scout is read-only — Edit, Write, and Task are disallowed — so priming a repo never changes it; it only reports.

Prime reports on every pillar but only fixes agent-readiness gaps (with your approval); production-readiness findings are surfaced for you to act on.

How they fan out

flowchart TB
  Prime["/flow-next:prime"] --> Scouts
  subgraph Scouts["Eight pillars (parallel)"]
    Build["build-scout"]
    Test["testing-scout"]
    Tool["tooling-scout"]
    Md["claude-md-scout"]
    Env["env-scout"]
    Sec["security-scout"]
    Obs["observability-scout"]
    Flow["workflow-scout"]
  end
  Scouts --> Report["Readiness report"]

Agent-readiness pillars

These directly determine whether an agent can work in the repo without guessing.

Scout	Tier	Pillar
build-scout	Fast	Build system, scripts, and CI — can an agent compile and run the project to verify its changes?
testing-scout	Fast	Test framework, coverage configuration, and the commands to run tests for fast local verification.
tooling-scout	Fast	Linting, formatting, type-checking, and pre-commit — the fast-feedback loop that catches errors before CI.
claude-md-scout	Reasoning	Quality and completeness of CLAUDE.md / AGENTS.md — conventions, commands, and what not to do.
env-scout	Fast	Environment setup: .env templates, Docker, devcontainers, and undocumented system dependencies.

Production-readiness pillars

Not strictly required for agents to work, but important context that prime reports.

Scout	Tier	Pillar
security-scout	Fast	Branch protection and rulesets, CODEOWNERS, and dependency-update configuration (checked via the gh API).
observability-scout	Fast	Structured logging, distributed tracing, metrics, and health endpoints.
workflow-scout	Fast	CI/CD pipelines, PR and issue templates, and workflow automation.

Shared with planning

Scout	Tier	Job
docs-gap-scout	Reasoning	Flags documentation that has drifted from the code. Also dispatched by /flow-next:plan.

Note

Most readiness scouts sit in the Fast tier — mechanical, evidence-gathering scans across known config locations, not judgment calls. The two that weigh quality rather than presence (claude-md-scout, docs-gap-scout) sit in the Reasoning tier. Tiers map to a concrete model per platform — see the model-tier note on the overview. The judgment of what to fix lives in the prime skill itself.

Next step

/flow-next:prime

Prime applies its agent-readiness fixes with your approval, then hands you a report covering all eight pillars.