By drannarosen
The course author's AI toolkit for Sophie. Brainstorm, design, author, review, and run governed course revisions with an AI collaborator you supervise. Includes two explicit instructor approval gates, source-grounded evidence, semantic review, and an immutable revision record.
Design or restructure a course or module with the Sophie course-design (Mode-A) skill — audit-first backward design, emitting a course-spec + LO-graph + prose outline.
Brainstorm how to teach a topic with the Sophie design partner — a patient, generative, Socratic pedagogy collaborator that explores ideas before committing and converges only when you say you're ready.
Draft a practice set for a section from a Sophie practice-set packet, then self-review and present a reviewable diff.
Draft or revise a reading for a unit from a Sophie reading packet, then self-review and present a reviewable draft.
Review a unit's reading against the Sophie evidence-based pedagogy rubric, separating the deterministic floor from quality-ceiling judgments.
Use when introducing an abstract concept and you want students to build intuition — grounds the abstraction in multiple, varied, structurally-matched real-world examples (not one, not surface-similar) and fades from concrete to abstract so the idea transfers. The fifth of the six evidence-based learning strategies.
Use when designing or restructuring a course or module — the strategic Mode-A front of the authoring funnel. Drives backward design as a ONE-move-at-a-time conversation — audit the existing course first (brownfield), derive outcomes → evidence → content, then emit a course-spec.yaml + pedagogy/lo-graph.yaml (validated by LoGraphSchema) + a prose outline. Holds the line under "just give me the lecture list" pressure by naming the content-first tradeoff instead of dumping a curriculum. Composes evidence-based-pedagogy; hands LOs to the reading/practice authors. Platform skill; the course adds voice + domain data.
Use when a concept is served by a diagram and you're pairing a visual with prose — pairs COMPLEMENTARY verbal + visual representations of the same idea (Paivio's two channels; Mayer's multimedia principles — contiguity, coherence, redundancy-avoidance, signaling), not decorative or redundant images. Composes figure-authoring for figure quality. NOT learning styles.
Use when authoring explanations, reveals, or reflection prompts — prompts students to generate the "why" themselves (self-explanation, elaborative interrogation) instead of writing the reasoning for them, and upgrades predict-then-check into predict-then-explain.
Use when presenting a governing equation or key relationship in a reading or lesson — enforces unpacking every symbol with BOTH meaning AND units, an explicit dimensional check, connecting the equation to an observable, and reading its structure (exponents/scaling); decides <KeyEquation> registry vs inline math and defers mechanics to the component reference.
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Status: active development. Sophie is being built openly but is not yet ready for external use. APIs, package layout, and content schemas are changing rapidly. There is no published
@sophie/*package yet.
Sophie is a schema-driven, AI-authorable platform for interactive scientific
textbooks, course websites, slide decks, and LMS exports — modeled on MyST and
Quarto, designed as a standalone, distributable platform. The platform code
lives in this repo (@sophie/* packages); course content lives in separate
consumer repositories that depend on @sophie/*.
The architectural decisions, design rationale, and roadmap live in
docs/website/ as a MyST site. To run
the docs site locally:
cd docs/website
npx mystmd start # http://localhost:3000
Read AGENTS.md and its CLAUDE.md entrypoint
before working in this repo. They capture the human-in-the-loop mandate,
the active architectural decisions —
see docs/website/decisions/ for the current
catalog), the conventions, and the working style.
Sophie is in the post-Phase-0 vertical-slice state: seven @sophie/*
packages ship (core, packets, components, astro, slides, cli,
theme). lesson.mdx is the authored lesson authority; annotated lessons can
project into accessible Reading and Slides routes with Review, Prepare,
Present, and Print modes from the same compiled semantic sequence.
The platform-owned target at examples/smoke/ is a compact integration
fixture; the separate sibling ../astr201/ repository is the first-class
pilot consumer and public GitHub Pages course. CI runs typecheck, unit,
lint, e2e, Storybook, and visual-regression gates on every PR. See
docs/website/decisions/0033-ai-optimized-engineering.md
for the build-order decision,
docs/website/project/development-roadmap.md for
the current priorities and delivery boundaries.
Use Node 24 (.nvmrc) and pnpm 11.0.9 (packageManager). The root commands
are the supported repository gates:
pnpm install --frozen-lockfile
pnpm build
pnpm typecheck
pnpm test:unit
pnpm test:e2e
pnpm storybook
pnpm exec turbo run build-storybook --filter=@sophie/components
pnpm storybook starts the component-development server. The static
Storybook build is the CI artifact; browser-testing that artifact also
requires serving packages/components/storybook-static/ before running
pnpm --filter @sophie/components test:storybook.
Sophie is released under the GNU Affero General Public License v3.0 (or later). The AGPL preserves Sophie as truly open source while preventing closed-source commercial forks via its copyleft and network-use clauses; rationale is documented in ADR 0019.
Textbook content authored using Sophie lives in separate consumer repositories and is licensed independently (the recommended content license is CC BY-NC-SA 4.0 — see roadmap).
npx claudepluginhub drannarosen/sophie --plugin sophieDomain-agnostic research-coding workflow discipline for computational science (JAX/Python research family). 70 skills across ideate / literature / scope / build-correctly / equation-critical sources / verify / inference-rigor / review / performance-and-scale / record / communicate / reproduce-and-release, plus an equation-verifier agent and six slash commands. v1.4.x–1.5.0 adds a true front-of-funnel (research ideation + brainstorming + prior-art + literature discipline), Bayesian/statistical inference rigor (MCMC convergence, predictive checks, model selection), HPC performance & scale (profiling, scaling, JAX performance, cluster-run contract), software/data release & citation (CITATION.cff/DOI, release checklist, data management plans), and a figure craft & interpretation layer (expert astrophysics plotting in a house style, plot-craft review, and figure-interpretation guarding). The suite covers evidence-first execution, numerical validation, reproducibility, PDF equation extraction, equation-to-code traceability, reference-license firewalls, computational-physics code review, figure faithfulness, MyST documentation authoring, eight self-limiting enforcement hooks, and per-domain lenses for reference-parity work.
Harness-native ECC plugin for engineering teams - 67 agents, 279 skills, 94 legacy command shims, reusable hooks, rules, MCP conventions, and operator workflows for Claude Code plus adjacent agent harnesses
Consult multiple AI coding agents (Gemini, OpenAI, Grok, Perplexity, plus codex, antigravity, and grok CLIs when installed) to get diverse perspectives on coding problems
v9.54.1 — Reliability wave: tangle contextual review correction loop with hard round ceiling, progress-supervised review rounds (per-agent stall watch, descendant-tree kills), council diversity and agy pin fixes, marketplace generator source-of-truth fix, provider troubleshooting runbook and cost-expectations docs. Run /octo:setup.
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Comprehensive startup business analysis with market sizing (TAM/SAM/SOM), financial modeling, team planning, and strategic research