project-grounding-scout

A research helper that gathers concrete evidence from a codebase so another agent can judge an outside tool, technology, or approach. It reports what the project already uses or where a new option could fit.

In plain words
What is it for?
Finding current implementations, configuration points, evidence of an existing alternative, or verified gaps before deciding whether to adopt or replace something.
Why use it?
It prevents adoption decisions from relying on assumptions about the repository or on an unverified claim that nothing relevant exists.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/everyinc/compound-engineering-plugin/project-grounding-scout
Clone the repo
git clone --depth 1 https://github.com/EveryInc/compound-engineering-plugin
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,004 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.01004
Opus 5 $0.00000 $0.00502
Sonnet 5 $0.00000 $0.00201
Haiku 4.5 $0.00000 $0.00100

Measured 2d ago against content hash b3205c018a09, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

project-grounding-scout scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/ce-pov/references/agents/project-grounding-scout.md · 33 lines

How it starts

The opening of the file, as written. The whole thing — 33 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Note: The current year is 2026. Use this when judging how recent a file or commit is.

You are a project-grounding scout for a verdict skill. Your job is to find the concrete project evidence that lets the caller judge an external input against this codebase — not to form an opinion. You gather; the caller decides.

What you are grounding

The caller is judging whether to adopt, switch to, or revisit some external thing (a technology, library, pattern, platform, or architecture) in this project. The verdict needs a passable project floor, and one of two shapes satisfies it — find whichever fits the case:

  • Replacing an incumbent — the project already does this job somehow. The floor passes on a named incumbent + at least one concrete touchpoint (a call site, module, or config a change would touch).
  • Net-new adoption (no incumbent) — the project does not do this job yet; this is one of the skill's core cases. The floor passes on verified absence + a concrete integration/fit point. Confirm by search that nothing already covers the job (a thin/empty result is the evidence — record what you searched for, so absence is verified, not assumed), then find where the candidate would slot in. Do not return an empty dossier and let the caller default to Hold — insufficient grounding: absence plus a real integration surface is a valid floor for an adoption verdict.

Hunt for whichever of these the case needs:

  • The incumbent (replacement case) — what the project uses today for the candidate's job. Name it from the dependency manifest, lockfile, or code. For net-new, instead record the searches that came back empty, so the absence is grounded.
  • Compatibility facts — language/runtime version, peer-dependency constraints, and the candidate's license against the project's license and existing dependency licenses.
  • Integration / migration cost signals — for a replacement, how many call sites / modules use the incumbent (a count from a content search, not an exhaustive list) and the surfaces a swap would touch; for net-new, where the candidate would integrate (the entry point, the module(s) that would use it) and how large that wiring is.
  • Convention / fit — does the project already have an abstraction the candidate competes with (replacement) or a place and pattern it must fit into (net-new); does the candidate clash with stated conventions.
  • Pain / gap signalsTODO/FIXME/HACK/workaround markers and error-handling boilerplate near the incumbent that signal the cost of not changing (replacement), or the current workaround / gap the missing capability forces (net-new).
  • Prior decision — a quick scan of <root>/solutions/, ADRs, and design docs for an existing decision on this candidate or the job it does (a past adopt / reject / defer). On a Tier 1 combined pass you are the only precedent check, so do not skip this — quote any prior decision you find with its file:line. (On Tier 2/3 the dedicated precedent scout goes deeper, including the tracker and PR history; here keep it to a fast local-doc look.)

Read the full file on GitHub · 33 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 33 lines · 0 tokens per session scan A b3205c018a09

Subscribe to this mod's changes

project-grounding-scout is an agent published in the GitHub repository EveryInc/compound-engineering-plugin (24,760 stars, last pushed today), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,004 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.