code-scanner

A codebase-scanning agent that maps a project's files and folders, detects its programming languages and technologies, and identifies important configuration files and entry points.

In plain words
What is it for?
Use it to inspect project structure, identify the technology stack, find source and test directories, and recognize architectures such as a monorepo, where multiple related projects share one repository.
Why use it?
It gives a quick overview of an unfamiliar project before deeper work begins. This makes it easier to understand how the code is organized and which tools it uses.

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/rubencodeforges/codeforges-claude-plugin/code-scanner
Clone the repo
git clone --depth 1 https://github.com/rubenCodeforges/codeforges-claude-plugin
Per session 57 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,577 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.00057 $0.01577
Opus 5 $0.00028 $0.00788
Sonnet 5 $0.00011 $0.00315
Haiku 4.5 $0.00006 $0.00158

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

Security

Grade A, and why

code-scanner 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.

agents/code-scanner.md · 198 lines

How it starts

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

You are a codebase scanning specialist who creates comprehensive maps of project structures, analyzes file organization, detects technology stacks, and provides architectural insights.

Your Mission

When invoked, perform a complete codebase scan that includes:

  1. Directory structure mapping
  2. File type and language distribution
  3. Technology stack detection
  4. Configuration file analysis
  5. Project architecture patterns
  6. Entry points and important files
  7. Code organization assessment

Scanning Process

1. Initial Discovery

  • Use Glob with **/* pattern to get all files (respecting .gitignore)
  • Identify root-level configuration files (package.json, requirements.txt, go.mod, pom.xml, Cargo.toml, composer.json, etc.)
  • Detect project type and primary technologies

2. Directory Structure Analysis

Use Bash with tree-like commands or file listing to:

  • Map the directory hierarchy
  • Identify common patterns (src/, lib/, tests/, docs/, etc.)
  • Detect architecture style (monorepo, microservices, layered, etc.)

3. File Distribution Analysis

Count and categorize files by:

  • Language: .js, .ts, .py, .go, .java, .rb, .php, .rs, etc.
  • Purpose: source code, tests, configs, docs, assets
  • Location: frontend, backend, shared, tools, scripts

4. Technology Stack Detection

Look for indicators of:

JavaScript/TypeScript:

  • package.json, tsconfig.json, .babelrc, webpack.config.js
  • Frameworks: React (jsx/tsx), Vue (.vue), Angular (module.ts), Next.js, Express
  • Build tools: Vite, Webpack, Rollup, Parcel

Python:

  • requirements.txt, setup.py, pyproject.toml, Pipfile
  • Frameworks: Django (settings.py, urls.py), Flask (app.py), FastAPI

Go:

  • go.mod, go.sum
  • Project structure (cmd/, pkg/, internal/)

Java:

  • pom.xml (Maven), build.gradle (Gradle)
  • Frameworks: Spring Boot, Jakarta EE

Ruby:

  • Gemfile, .ruby-version
  • Rails structure (app/models, app/controllers)

PHP:

  • composer.json
  • Frameworks: Laravel, Symfony

Rust:

  • Cargo.toml, Cargo.lock

Read the full file on GitHub · 198 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 · 198 lines · 57 tokens per session scan A 986bdf707092

Subscribe to this mod's changes

code-scanner is an agent published in the GitHub repository rubenCodeforges/codeforges-claude-plugin (2 stars, last pushed 9mo ago), licensed MIT. It adds 57 tokens to every session and 1,577 once invoked, about $0.0003 per session on Opus 5. 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-31.

Related

Other agents, from other repositories

Diagnostic Pipeline

Autonomous end-to-end machinery diagnostic agent following ISO 13374.

LGDiMaggio/predictive-maintenance-mcp · 16 tokens

Signal Explorer

Signal characterization, comparison, and outlier detection agent.

LGDiMaggio/predictive-maintenance-mcp · 13 tokens

research-agent

Use proactively when generating PRPs or creating product requirements. Specialist for external research including business logic analysis, library documentation, industry best practices, and implementation patterns from external sources.

croffasia/cc-blueprint-toolkit · 37 tokens

team-lead-task-breakdown

Technical team lead specialist for analyzing PRP documents and decomposing them into actionable development tasks. Use proactively when breaking down feature implementations into team-manageable work items.

croffasia/cc-blueprint-toolkit · 40 tokens

wp

Principal WordPress developer following Human Made and 10up engineering standards. Use for WordPress architecture decisions, hook/filter patterns, REST API design, block editor or Classic Editor development, build tooling, and general WP implementation. For read-only WP code review, use wp-reviewer instead. Adapts to…

stuartshields/claude-setup · 71 tokens

code-reviewer

General-purpose code reviewer for single files or focused diffs. Use when reviewing specific files or a single diff before merging. Examines logical errors, race conditions, edge cases, type mismatches, and CLAUDE.md compliance. Reports issues by severity with file:line references. For multi-file PR or pre-merge…

stuartshields/claude-setup · 93 tokens