explain

Code Explain Command

Explain code structure, business logic, data flows, and architecture patterns for any scope — from a single file to an entire project, HTTP route, or console command.

Input Parsing

Parse $ARGUMENTS to extract input, mode, and optional meta-instructions:

Format: <input> [mode] [-- instructions]

Arguments:
- input: File, directory, ".", HTTP route, or console command (required)
- mode: quick|deep|onboarding|business|qa (optional, auto-detected)
- -- instructions: Focus area or specific question (optional)

Input types (auto-detected):
1. HTTP route:    GET /api/orders
2. HTTP route:    POST /api/orders/{id}/status
3. Console cmd:   app:process-payments
4. Console cmd:   import:products
5. File path:     src/Domain/Order/Order.php
6. Directory:     src/Domain/Order/
7. Project root:  .

Examples:
- /acc:explain GET /api/orders
- /acc:explain POST /api/orders/{id}/status deep
- /acc:explain app:process-payments
- /acc:explain import:products -- explain data transformation pipeline
- /acc:explain src/Domain/Order/Order.php
- /acc:explain src/Domain/Order/
- /acc:explain . onboarding
- /acc:explain src/Payment business
- /acc:explain src/Domain/Order/ deep -- focus on state transitions
- /acc:explain . qa -- how does payment processing work?

Parsing rules:

1. Split $ARGUMENTS by -- (space-dash-dash-space)
2. First part = input + optional mode, Second part = meta-instructions
3. Check if last word of first part is a valid mode (quick|deep|onboarding|business|qa)
4. If valid mode found, extract it; everything else is the input
5. If no mode specified, auto-detect based on input type

Input Type Detection

Before path validation, detect input type from the parsed input:

1. If input matches ^(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s+/ → input_type = "route"
2. If input matches ^[a-z][a-z0-9_-]*:[a-z][a-z0-9:_-]*$ → input_type = "command"
3. If test -f input → input_type = "file"
4. If test -d input → input_type = "directory"
5. If input = "." → input_type = "project"
6. Otherwise → report error: "Invalid input. Provide a file/directory path, HTTP route (GET /path), or console command (namespace:name)."