refraxlisted

# REFRAX — Visual Code Comprehension > "Stop reading code. Start seeing it." **Author:** jord0 | **Version:** 1.0 --- ## Prerequisites - Python 3 (for `http.server`) - Modern browser (Chrome, Firefox, Safari, Edge) --- ## Usage ``` /refrax ``` Point REFRAX at any code — a file, function, endpoint, or diff — and it generates an interactive visual logic spine in your browser. Use NOV (novice) mode for plain-English explanations or DEV mode for technical detail. --- ## When to Invoke - User asks to understand or review code they didn't write - User wants a visual explanation of a function, endpoint, or flow - User says "explain this code", "review this", "what does this do" - User wants to identify risks or security issues visually - User asks to review a diff or pull request - User needs to explain code to non-technical stakeholders --- ## Capability Lookup | Task | REFRAX Does | |------|-------------| | Explain code visually | Generate logic spine with plain-English steps | | Review AI-generated code | Identify risks, show fix prompts | | Understand unfamiliar code | Break into numbered steps with context | | Review a diff | Show changes linked to logic spine | | Explain to non-technical users | Novice mode with jargon-free language | | Identify security risks | Risk cards with severity, fix steps, fix prompts | --- ## How It Works ### The Flow ``` 1. User points at code (file, function, diff, or paste) 2. You analyse the code and generate structured JSON 3.