feat(teach): add multi-session learning-coach plugin

.claude-plugin/marketplace.json

@@ -222,6 +222,12 @@
       "source": "./plugins/codebase-audit",
       "category": "quality",
       "tags": ["audit", "drift", "documentation", "configuration", "architecture", "verification", "claims", "skill"]
+    },
+    {
+      "name": "teach",
+      "source": "./plugins/teach",
+      "category": "learning",
+      "tags": ["teach", "learn", "learning", "coach", "tutor", "pedagogy", "primer", "onboarding", "skill"]
     }
   ]
 }

README.md

@@ -55,6 +55,7 @@ Browse and manage with `/plugin`. To refresh after updates: `/plugin marketplace
 | [`review-toolkit`](plugins/review-toolkit) | Agents + Skills | Code-review toolkit: six read-only reviewer agents (code quality, security, architecture, doc drift, build/test/lint, CI-log audit) plus two orchestration skills — `/review-toolkit:quality-gate` (single-lens checkpoint with eight modes) and `/review-toolkit:code-review-fanout` (multi-surface fan-out normalized into one severity-ranked findings report, with a findings-driven fix pass). |
 | [`implementation`](plugins/implementation) | Skills | Implementation-stage toolkit of ten skills: `implement` / `implement-dispatch` (inline vs orchestrated plan execution with TDD cadence, divergence detection, and phase-boundary handoffs), `build` / `lint` (polyglot ecosystem-detecting verification with consumer-convention overrides), `test-write` / `test-plan` / `test-diagnose` / `test-e2e` (authoring, coverage-gap analysis, failure diagnosis, live E2E evidence), and `verify-changes` / `verify-improvement` (outcome verification and baseline-vs-after improvement measurement). |
 | [`codebase-audit`](plugins/codebase-audit) | Skills | Repo-wide drift audit that verifies a codebase's factual claims against reality: `/codebase-audit:codebase-audit` runs an eight-phase per-file subagent fan-out over configurable documentation/configuration/code-quality/architecture dimensions, independently validates each finding, and fixes or reports in a severity-rated table; `/codebase-audit:setup` interviews and writes the tracked `.claude/codebase-audit.md` audit-target config. |
+| [`teach`](plugins/teach) | Skill | Interactive multi-session learning coach. `/teach:teach topic` learns a general subject from external high-trust sources, `/teach:teach codebase` learns a concept grounded in the repo it is launched from (discovering that repo's own docs and source at teach-time), and `/teach:teach primer` gives a single-session domain vocabulary primer. Coaches through a Knowledge → Skills → Wisdom progression with persistent per-topic learning state under `${CLAUDE_PLUGIN_DATA}`. |
 
 Install one: `/plugin install <plugin-name>@melodic-software`.
 

plugins/teach/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": "teach",
+  "version": "0.1.0",
+  "description": "Interactive multi-session learning coach: teaches a general subject or a concept grounded in the consuming repo through the Knowledge-Skills-Wisdom progression, with persistent per-topic learning state. Also a single-session domain primer.",
+  "author": {
+    "name": "Melodic Software",
+    "email": "info@melodicsoftware.com"
+  },
+  "license": "MIT",
+  "keywords": ["teach", "learn", "learning", "coach", "tutor", "pedagogy", "primer", "onboarding", "skill"]
+}

plugins/teach/README.md

@@ -0,0 +1,63 @@
+# teach
+
+A Claude Code plugin that coaches you through learning a subject — across
+multiple sessions — instead of lecturing at you. It runs a
+**Knowledge → Skills → Wisdom** progression grounded in your real goal, and keeps
+persistent per-topic learning state so each session builds on the last.
+
+Invoke it with `/teach:teach` and an action, for example
+`/teach:teach topic rust-ownership`, `/teach:teach codebase auth-flow`, or
+`/teach:teach primer color-grading`.
+
+## What it does
+
+- **`topic <subject>`** — learn a general subject from external high-trust
+  sources (books, courses, docs, communities).
+- **`codebase <concept>`** — learn a concept grounded in the repository you launch
+  it from. It discovers the repo's own docs, conventions, and source at teach-time
+  and teaches from what it finds — nothing about the project is assumed.
+- **`primer <domain>`** — a single-session vocabulary primer for an unfamiliar
+  domain, so you can prompt or direct work in it precisely. No workspace.
+- Supporting actions: `mission`, `glossary`, `resources`, `explain`, `exercise`,
+  `assess`, `resume`, `status`.
+
+The coach asks questions before giving answers, teaches just beyond your current
+level (the zone of proximal development), and grounds every claim in a source
+fetched or a file read that session rather than from memory.
+
+## How it works
+
+Each topic gets a **workspace** — a mission (why you're learning this), a glossary,
+curated resources, and per-concept slices (a lesson, a durable reference
+cheat-sheet, and optional practice). All of it persists under
+`${CLAUDE_PLUGIN_DATA}`, which survives plugin updates and stays out of your
+project's tree, so you can resume a topic weeks later. Durable references are
+re-verified lazily on revisit (age × domain-velocity) so stale facts get refreshed
+before they're taught. See the skill body for the full pedagogy.
+
+## Requirements
+
+- None beyond Claude Code. For `codebase` mode, launch it from the repository you
+  want to learn — the plugin reads that repo's own docs and source.
+- `topic` mode fetches documentation URLs to ground explanations in primary
+  sources; if your setup restricts `WebFetch`, allow it or seed `RESOURCES.md`
+  manually.
+
+## Install
+
+```shell
+/plugin marketplace add melodic-software/claude-code-plugins
+/plugin install teach@melodic-software
+```
+
+## Configuration
+
+This plugin has no `userConfig`. Everything it needs comes from the action you
+invoke, and its cross-session learning state persists automatically under
+`${CLAUDE_PLUGIN_DATA}`. There is nothing to configure and nothing to edit in the
+plugin itself.
+
+## License
+
+MIT (SPDX-License-Identifier: MIT). See the LICENSE file at the root of the
+melodic-software/claude-code-plugins repository.