ager-scan

name	ager-scan
description	Scan a codebase for agent frameworks (LangGraph, CrewAI, LlamaIndex, Claude/OpenAI APIs, MCP, Deep Agents, hyperscalers, microVMs) and for Claude/Grok/Codex/universal plugin agents and skills. Extracts prompts, tools, schemas, orchestration, loops, harness signals, and plugin frontmatter. Use when reverse-engineering an existing agent project into AGER concepts.

AGER Scan

Deterministic filesystem scan — the reverse-engineering detector for agent stacks. Sibling of SAC sac-scan / DEKC dekc-walk, specialized for multi-agent runtimes.

What it extracts

Finding kind	Maps toward AGER
plugin	Harness + AgentGraph
agent / skill	WorkerAgent / JudgeAgent / OrchestratorAgent
framework	Framework adapter notes
system_prompt / prompt	AgentNode.instructions / Prompt
tool	Tool + ToolRule
mcp	Tool + JSON-RPC schema
schema	InputSchema / OutputSchema
graph	AgentGraph + ControlEdge
loop	LoopPolicy + LoopControl
orchestration	Orchestrator / Handoff / FanOut / HumanGate
sandbox	ContextIsolationPolicy
hyperscaler	Run + CheckpointPolicy (AgentCore, Azure AI, Vertex)

Supported detectors (non-exhaustive)

• Claude Code plugins: .claude-plugin/plugin.json, .claude/agents/*.md, .claude/skills/*/SKILL.md (and undotted claude/)
• Grok Build plugins: .grok-plugin/, .grok/agents, .grok/skills (and undotted grok/)
• Codex plugins: .codex-plugin/plugin.json, .codex/agents, .codex/skills (and undotted codex/)
• Agent Plugins 1.0: root plugin.json ($schema agent-plugins.org) + agents/ + skills/
• Raw Claude / Anthropic API, OpenAI API
• LangChain, LangGraph, CrewAI, LlamaIndex
• OpenAI Agents SDK, Claude Agent SDK, Deep Agents, AutoGen, Semantic Kernel
• MCP servers / JSON-RPC tool catalogs
• Hyperscalers: Bedrock AgentCore, Azure AI Agents, Vertex Agent Engine
• Hardened runtimes: Firecracker microVMs, gVisor, Kata, E2B, hardened containers

Steps

1. Confirm the source root (repo path or clone).
2. Run:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/ager_scan.py" --root "$SOURCE_ROOT" --json -o scan.json

3. Summarize frameworks + counts for the user.
4. For materialization into a draft AGER bundle, continue with ager-reverse-engineer.

Notes

• Scan is best-effort and confidence-scored; it does not execute untrusted code.
• Prefer promoting high-confidence findings via ager-author after human review.
• Generic keyword hits (Supervisor / orchestrator role, container isolation, …) collapse to one finding with multiple evidence_paths instead of one node per file. Tool matches without a real identifier (Tool: { json blob }) are dropped.