explainlisted

## Intent Generate a clear, structured explanation of a topic, decision, or concept tailored to the audience level. Include explicit assumptions, causal reasoning, and supporting evidence. **Success criteria:** - Explanation is clear and understandable by target audience - Assumptions are explicitly stated - Causal chain shows logical progression - Evidence supports key claims - No unnecessary jargon or fluff **Compatible schemas:** - `schemas/output_schema.yaml` ## Inputs | Parameter | Required | Type | Description | |-----------|----------|------|-------------| | `topic` | Yes | string or object | What to explain (concept, decision, code, etc.) | | `audience_level` | No | string | beginner, intermediate, expert (default: intermediate) | | `format` | No | string | prose, bullets, structured, diagram (default: structured) | | `focus` | No | string | Specific aspect to emphasize | | `max_length` | No | string | Length constraint (brief, standard, detailed) | ## Procedure 1) **Analyze the topic**: Understand what needs explaining - Identify the core concept or decision - Note the complexity level - Determine what background is needed - Identify potential confusion points 2) **Assess audience**: Calibrate explanation depth - Beginner: Define all terms, use analogies - Intermediate: Assume basic knowledge, focus on key points - Expert: Technical depth, skip fundamentals 3) **Extract key concepts**: Identify essential elements - Core idea or decisi