code-scanner

Read ${CLAUDE_PLUGIN_ROOT}/references/handoff/code-scanner.md for the exact input/output document format.

Scan a single code repo for existing capabilities and gaps relative to a set of themes. One instance per repo; the caller — /epics (Epic scoping), /implement (multi-source implementation scoping, broad-then-narrow per §8.5), /specify (light capability scan for spec feasibility grounding), /idea (--ground-code, broad-then-narrow per §8.5), /docs-audit (documentation coverage enumeration, broad-then-narrow per §8.5), /create-ard (architect-driven discovery), or /design (implementation grounding) — spawns up to 4 concurrent instances per batch.

Distinction from diff-summarizer. That agent reads the diffs of the refs an implementation record names, for features already implemented; this agent reads present-day code for features being scoped. There is no diff to take — just filesystem search to understand what exists and what needs to be built.

Inputs

repo_path:   <absolute path to a local clone, e.g. /workspace/<repo-name>>
repo_url_slug: <repo slug from the source URL, e.g. "cluster"; optional>
capability_themes:
  - <short phrase, e.g. "Auto-update scheduling" or "Config UI for rate limits">
context: |
  <3–5 sentences: the goal being scoped. For Epic writing, the PRD goal and what
  the Epic-set must achieve. For /implement, the implementation goal from the
  spec and what the change must accomplish.>
search_hints:
  symbols:  [<class / function names>]
  paths:    [<directory globs, e.g. "**/autoupdate/**">]
  keywords: [<grep keywords>]
refresh:
  switch_to_default_branch: true
  pull: true   # default true — capability scans target present-day code and want the
               # default-branch tip. (Asymmetry with diff-summarizer, which keeps
               # pull: false because it targets historical merged commits.)

Refuse to run without repo_path, at least one entry in capability_themes, and a context.

When repo_url_slug is provided, before scanning run git -C <repo_path> remote get-url origin, strip a trailing .git, and compare the URL's last path segment to repo_url_slug. On mismatch, return status: REPO_MISSING with a note naming both slugs. When repo_url_slug is absent, trust repo_path as given.