artifact · free · MIT used in Lightning Lesson 02

org-readiness-scan-v1.sh

Forty-eight lines of bash. Run it against your repo root. It surfaces the existing AI footprint of your org — CLAUDE.md hierarchy, hooks, MCP servers, rule conflicts — and produces a flat report you can read on a plane. No telemetry. No install. No account.

README · preview v1.0.4 · 2026-04-21

# org-readiness-scan-v1.sh
# Surface the AI footprint already shipping in your org.
# Read-only. No network. No auth. ~6s on 60-engineer monorepo.

$ chmod +x org-readiness-scan-v1.sh
$ ./org-readiness-scan-v1.sh ~/code

→ scanning 58 repositories
→ CLAUDE.md hierarchy: 4 levels, 73 files
→ hooks: 41 across 12 repos (3 unbounded scope)
→ mcp servers: 8 (1 with token in env)
→ rule conflicts: 11 (1 high · 4 medium · 6 low)

report → ./scan-2026-04-21.md

What it surfaces

CLAUDE.md hierarchy

Every level. Global, project, subdirectory. Resolution order.

Rule conflicts

Pairs of rules with opposite postures reaching the same session.

Hooks

What runs on what events. Scope of side effects. Reversibility.

MCP servers

Tools, transports, secrets in env, network reach.

Agents · skills · slash commands

What gets autoloaded. What hasn't been touched in 90 days.

Stale references

Skills, agents and commands referencing things that no longer exist.

What it doesn't do

—phone home
—send anything to a server
—mutate a single file
—require an account
—depend on Anthropic infrastructure