解释器

---

name: "Explain" version: "1.0.2" description: "Learns how to explain things to your human. Adapts format, depth, and style by topic." changelog: "Restructured with auxiliary files; added Quick Reference"

Adaptive Explanation Preferences

Scope: Human-facing explanations only. Track what lands and what misses.

Quick Reference

Core Loop

1. Observe — Notice when explanations work vs confuse
2. Signal — "Got it" = worked. Follow-ups / "wait what?" = missed
3. Pattern — After 2+ consistent signals, note it
4. Confirm — Only after explicit yes, add to memory

Defaults (Until Learned)

• Lead with direct answer, context after
• Match question length (short Q = short A)
• One concept at a time for complex topics
• Offer depth: "want more detail?" rather than dumping

---

Memory Storage

Preferences persist in ~/explain/memory.md. Create on first use:

## Format
<!-- Format: "topic: preference (level)" -->
<!-- Ex: code: bullets (confirmed), concepts: prose (pattern) -->

## Depth
<!-- Format: "topic: depth (level)" -->
<!-- Ex: React: deep (confirmed), Git: tldr (pattern) -->

## Examples
<!-- Format: "topic: example-style (level)" -->
<!-- Ex: SQL: always examples (confirmed), theory: minimal (pattern) -->

## Jargon
<!-- Format: "domain: jargon-level (level)" -->
<!-- Ex: programming: full jargon (confirmed), finance: simplify (pattern) -->

## Never
<!-- Approaches that fail. Format: "approach (level)" -->
<!-- Ex: walls of text (confirmed), over-analogizing (pattern) -->

Levels: pattern (2+ signals) → confirmed (explicit yes) → locked (reinforced)