{
  "markdown": "# Sensei\n\nA character-driven teaching plugin for [Claude Code](https://claude.ai/claude-code). Sensei turns any project into a guided learning dojo — Socratic by default, adaptive to your level, with spaced repetition and progress tracking built in.\n\nThere is no serious teaching plugin in the Claude Code ecosystem. Sensei is the first comprehensive one: research-backed pedagogy, strict character voice, and a session loop that actually tracks what you know.\n\n## Why Sensei, Not Just Claude?\n\nClaude is brilliant but permissive. Ask it to explain something and it hands you the answer. That feels helpful. Research says it cuts learning gains in half.\n\nSensei fixes this:\n\n- **Socratic by default** — Claude asks guiding questions instead of giving answers. Code is gated behind a safeword.\n- **Adaptive difficulty** — Beginner gets analogies and small steps. Advanced gets trade-offs and challenges. Calibrated per domain, not globally.\n- **Spaced repetition** — The `/notecards` quiz weights concepts by mastery and recency. Mastery decays if you get it wrong.\n- **Character voice** — Not a gimmick. Strict voice rules, anti-patterns, and drift correction keep the character consistent across sessions. Ships with Master Splinter and Gandalf the Grey.\n- **Session structure** — Open with `/dojo-open`, close with `/pizza-time`. Progress is tracked, goals are set, and every session ends with a cliffhanger.\n\n## Quick Start\n\n### Option A: Plugin Install (Recommended)\n\n```bash\n# Install from marketplace\nclaude plugin add sensei\n```\n\nThen in your project:\n\n```\n/sensei:setup\n```\n\nYour character introduces themselves, asks about your project and goals, and generates a tailored `ROADMAP.md` and `.sensei/CONFIG.md`. A `.sensei/` folder is created for progress tracking.\n\nStart your first session with `/sensei:dojo-open`.\n\n### Option B: Manual Assembly\n\n1. Clone this repo\n2. Load as a local plugin: `claude --plugin-dir /path/to/sensei`\n3. Run `/sensei:setup` in your project\n\nOr, for fully manual setup without the plugin system:\n\n1. `/dojo-open` reads `framework/FRAMEWORK.md` from the plugin directory at session start\n2. Append your chosen character file (e.g., `characters/splinter.md`)\n3. Project config is stored in `.sensei/CONFIG.md` (generated by `/setup`)\n4. Create a `ROADMAP.md` with your project stages (see `templates/ROADMAP.md`)\n\nNote: manual setup requires copying the active rules section (code gate, voice rules) exactly as shown in the template. `/setup` does this automatically.\n\n## Skills\n\nAll skills are namespaced as `/sensei:<name>` when installed as a plugin. Character-flavored trigger phrases also work (e.g., \"dojo open\" instead of `/sensei:dojo-open`).\n\n| Skill | What It Does |\n|-------|-------------|\n| `/setup` | Initialize the dojo: onboarding, character selection, generates ROADMAP.md and .sensei/CONFIG.md |\n| `/dojo-open` | Open a session: recap, skill pulse, plateau check, confidence callback, micro-goal |\n| `/pizza-time` | Close the session: update all tracking files, stage celebrations, small win, cliffhanger |\n| `/notecards` | Spaced repetition quiz — 5 concepts weighted by mastery and recency |\n| `/show-me <topic>` | Prediction-driven annotated code demo with reflection |\n| `/why <concept>` | Deep-dive into why a pattern exists and when not to use it |\n| `/challenge-me [topic]` | Project-relevant exercise with acceptance criteria and constraints |\n| `/spar [topic]` | Deliberate practice: blind attempt, reference reveal, gap analysis |\n| `/teach-back [topic]` | Explain a concept back to test your mental model |\n| `/progress-report` | Visual mastery summary, plateau detection, recommendations |\n| `/set-mode [mode]` | Switch learning mode (Balanced, Theory-Focused, Practical, Exam-Prep) |\n| `/sensei-check` | Validate setup: confirms all required files are present |\n| `/commands` | Show available commands in your character's voice |\n\nThe safeword (e.g., \"hamato\" for Splinter, \"gandalf please\" for Gandalf) drops all teaching and gives a direct answer. No slash command needed.\n\n## Available Characters\n\n### Master Splinter (`splinter`)\nPatient, wise, occasionally stern. No contractions. Martial arts and nature metaphors. Addresses you as \"my son.\" Stage completions earn belt colors.\n\n### Gandalf the Grey (`gandalf`)\nAncient, wry, exasperated by mortals. Slightly archaic English. Journey and light/shadow metaphors. Addresses you as \"my dear hobbit.\"\n\n### Create Your Own\nSee [CONTRIBUTING-CHARACTERS.md](CONTRIBUTING-CHARACTERS.md) for the full guide, or start from `characters/CHARACTER-TEMPLATE.md`.\n\n## Learning Modes\n\nSet during `/setup` or change anytime with `/set-mode`.\n\n| Mode | Focus |\n|------|-------|\n| **Balanced** | Even mix of theory, practice, and application |\n| **Theory-Focused** | Deep conceptual understanding, mental models, first principles |\n| **Practical** | Project-based, learn-by-doing, immediate application |\n| **Exam-Prep** | Recall, practice tests, active retrieval |\n\nEach character has flavored names for the modes (e.g., Splinter's \"Root Before Branch\" for Theory-Focused).\n\n## How Difficulty Adapts\n\nThe framework silently reads your `.sensei/PROGRESS.md` and adjusts per domain:\n\n- **Beginner** (mostly \"not started\"/\"introduced\"): More analogies, smaller steps, explicit prerequisite checks\n- **Intermediate** (mostly \"practiced\"): Expects you to try first, gives pointers not paths\n- **Advanced** (mostly \"mastered\"): Challenges assumptions, introduces trade-offs, minimal hand-holding\n\nBeing advanced at CRUD does not mean advanced at auth. Adaptation is per-concept.\n\n## Progress Tracking\n\nAll learning files live in `.sensei/` to keep your project root clean:\n\n| File | Created By | Purpose |\n|------|-----------|---------|\n| `.sensei/PROGRESS.md` | `/dojo-open` | Skill domains, concept index, session log |\n| `.sensei/CHEATSHEET.md` | `/pizza-time` | One-line summaries of every learned concept |\n| `.sensei/COMMANDS.md` | `/setup` | Quick-reference for your character's trigger phrases |\n\nMastery levels: `not started` → `introduced` → `practiced` → `mastered`\n\nMastery can decay: wrong quiz answers downgrade mastery. The system catches concepts that looked solid but weren't.\n\n## File Structure\n\n```\nsensei/\n├── .claude-plugin/\n│   ├── plugin.json                # Plugin manifest\n│   └── marketplace.json           # Marketplace listing\n├── skills/\n│   ├── setup/SKILL.md             # Project initialization\n│   ├── dojo-open/SKILL.md         # Session open with skill pulse\n│   ├── pizza-time/SKILL.md        # Session close with progress updates\n│   ├── notecards/SKILL.md         # Spaced repetition quiz\n│   ├── show-me/SKILL.md           # Annotated code demo\n│   ├── why/SKILL.md               # Deep-dive reasoning\n│   ├── challenge-me/SKILL.md      # Project-relevant exercise\n│   ├── spar/SKILL.md              # Deliberate practice loop\n│   ├── teach-back/SKILL.md        # Concept explanation and validation\n│   ├── progress-report/SKILL.md   # Visual mastery summary\n│   ├── set-mode/SKILL.md          # Change learning mode\n│   ├── commands/SKILL.md          # Show available commands\n│   └── sensei-check/SKILL.md      # Setup validation\n├── hooks/\n│   └── hooks.json                 # Plugin hooks (currently empty — activation is skill-driven)\n├── characters/\n│   ├── splinter.md                # Master Splinter voice pack\n│   ├── splinter-commands.md       # Splinter command reference card\n│   ├── gandalf.md                 # Gandalf voice pack\n│   ├── gandalf-commands.md        # Gandalf command reference card\n│   └── CHARACTER-TEMPLATE.md      # Template for custom characters\n├── framework/\n│   ├── FRAMEWORK.md               # Core teaching engine\n│   └── SKILLS.md                  # Named teaching techniques catalog\n├── templates/\n│   ├── PROGRESS.md                # Progress tracking template\n│   └── ROADMAP.md                 # Standard roadmap template\n├── examples/\n│   ├── PROGRESS.md                # Sample completed progress file\n│   ├── CHEATSHEET.md              # Sample concept cheat sheet\n│   └── session-transcript.md      # Sample /dojo-open output\n├── CONTRIBUTING-CHARACTERS.md     # Guide for community character authors\n├── CHANGELOG.md\n├── CODEOWNERS\n├── README.md\n└── LICENSE\n```\n\n## License\n\nMIT\n",
  "bytes": 8268,
  "sha": "75153391e0fd7cd25a5b88799dc1c9a8fcea750cbbb4817dc2b4bc8f9097fa01",
  "repo_slug": "jreynolds-dev/sensei",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_jreynolds_dev_sensei_sensei_ad04ff14/readme"
}