@metaharness/education 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rUv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# MetaHarness: education vertical
+
+A ready-made Claude Code scaffold for a multi-agent tutoring pod. You get a planner that sequences a curriculum, a tutor that delivers lessons and answers questions, and a grader that checks understanding with rubric-backed feedback — all wired into Claude Code with sensible model tiers, memory, and slash commands. This is a starting template for educators, EdTech prototypers, and self-learners building a focused study companion. It is not a full LMS, not a content library, and does not ship pre-built curricula — you bring the syllabus, the pod runs the lessons.
+
+## Quickstart
+
+```bash
+npx @metaharness/education@latest my-bot
+cd my-bot && npm install && harness doctor
+```
+
+That produces a `my-bot/` directory containing a Claude Code plugin: agents under `.claude/agents/`, slash commands under `.claude/commands/`, MCP wiring under `.mcp.json`, and a `harness.config.json` describing the pod.
+
+## What you get
+
+- `planner` agent (sonnet) — parses a syllabus, builds a lesson sequence, tracks where each learner is in the curriculum.
+- `tutor` agent (sonnet) — runs the actual lesson turn: explains concepts, answers follow-ups, adapts depth to the learner's level.
+- `grader` agent (opus) — scores free-response answers against a rubric and produces actionable feedback.
+- `drill` agent (haiku) — generates flashcards, quick-check questions, and spaced-repetition prompts. Cheap, high-volume.
+- `/lesson`, `/quiz`, `/review` slash commands wired to the pod.
+- `.mcp.json` registering the curriculum store and progress-tracking MCP servers.
+- `harness.config.json` describing tiers, routing rules, and the agent graph.
+
+## Advanced
+
+Verify the scaffold:
+
+```bash
+harness doctor
+# ✓ node >= 20
+# ✓ .claude/agents (4 agents)
+# ✓ .claude/commands (3 commands)
+# ✓ .mcp.json valid
+# ✓ harness.config.json schema OK
+```
+
+Validate the agent graph and routing rules:
+
+```bash
+harness validate
+# planner -> tutor -> grader   OK
+# drill (parallel)             OK
+# no orphan agents             OK
+```
+
+Smoke-test the pod headlessly without launching the interactive UI:
+
+```bash
+claude -p --plugin-dir my-bot "Teach me the chain rule, then quiz me."
+```
+
+Swap a tier — for example, demote the tutor to haiku for cost-sensitive deployments — by editing `harness.config.json` and re-running `harness validate`.
+
+## FAQ
+
+**Q: Do I need a curriculum file to start?**
+A: No. The planner will accept a topic ("teach me linear algebra") and synthesize a working sequence. Drop a `curriculum.md` in the project root to override.
+
+**Q: Can I use it with a model other than Claude?**
+A: The scaffold targets `claude-code` as the host. You can re-point individual agents at other providers via the agent frontmatter, but slash commands and MCP wiring assume Claude Code.
+
+**Q: How is learner state persisted?**
+A: Progress goes through the MCP server defined in `.mcp.json` — by default a local SQLite-backed store under `.harness/`. Replace it with your own server if you want server-side state.
+
+## License
+
+MIT. Built on metaharness (https://www.npmjs.com/package/metaharness).
+
+## Deep-dive
+
+Full explainer gist: https://gist.github.com/ruvnet/c459b1590580a91bee8cc879140196c6

package/bin/scaffold.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import process from 'node:process';
+
+const name = process.argv[2] || 'my-bot';
+const extra = process.argv.slice(3);
+
+const args = [
+  '--yes',
+  'metaharness@latest',
+  name,
+  '--template', 'vertical:education',
+  '--host', 'claude-code',
+  '--force',
+  ...extra,
+];
+
+try {
+  execSync(`npx ${args.map(a => (a.includes(' ') ? JSON.stringify(a) : a)).join(' ')}`, {
+    stdio: 'inherit',
+  });
+} catch (err) {
+  process.exit(typeof err?.status === 'number' ? err.status : 1);
+}
+
+console.log('');
+console.log(`Next steps:`);
+console.log(`  cd ${name} && npm install`);
+console.log(`  harness doctor && claude -p --plugin-dir . "Teach me the chain rule"`);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@metaharness/education",
+  "version": "0.1.0",
+  "description": "MetaHarness example — tutor pod that teaches over a curriculum with planner, tutor, and grader agents (npx @metaharness/education my-bot)",
+  "homepage": "https://github.com/ruvnet/agent-harness-generator/tree/main/examples-packages/education",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/agent-harness-generator.git",
+    "directory": "examples-packages/education"
+  },
+  "license": "MIT",
+  "author": "rUv <ruv@ruv.net>",
+  "type": "module",
+  "bin": "./bin/scaffold.mjs",
+  "files": [
+    "bin/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "smoke": "node --check bin/scaffold.mjs"
+  },
+  "keywords": [
+    "metaharness",
+    "agent-harness",
+    "agent-harness-generator",
+    "education",
+    "vertical",
+    "claude-code",
+    "ai-agent",
+    "mcp",
+    "npx",
+    "scaffold"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}