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 Precise definitions of the core SkillPilot terms, with German equivalents and the normative source per term.
• Levels of Personalization Product-level personalization model.
• Contentanbindung: Architekturrahmen Anbieterunabhängige optionale Contentpakete, getrennt von Curriculum und persönlicher Auswahl; verbindliche Konzeptgrundlage aus Issue #50.
• Curriculum-Qualität: QS-Reifegrade und menschliche Erprobung 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 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

• SkillPilot Skill Graph Specification Core graph model and formal vocabulary.
• General Goal System and Migration Long-term goal-system split and migration direction.
• Node Types Node semantics and classification.
• View Projection and Goal Placement Scope-specific learner-facing views and placement semantics.
• Source And Resource Links Provenance and source/reference semantics.
• Atomic Goal Visualizations Production pipeline and review rules for optional atomic-goal image assets.
• Human-Readable Source Rationales Generated explanation model for tracing learning goals back to source evidence.
• Learning-Goal Book and Evidence-Review Pipeline 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 Scope-safe goal selection and a calendar timeline in the existing local teacher course plan, without central class storage.
• Canonical Gymnasium Rollout Policy Conceptual rollout rules for canonical German Gymnasium subjects.
• MEM/FWU Roundtrip Plan Concept plan for MEM/FWU graph interchange.
• Dual Curriculum Package Releases Target architecture for equivalent JSON-runtime and FWU-ontology release packages, standalone consumption, and repository decoupling.

Didactic Concepts

• Feynman Technique for Learning
• Frontier Goal Selection Strategies & Autopilot
• 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 Eine Mengenbilanz je Fach auf Tages- oder Wochenbasis, deren Text das Backend verbindlich für Cockpit, Chat und Planung formuliert.
• Learning Velocity

Runtime Workflows

• Learning Workflow
• Tagesfortschritt: frühere Rechenweise (abgelöst) Abgelöst durch den einheitlichen Lernplanstatus; beschreibt die frühere Rechenweise.
• Kursplanung nach Curriculum-Updates
• Existing-Learner Teacher View by SkillPilot ID 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
• Client-State Sync
• Verhaltensintegration des MCP-Lerncoaches Normativer Nordstern, allgemeines Coach-Verhaltensmodell, Golden Journeys und objektive End-to-End-Acceptance.
• Kommunikationsvertrag zwischen ChatClient und SkillPilot-Backend Kanonische, einfache Verantwortungsgrenze für Sprache, Zustand, Tooldesign, Capabilities, Ergebnisse, Fortsetzung und Fehler aller Coach-Adapter.
• SkillPilot-Lerncoach: OpenAI-Plugin-, Skill- und MCP-App-Architektur Target architecture for one multilingual public plugin per contract major, 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 Binding version-line, compatibility, snapshot, lifecycle, release, and retirement rules for the multilingual SkillPilot Coach v1 plugin.
• OpenAI-MCP-App: OAuth-Appbindung und 24h-Lernsession Normative separation of the fixed confidential OAuth client that authenticates the App 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.