Back to Commands

explain

Analyze code and explain concepts in your repository. Perfect for understanding unfamiliar code or onboarding new team members.

Syntax

@Smart Workflow explain <topic>
@Smart Workflow explain <repo> <topic>
@Smart Workflow in <repo> explain <topic>

Examples

Explain a concept
@Smart Workflow explain how the authentication flow works
Explain database schema
@Smart Workflow explain the database schema
Target a specific repository
@Smart Workflow in api-service explain the middleware chain
Alternative repo syntax
@Smart Workflow explain landing-page what is the purpose of this component

How it works

1

Reads relevant files

Smart Workflow searches your repository to find files related to your question.

2

Analyzes code structure

Claude examines the code patterns, dependencies, and data flow.

3

Provides explanation

Returns a clear explanation with code references and diagrams when helpful.

Best for

Understanding unfamiliar code

Quickly get up to speed on code you didn't write.

Onboarding new team members

Help new developers understand your codebase.

Documenting features

Generate explanations for how features work.

💡 Pro Tips

  • Be specific—ask about particular functions, files, or features
  • Follow up in the same thread to dive deeper into specific parts
  • Use --model haiku for quick, simple explanations