x-cmd Quick Scanner
Trigger
Use when:
- User says
/scan - User wants a quick health check
- Time-constrained review needed
Do NOT use when:
- User wants exhaustive check (use
/check) - User wants full assessment (use
/assess)
Steps
Step 1: Parse Arguments
/scan [--ruleset <dir>] [target_root]
Default: current directory.
Step 2: Load Rules
x rule which
ls $ruleset_dir/*.yml
cat $ruleset_dir/*.yml
Step 3: Greedy Scan
Strategy:
- Do NOT check every file against every rule
- Find the 1-5 most obvious, most severe violations
- Trust first instinct
- Speed over completeness
- Stop early when 1-5 critical issues found
Step 4: Output Results
Output Format
TSV with header:
root target ruleid score hint
If nothing obviously wrong: output header row only.
Constraints
- Maximum 5 issues reported
- Stop after finding 5 or when no obvious issues remain
- Do NOT do exhaustive analysis