By name: explain-code description: Explain a file or function with analogies and ASCII diagrams allowed-tools: Read, Grep, Glob
Explain the code specified in $ARGUMENTS. The argument can be a file path, a function name, or a class name.
Structure your explanation like this:
- One-liner: What does this code do in one sentence?
- Analogy: Explain the core concept using a real-world analogy.
- ASCII diagram: Draw a simple ASCII diagram showing the flow or structure (data flow, call graph, state machine, etc. — pick whatever fits best).
- Step-by-step walkthrough: Walk through the code in logical order, explaining each key section.
- Gotchas: Call out anything surprising, tricky, or easy to misunderstand.
If $ARGUMENTS is empty, ask the user what they'd like explained.
Keep the explanation accessible — assume the reader is familiar with programming but not this specific codebase.