Concept Documentation Index

This page is the entry point for durable SkillPilot concepts. Keep implementation plans and migration workboards in docs/dev/; keep CI rules and review processes in docs/qa-ci/.

Foundations

• Glossary (EN) · Glossar (DE) · PDF (EN) · PDF (DE) Precise bilingual definitions of the core SkillPilot terms, with the normative source per term.
• Levels of Personalization (EN) · Ebenen der Personalisierung (DE) Product-level personalization model.
• Contentanbindung: Architekturrahmen (DE) · Content Integration (EN) Anbieterunabhängige optionale Contentpakete, getrennt von Curriculum und persönlicher Auswahl; verbindliche Konzeptgrundlage aus Issue #50.
• Curriculum-Qualität: QS-Reifegrade und menschliche Erprobung (DE) · English (EN) Abgestimmtes Zielkonzept für M7 als Abschluss der vertieften Curriculum-QS, getrennte Champion-Erprobungsstatus und eine einheitliche Grau-Grün-Reifeskala; Umsetzung offen.

Platform Strategy

• Architekturkonzept: SkillPilot mit austauschbarem MCP Host (DE) · Portable Agent Runtime Architecture (EN) Strategiekonzept für die Trennung von SkillPilot Core, austauschbarem MCP Host und austauschbarem Model Provider. Teil A ist die normative Architektur mit Zustands- und Datenschutzgrenzen, Abrechnungsmodell, Stufenplan und Abnahmetests; Teil B ist ein datierter Marktanhang zu den verfügbaren Hosts.

Skill Graph

• Skill Graph Overview Entry point for graph semantics, curriculum structure, and supporting contracts.
• SkillPilot Skill Graph Specification (§§1–5, EN) · Deutsch (DE) Core graph model and formal vocabulary.
• Context, Views, Scope and Goal Types (§§6–10, EN) · Deutsch (DE) Canonical graph vs. educational views, personal curriculum closure \(L=\mathrm{Closure}(S)\), understanding/memorisation/assessment goals, time and evidence boundaries.
• Assessment-Gated Completion and Global Mastery (§13, EN) · Deutsch (DE) Direct assessment access and globally effective mastery through independent application in valid local learning-unit assessments.
• Produktentscheidung: Beherrschung durch Verständnis und selbständige Anwendung Verbindliche Konzeptkorrektur vom 4. November 2026; Umsetzung und Prüfung bestehender Prüfungsverträge folgen.
• Learning Units (§§11.1–11.4, EN) · Deutsch (DE) Recursive units with a learning promise, subunits, application assessments and derived completion; acquired competence remains globally valid.
• Learning Unit Progression (§11.5, EN) · Deutsch (DE) Explicit dependencies between whole units, valid block ordering and the separate decision about recommended routes versus technical entry gates. The former unit-concept address and progression-concept address remain short compatibility pointers for existing links.
• Learning-Unit Design Criteria and Examples Purpose of a unit, criteria for meaningful boundaries and assessments, two worked candidates, and the unit validity rules R1–R5 of 11 November 2026.
• Optional Acquisition and Time Planning (§12, EN) · Deutsch (DE) Multi-period acquisition plans, structural prerequisite witnesses, and workload budgets.
• Graph Definition Compendium Appendices (B–F, EN) · Deutsch (DE) Current implementation status, verification strategy, glossary/symbols, sources, and single-source build reference.
• Architecture & Interchange Compendium PDF (EN) · Architektur- & Austausch-Kompendium PDF (DE) Unified single-source compendium covering the layered goal system, node types, view projection, source/content links, visualizations, GoalBook review pipeline, canonical Gymnasium rollout, MEM/FWU roundtrip, and dual curriculum package releases.
• General Goal System and Migration (EN) · Deutsch (DE) Long-term goal-system split and migration direction.
• Node Types (EN) · Deutsch (DE) Node semantics and classification.
• View Projection and Goal Placement (EN) · Deutsch (DE) Scope-specific learner-facing views and placement semantics.
• Source And Resource Links (EN) · Deutsch (DE) Provenance and source/reference semantics.
• Atomic Goal Visualizations (EN) · Deutsch (DE) Production pipeline and review rules for optional atomic-goal image assets.
• Human-Readable Source Rationales (EN) · Deutsch (DE) Generated explanation model for tracing learning goals back to source evidence.
• Learning-Goal Book and Evidence-Review Pipeline (EN) · Deutsch (DE) Versioned one-goal-per-page HTML/PDF publication and fast multi-AI evidence-review model with a separate slow public feedback channel.
• Lernzielbuch und lokale Zeitplanung für Lehrkräfte (DE) · English (EN) Scope-safe goal selection and a calendar timeline in the existing local teacher course plan, without central class storage.
• Canonical Gymnasium Rollout Policy (EN) · Deutsch (DE) Conceptual rollout rules for canonical German Gymnasium subjects.
• MEM/FWU Roundtrip Plan (EN) · Deutsch (DE) Concept plan for MEM/FWU graph interchange.
• Duale Curriculum-Pakete (DE) · Dual Curriculum Package Releases (EN) Target architecture for equivalent JSON-runtime and FWU-ontology release packages, standalone consumption, and repository decoupling.

Didactic Concepts

• Feynman Technique for Learning (EN) · Deutsch (DE)
• Frontier Goal Selection Strategies & Autopilot (EN) · Deutsch (DE)
• Curriculum-Zeitachse, Pufferplanung und Soll-Ist-Lerntempo Versionierte Zeitplanung als getrennte Ausführungsebene mit Unterrichtskalender, Clusterblöcken, datierten Meilensteinen, Puffer, Ist-/Soll-Tacho, belastbarer Achievement-Historie und einer Ein-Seiten-Sicht für Lehrkraftplan, Unterrichts-IST und Klassenlernstand.
• Einheitlicher Lernplanstatus (DE) · English (EN) Eine Mengenbilanz je Fach auf Tages- oder Wochenbasis, deren Text das Backend verbindlich für Cockpit, Chat und Planung formuliert.
• Learning Velocity (EN) · Deutsch (DE)

Runtime Workflows

• Compendium PDF (EN) · Kompendium-PDF (DE) Unified single-source compendium covering personalization, learning/sync/import-export workflows, portable MCP-host strategy, ChatClient/backend contract, coach topology, OAuth/session binding, behavioral Golden Journeys, and plugin lifecycle.
• Learning Workflow (EN) · Operativer Lernablauf (DE)
• Tagesfortschritt: frühere Rechenweise (abgelöst) Abgelöst durch den einheitlichen Lernplanstatus; beschreibt die frühere Rechenweise.
• Kursplanung nach Curriculum-Updates (DE) · English (EN)
• Klausurstoff, Aufgabenabdeckung und Vorbereitung (DE) · English (EN) Themen- und Aufgabenpaketauswahl, ausdrückliche Ergänzung der Vorbereitung vor dem Klausurtermin und aktive oder inaktive Planabschnitte.
• Existing-Learner Teacher View by SkillPilot ID (EN) · Deutsch (DE) Functionally read-only local teacher view over the normal learner endpoints, including local ID/personalization storage, encrypted class files, and the permanent ID's unchanged full-access boundary.
• Import/Export Workflow (EN) · Import- und Export-Workflow (DE)
• Client-State Sync (EN) · Client-State-Synchronisation (DE)
• Verhaltensintegration des MCP-Lerncoaches (DE) · English (EN) Normativer Nordstern, allgemeines Coach-Verhaltensmodell, Golden Journeys und objektive End-to-End-Acceptance.
• Kommunikationsvertrag zwischen ChatClient und SkillPilot-Backend (DE) · English (EN) Kanonische, einfache Verantwortungsgrenze für Sprache, Zustand, Tooldesign, Capabilities, Ergebnisse, Fortsetzung und Fehler aller Coach-Adapter.
• SkillPilot-Lerncoach: Produkt- und Providerarchitektur (DE) · English (EN) Target architecture for the multilingual coach plugin, combining a neutral-English coaching skill with a directly submitted MCP server while preserving backend-authoritative interaction language, the SkillPilot domain core, direct provider billing, and staged production gates.
• OpenAI-Plugin: Versionierung und Lebenszyklus (DE) · English (EN) Binding version-line, compatibility, snapshot, lifecycle, release, and retirement rules including the 19 October 2026 permanent skillpilot-coach decision.
• OpenAI-MCP-App: OAuth-Appbindung und 24h-Lernsession (DE) · English (EN) Normative separation of OAuth app authentication and the fresh, automatically transported, absolute 24-hour learning session that addresses the learner.
• OpenAI-MCP-Clientbindung Security source of truth for client_secret_basic, exact callback/resource/scope binding, secret lifecycle, and the independent learner-session boundary.
• ChatGPT Visible Session Flow Retained Custom-GPT rollback runtime with visible cross-turn relay; not the current production reference architecture.
• Legacy ChatGPT Startcode / Session Flow Historical retained rollback architecture; not the current ChatGPT path.

Maintenance

• Add durable semantic or product concepts to the closest section above.
• Move implementation-only notes to docs/dev/ and operational QA rules to docs/qa-ci/.
• cd app && npm run check:docs-indexes fails if a Markdown file under docs/concept/ is missing from this index.