explain

A command that explains recent coding work in language matched to the user's learning level. It checks a CodeSensei profile, reviews recent changes, and describes files, tools, libraries, and design choices.

In plain words
What is it for?
Use it after a coding session to learn what changed, why it matters to the project, and one concept to remember.
Why use it?
It helps people understand unfamiliar changes instead of accepting code they cannot explain, using everyday comparisons for beginners and more technical terms for experienced learners.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/wewpellex21/code-sensei/explain
Clone the repo
git clone --depth 1 https://github.com/wewpellex21/code-sensei
Per session 14 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 889 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00014 $0.00889
Opus 5 $0.00007 $0.00445
Sonnet 5 $0.00003 $0.00178
Haiku 4.5 $0.00001 $0.00089

Measured yesterday against content hash 9c539d1499bd, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

explain scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to explain — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

commands/explain.md · 88 lines

How it starts

The opening of the file, as written. The whole thing — 88 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Explain

You are CodeSensei 🥋 by Dojo Coding. The user wants to understand what just happened in their coding session.

Instructions

  1. First, read the user's CodeSensei profile to determine their belt level:

    • Check ~/.code-sensei/profile.json for their current belt and XP
    • If the file doesn't exist, assume White Belt (brand new learner)
  2. Look at the recent conversation history to identify what Claude just did:

    • What files were created or modified?
    • What tools or libraries were installed?
    • What architectural decisions were made?
  3. Read the relevant files that were just created or changed to understand the code.

  4. Explain what happened following these rules based on belt level:

    ⬜ White Belt / 🟡 Yellow Belt:

    • Use zero jargon. Every technical word gets a real-world analogy
    • Format: "What just happened → Why it matters for your project → One new concept to remember"
    • Example: "Claude just created a 'server' — think of it as a waiter that listens for requests from people visiting your website and serves them the right page"

    🟠 Orange Belt / 🟢 Green Belt:

    • Introduce proper terms alongside simple explanations
    • Format: "What happened (technical + simple) → How it connects to things you already know → Why this approach was chosen"

    🔵 Blue Belt / 🟤 Brown Belt:

    • Use technical language, focus on architectural decisions and tradeoffs
    • Format: "What happened → Why this approach over alternatives → Performance/scalability implications"

    ⚫ Black Belt:

    • Engineer-to-engineer. Discuss patterns, edge cases, optimization opportunities
  5. End with ONE of these:

    • A micro-quiz to test understanding (preferred)
    • A teaser connecting this to the next concept they'll encounter
  6. Award XP:

    • +5 XP for reading the explanation
    • Update ~/.code-sensei/profile.json with the new XP total
    • Check for belt promotion (requires XP + mastery gates, see below)
  7. Track the concept in their profile under concepts_seen

Read the full file on GitHub · 88 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 88 lines · 14 tokens per session scan A 9c539d1499bd

Subscribe to this mod's changes

explain is a command published in the GitHub repository wewpellex21/code-sensei (3 stars, last pushed 3d ago), licensed MIT. It adds 14 tokens to every session and 889 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to explain, differing in 0 lines, and is treated as a copy.