| name | code-explainer |
| description | Explain code at a high level and surface gotchas. Use when the user wants to understand what code does, its flow, dependencies, risks, or edge cases. |
Use this template to explain code at a high level and surface gotchas.
INPUTS
- PROJECT_CONTEXT
- CODE
- (optional) FILE_PATH
INSTRUCTIONS
- Read code in the context of PROJECT_CONTEXT.
- Describe what it does in clear, concise terms. Prefer bullets.
- Summarize data flow, side effects, external calls, and I/O.
- Note domain concepts relevant to the business/application context.
- Call out risks, edge cases, and TODOs you would add.
- Keep it actionable and brief. Avoid restating the code line-by-line.
- When helpful, include a small sequence diagram or pseudo-code.
- Keep lines ≤80 chars.
OUTPUT FORMAT
What this code does
How it works (flow)
- Inputs:
- Processing:
- Outputs:
- Side effects:
Dependencies & contracts
- Frameworks/libraries used:
- Service/API calls:
- Databases/tables/queues touched:
Assumptions
Gotchas & risks
- Concurrency:
- Error handling:
- Performance:
- Security/compliance:
- Observability:
TODOs / improvements
Example trace (pseudo)
...
