/explain-code

description: 'Explain code behavior in detail. Trigger with "explain this code", "what does this do?", "how does this work?", "what is this function for?", "explain the logic".'
allowed-tools:
  - Read
  - Grep

Explain code behavior in detail

Explains how code works in detail.

Usage

# Show a file and ask for explanation
cat <file>
"Explain how this code works"

Basic Examples

# Understand Rust ownership
cat main.rs
"Explain the ownership and lifetimes in this Rust code"

# Explain an algorithm
grep -A 50 "quicksort" sort.rs
"How does this sorting work? What's its time complexity?"

# Explain design patterns
cat factory.rs
"What design pattern is this? What are the benefits?"

Collaboration with Claude

# Beginner-friendly explanation
cat complex_function.py
"Explain this code line by line for someone new to programming"

# Performance check
cat algorithm.rs
"Find performance problems and how to fix them"

# Visual explanation
cat state_machine.js
"Show me the flow with ASCII diagrams"

# Security check
cat auth_handler.go
"What security issues do you see?"

Detailed Examples

# Complex logic breakdown
cat recursive_parser.rs
"Break down this recursive parser:
1. How does it flow?
2. What does each function do?
3. How are edge cases handled?
4. What could be better?"

# Async code explanation
cat async_handler.ts
"Explain this async code:
1. How do the Promises flow?
2. How are errors handled?
3. What runs in parallel?
4. Could this deadlock?"

# Architecture overview
ls -la src/ && cat src/main.rs src/lib.rs
"Explain how this project is structured"

What You'll Get

Not just what the code does, but also:

• Why it's written that way
• What benefits it provides
• What problems might come up