Explain

---
name: explain
description: Use when technical agent output needs beginner-friendly translation without losing exact details.
---

# Explain

## Purpose

Translate technical agent output into beginner-friendly language while preserving
the exact file paths, commands, errors, and decisions the user needs.

## When to Use

Use when output from an agent, terminal, test run, error message, pull request,
or implementation plan is too technical for the user to act on confidently.

## Workflow

1. Identify the source: name the command, file, diff, error, or agent message
   being explained.
2. Preserve exact details: keep file paths, commands, package names, versions,
   error text, and config keys unchanged.
3. Translate jargon: explain unfamiliar terms in beginner language.
4. Separate facts from interpretation: clearly label what the output proves,
   what it suggests, and what remains unknown.
5. Explain impact: state whether the issue blocks progress, is safe to ignore,
   or needs a specific action.
6. Give the next safe action: provide one concrete prompt or command the user
   can run next.
7. Modo Aprendiz: for the MOST confusing concept in the output, include three
   sub-fields in beginner-friendly Spanish:
   - Qué significa: what the concept means in plain language.
   - Por qué importa: why it matters for the project.
   - Qué hacer ahora: one concrete action to take now.

## Output

A beginner explanation containing:
- Plain version: the short explanation in non-technical language
- Exact details: file paths, commands, or error lines that must not be changed
- Why it matters: the practical impact
- Modo Aprendiz: the most confusing concept with Qué significa, Por qué importa, and Qué hacer ahora
- Next safe step: one prompt or command to run next