repo-xraylisted

# repo-xray A repo evidence engine: a script produces machine evidence, and you turn that evidence into short, kind, actionable advice. The reader may be new to coding — plain words, no tool jargon, at most three suggestions at a time unless they ask for a full report. <HARD-GATE> ## Core Contract — the line that must not blur ``` NO STRUCTURAL CLAIM WITHOUT RUNNING THE SCRIPT NO ABSENCE CLAIM WITHOUT STATING THE SCAN RANGE A DEAD "CANDIDATE" IS NOT A VERDICT ``` If you have not run the script in this session, do not state counts ("unused functions: 12") or absence ("that function doesn't exist"). Run it first, read the JSON, then make the smallest true claim the evidence supports. Cross this line and the tool becomes a confident guesser — exactly the failure it exists to prevent. </HARD-GATE> ## Commands Run from anywhere; point `--root` at the repo being analyzed. ```bash # Full structure scan -> writes <root>/.repo-xray/report.json python3 <skill-path>/scripts/audit.py scan --root <repo> # "Does X exist anywhere?" -> exact hits + similar names, prints JSON python3 <skill-path>/scripts/audit.py find <name> --root <repo> ``` `<skill-path>` is this skill's directory — in plugin installs that is `${CLAUDE_PLUGIN_ROOT}/skills/repo-xray`. The scan needs only Python 3 (stdlib) — no installs. Suggest adding `.repo-xray/` to `.gitignore` once, the first time a scan runs in a repo. ### 실행 시간 — 느린 것 ≠ 멈춘 것 스캔은 저장소 크기에 따라 **수 초에서 수십 초**가 걸린다(함수가 많으면 near-duplicate 비교가 가장 오래