From d730dad761138c42d9f9aba43a47b1d7d44b4207 Mon Sep 17 00:00:00 2001 From: Lars Date: Tue, 18 Aug 2026 11:24:14 +0200 Subject: [PATCH] Dateien nach "docs/architecture/functional" hochladen --- .../functional/fachliche_zielarchitektur.md | 1190 +++++++++++++++++ .../produktvision_und_produktidentitaet.md | 1079 +++++++++++++++ 2 files changed, 2269 insertions(+) create mode 100644 docs/architecture/functional/fachliche_zielarchitektur.md create mode 100644 docs/architecture/functional/produktvision_und_produktidentitaet.md diff --git a/docs/architecture/functional/fachliche_zielarchitektur.md b/docs/architecture/functional/fachliche_zielarchitektur.md new file mode 100644 index 0000000..3e01c57 --- /dev/null +++ b/docs/architecture/functional/fachliche_zielarchitektur.md @@ -0,0 +1,1190 @@ +--- +title: "Kanshō – Fachliche Zielarchitektur und Interviewplan" +version: "0.1" +status: "Arbeitsstand" +date: "2026-08-18" +product_family: "Jinkendo" +document_role: "Fachliche Zielarchitektur / Master Structure / Interview Plan" +--- + +# Kanshō – Fachliche Zielarchitektur und Interviewplan + +## 1. Zweck dieses Dokuments + +Dieses Dokument definiert die fachliche Zielarchitektur der Kanshō-Produktdokumentation. + +Jedes fachlich relevante Kapitel soll später als **eigenständige Markdown-Datei** in Gitea geführt werden. + +Damit werden drei Ziele verfolgt: + +1. Die Dokumentation bleibt modular und versionierbar. +2. Einzelne Themen können weiterentwickelt werden, ohne andere Inhalte unbeabsichtigt zu verdichten oder zu überschreiben. +3. Die Kapitelstruktur bildet gleichzeitig den Fahrplan für den weiteren Konzeptdialog beziehungsweise das Interview. + +Dieses Dokument ist somit: + +- das **erste und führende Referenzdokument** der fachlichen Konzeption, +- Inhaltsverzeichnis, +- Dokumentationsarchitektur, +- Interviewplan, +- Fortschrittsübersicht. + +Die übrigen fachlichen Dokumente werden aus dieser Zielarchitektur abgeleitet und fachlich hier eingeordnet. + +--- + +# 2. Dokumentationsprinzipien + +## 2.1 Keine stillschweigende Verdichtung + +Ein bestehendes Kapitel wird nicht dadurch „verbessert“, dass ältere Inhalte ohne Kennzeichnung verschwinden. + +Änderungen erfolgen durch: + +- Ergänzung, +- explizite Ersetzung, +- Kennzeichnung als überholt, +- Decision Record, +- Gitea-Versionierung. + +--- + +## 2.2 Entscheidungen und Ideen trennen + +Jedes Kapitel soll klar unterscheiden zwischen: + +- **Entschieden** +- **Bevorzugte Richtung** +- **Hypothese** +- **Offen** +- **Verworfen** +- **Später prüfen** + +--- + +## 2.3 Herkunft von Aussagen erhalten + +Wo sinnvoll soll kenntlich bleiben, ob ein Punkt stammt aus: + +- expliziter Nutzeranforderung, +- gemeinsam getroffener Entscheidung, +- Architekturvorschlag, +- technischem Zwang, +- späterer Validierung, +- externem Research. + +--- + +## 2.4 Keine unnötige Duplizierung + +Ein Thema hat möglichst ein fachliches „Home“. + +Andere Kapitel verlinken darauf, statt denselben Inhalt mehrfach vollständig zu kopieren. + +--- + +## 2.5 Kapitel sind unabhängig versionierbar + +Jede Datei erhält mindestens: + +- Titel, +- Version, +- Status, +- Datum, +- Rolle des Dokuments. + +--- + +# 3. Vorgeschlagene Repository-Struktur + +```text +kansho/ +│ +├── README.md +├── docs/ +│ ├── 00_governance/ +│ │ ├── 00_documentation_principles.md +│ │ ├── 01_glossary.md +│ │ └── 02_decision_log.md +│ │ +│ ├── 01_product/ +│ │ ├── 01_product_vision.md +│ │ ├── 02_product_identity.md +│ │ ├── 03_product_principles.md +│ │ ├── 04_scope_and_non_goals.md +│ │ └── 05_jinkendo_product_boundaries.md +│ │ +│ ├── 02_users_and_context/ +│ │ ├── 01_target_users.md +│ │ ├── 02_reflection_contexts.md +│ │ ├── 03_reflection_spaces.md +│ │ ├── 04_usage_situations.md +│ │ └── 05_lifecycle_and_long_term_use.md +│ │ +│ ├── 03_dialogue/ +│ │ ├── 01_dialogue_model.md +│ │ ├── 02_dialogue_entry.md +│ │ ├── 03_guided_reflection.md +│ │ ├── 04_threads_and_branching.md +│ │ ├── 05_dialogue_closure.md +│ │ └── 06_conversation_safety_and_boundaries.md +│ │ +│ ├── 04_memory/ +│ │ ├── 01_memory_architecture.md +│ │ ├── 02_working_context.md +│ │ ├── 03_thread_memory.md +│ │ ├── 04_episodic_memory.md +│ │ ├── 05_self_model.md +│ │ ├── 06_writing_profile.md +│ │ ├── 07_temporal_memory.md +│ │ ├── 08_conflicts_forgetting_and_correction.md +│ │ └── 09_context_builder.md +│ │ +│ ├── 05_reflection_intelligence/ +│ │ ├── 01_reflection_model.md +│ │ ├── 02_observation_interpretation_hypothesis.md +│ │ ├── 03_reflection_frontiers.md +│ │ ├── 04_pattern_detection.md +│ │ ├── 05_values_and_inner_alignment.md +│ │ └── 06_longitudinal_development.md +│ │ +│ ├── 06_journaling/ +│ │ ├── 01_journal_model.md +│ │ ├── 02_daily_reflection.md +│ │ ├── 03_entry_generation.md +│ │ ├── 04_personal_writing_style.md +│ │ ├── 05_media_and_metadata.md +│ │ ├── 06_search_and_recall.md +│ │ └── 07_review_and_retrospective.md +│ │ +│ ├── 07_mindfulness_and_meditation/ +│ │ ├── 01_mindfulness_concept.md +│ │ ├── 02_meditation_concept.md +│ │ ├── 03_guided_meditations.md +│ │ ├── 04_contextual_micro_interventions.md +│ │ └── 05_post_meditation_reflection.md +│ │ +│ ├── 08_outputs_and_actions/ +│ │ ├── 01_reflection_outputs.md +│ │ ├── 02_journal_entries.md +│ │ ├── 03_reflection_memories.md +│ │ ├── 04_knowledge_deltas.md +│ │ ├── 05_action_candidates.md +│ │ └── 06_confirmation_and_human_in_the_loop.md +│ │ +│ ├── 09_integrations/ +│ │ ├── 01_integration_principles.md +│ │ ├── 02_mindnet_integration.md +│ │ ├── 03_obsidian_integration.md +│ │ ├── 04_kairo_integration.md +│ │ ├── 05_mitai_integration.md +│ │ ├── 06_shinkan_integration.md +│ │ └── 07_shared_jinkendo_services.md +│ │ +│ ├── 10_ai_architecture/ +│ │ ├── 01_ai_architecture_overview.md +│ │ ├── 02_agent_roles.md +│ │ ├── 03_prompt_architecture.md +│ │ ├── 04_retrieval_strategy.md +│ │ ├── 05_memory_write_policy.md +│ │ ├── 06_model_routing.md +│ │ ├── 07_local_vs_cloud_ai.md +│ │ └── 08_evaluation_and_quality.md +│ │ +│ ├── 11_data_architecture/ +│ │ ├── 01_domain_model.md +│ │ ├── 02_dialogue_data_model.md +│ │ ├── 03_memory_data_model.md +│ │ ├── 04_reflection_space_model.md +│ │ ├── 05_identity_and_profile_model.md +│ │ ├── 06_versioning_and_provenance.md +│ │ └── 07_retention_and_deletion.md +│ │ +│ ├── 12_ux/ +│ │ ├── 01_experience_principles.md +│ │ ├── 02_mobile_first.md +│ │ ├── 03_home_and_entry_points.md +│ │ ├── 04_conversation_ui.md +│ │ ├── 05_journal_ui.md +│ │ ├── 06_reflection_history.md +│ │ ├── 07_desktop_experience.md +│ │ └── 08_accessibility.md +│ │ +│ ├── 13_voice_and_media/ +│ │ ├── 01_voice_interaction.md +│ │ ├── 02_transcription.md +│ │ ├── 03_audio_capture.md +│ │ ├── 04_text_audio_switching.md +│ │ └── 05_media_handling.md +│ │ +│ ├── 14_pwa_and_offline/ +│ │ ├── 01_pwa_architecture.md +│ │ ├── 02_offline_capabilities.md +│ │ ├── 03_local_storage.md +│ │ ├── 04_sync_strategy.md +│ │ ├── 05_conflict_resolution.md +│ │ └── 06_notifications_and_background_behaviour.md +│ │ +│ ├── 15_privacy_security_safety/ +│ │ ├── 01_privacy_principles.md +│ │ ├── 02_sensitive_personal_data.md +│ │ ├── 03_encryption_and_access.md +│ │ ├── 04_memory_transparency.md +│ │ ├── 05_export_delete_and_portability.md +│ │ ├── 06_ai_safety_boundaries.md +│ │ └── 07_crisis_and_high_risk_scenarios.md +│ │ +│ ├── 16_product_delivery/ +│ │ ├── 01_mvp_definition.md +│ │ ├── 02_release_slices.md +│ │ ├── 03_dependencies.md +│ │ ├── 04_test_strategy.md +│ │ └── 05_acceptance_criteria.md +│ │ +│ └── 17_research/ +│ ├── 01_market_landscape.md +│ ├── 02_day_one_benchmark.md +│ ├── 03_ai_journaling_benchmark.md +│ ├── 04_meditation_benchmark.md +│ └── 05_research_evidence.md +│ +└── decisions/ + └── ADR-xxxx-*.md +``` + +Die genaue Ordnerstruktur kann später vereinfacht werden. Inhaltlich sollte die Trennung jedoch erhalten bleiben. + +--- + +# 4. Kapitelplan und Interviewreihenfolge + +Die folgende Reihenfolge ist nicht identisch mit der späteren Ordnernummerierung. Sie ist danach geordnet, welche Entscheidungen aufeinander aufbauen. + +--- + +# Phase A – Identität und Lebenskontext + +## A1. Produktvision und Produktidentität + +**Status:** weitgehend begonnen + +**Ziel des Interviews:** + +- Produktkern endgültig schärfen, +- Nutzenversprechen definieren, +- Rolle innerhalb Jinkendo abgrenzen, +- Begriffe festlegen. + +**Leitfragen:** + +- Was soll Kanshō langfristig für einen Menschen sein? +- Welche Veränderung soll durch jahrelange Nutzung entstehen? +- Was soll die App ausdrücklich niemals werden? +- Woran erkennt man, dass eine Funktion „zu Kanshō gehört“? +- Was ist der Unterschied zwischen Reflexion, Coaching, Therapie, Journaling und Achtsamkeit innerhalb des Produkts? + +**Zieldateien:** + +- `01_product_vision.md` +- `02_product_identity.md` +- `03_product_principles.md` +- `04_scope_and_non_goals.md` +- `05_jinkendo_product_boundaries.md` + +--- + +## A2. Zielnutzer und Nutzung über Jahre + +**Ziel:** + +Nicht nur einzelne User Stories, sondern die langfristige Beziehung zwischen Mensch und Anwendung definieren. + +**Leitfragen:** + +- Ist Kanshō zunächst primär für den Ersteller selbst gedacht oder bereits als generisches Produkt? +- Welche Voraussetzungen muss ein Nutzer mitbringen? +- Wie verändert sich Kanshō nach einem Monat, einem Jahr und zehn Jahren? +- Welche Inhalte sind sehr privat? +- Welche Situationen führen spontan zur Nutzung? +- Welche Situationen führen zu geplanten Reflexionen? + +**Zieldateien:** + +- `01_target_users.md` +- `04_usage_situations.md` +- `05_lifecycle_and_long_term_use.md` + +--- + +# Phase B – Reflection Spaces und Dialog + +## B1. Reflection Contexts und Reflection Spaces + +**Ziel:** + +Das zentrale Kontextmodell definieren. + +**Leitfragen:** + +- Welche übergeordneten Lebensräume gibt es? +- Welche davon sind stabil? +- Welche entstehen dynamisch? +- Kann ein Erlebnis mehreren Räumen gleichzeitig angehören? +- Wie werden Räume erzeugt, zusammengeführt, beendet oder archiviert? +- Wie unterscheiden sich Kontext, Thema, Projekt, Rolle und Lebensbereich? +- Wie werden Kairo-Objekte und mindnet-Knoten verknüpft? + +**Zieldateien:** + +- `02_reflection_contexts.md` +- `03_reflection_spaces.md` +- `04_reflection_space_model.md` + +--- + +## B2. Gesprächseinstieg + +**Ziel:** + +Definieren, wie Kanshō einen Dialog beginnt. + +**Leitfragen:** + +- Öffnet der Nutzer die App ohne konkrete Absicht? +- Kann Kanshō einen Einstieg vorschlagen? +- Welche Informationen darf Kanshō für eine Einstiegsfrage verwenden? +- Wann ist eine frühere offene Frage wichtiger als das aktuelle Tagesgeschehen? +- Wie direkt oder zurückhaltend soll die KI sein? +- Darf Kanshō proaktiv schwierige Themen ansprechen? + +**Zieldateien:** + +- `02_dialogue_entry.md` +- `03_home_and_entry_points.md` + +--- + +## B3. Geführte Reflexion + +**Ziel:** + +Die eigentliche Gesprächsmethodik definieren. + +**Leitfragen:** + +- Welche Arten von Fragen stellt Kanshō? +- Wann spiegelt die KI? +- Wann fasst sie zusammen? +- Wann widerspricht sie? +- Wie tief darf sie nachfragen? +- Wie erkennt sie, dass ein Thema noch nicht ausreichend verstanden ist? +- Wie verhindert man mechanische Coaching-Fragen? + +**Zieldateien:** + +- `01_dialogue_model.md` +- `03_guided_reflection.md` +- `01_reflection_model.md` + +--- + +## B4. Dialogfäden und Branching + +**Ziel:** + +Mehrere parallele Denkfäden modellieren. + +**Leitfragen:** + +- Wann entsteht ein Thread? +- Muss der Nutzer ihn sehen? +- Wie erkennt die KI einen neuen Faden? +- Wann schlägt sie eine Trennung vor? +- Wie wird ein Faden geparkt? +- Wann wird ein alter Faden wieder angeboten? +- Wie werden Threads miteinander verbunden? + +**Zieldateien:** + +- `04_threads_and_branching.md` +- `02_dialogue_data_model.md` + +--- + +## B5. Abschluss eines Dialogs + +**Ziel:** + +Festlegen, was am Ende einer Reflexion geschieht. + +**Leitfragen:** + +- Muss jeder Dialog einen expliziten Abschluss haben? +- Welche Zusammenfassung sieht der Nutzer? +- Welche Erkenntnisse werden vorgeschlagen? +- Was wird gespeichert? +- Was wird verworfen? +- Was wird an andere Apps übergeben? +- Wann entsteht ein Tagebucheintrag? + +**Zieldateien:** + +- `05_dialogue_closure.md` +- `01_reflection_outputs.md` + +--- + +# Phase C – Gedächtnis, Identität und Langzeitbezug + +## C1. Memory Architecture + +**Ziel:** + +Die Gedächtnisebenen endgültig definieren. + +**Leitfragen:** + +- Was gehört in Working Context? +- Was gehört in Thread Memory? +- Was wird episodische Erinnerung? +- Was wird dauerhaftes Wissen? +- Was darf automatisch gespeichert werden? +- Was benötigt Bestätigung? +- Was darf später vergessen werden? + +**Zieldateien:** + +- `01_memory_architecture.md` +- `02_working_context.md` +- `03_thread_memory.md` +- `04_episodic_memory.md` + +--- + +## C2. Self Model + +**Ziel:** + +Definieren, wie Kanshō stabile persönliche Informationen repräsentiert. + +**Leitfragen:** + +- Was gehört zum Self Model? +- Was sind Werte? +- Was ist Leitbild? +- Was ist Rolle? +- Was ist Eigenschaft? +- Was ist nur momentane Selbstbeschreibung? +- Wie wird eine Hypothese bestätigt? +- Wie werden Widersprüche behandelt? +- Darf sich ein Wert verändern? + +**Zieldateien:** + +- `05_self_model.md` +- `05_values_and_inner_alignment.md` +- `05_identity_and_profile_model.md` + +--- + +## C3. Writing Profile + +**Ziel:** + +Eine persönliche Stimme über Jahre erhalten. + +**Leitfragen:** + +- Welche Texte gelten als authentische Stilreferenz? +- Wie stark soll Kanshō stilistisch imitieren? +- Was darf sprachlich geglättet werden? +- Wie viel Unperfektheit soll bewusst erhalten bleiben? +- Wie erkennt man Stiländerungen im Laufe des Lebens? +- Soll ein Tagebuchtext verschiedene historische Schreibstile respektieren? + +**Zieldateien:** + +- `06_writing_profile.md` +- `04_personal_writing_style.md` + +--- + +## C4. Zeit, Erinnerung und Widerspruch + +**Ziel:** + +Verhindern, dass das System vergangene und aktuelle Wahrheiten vermischt. + +**Leitfragen:** + +- Wie wird Zeit an Erinnerungen modelliert? +- Wie unterscheidet Kanshō „damals glaubte ich“ von „heute glaube ich“? +- Was passiert mit falschen Erinnerungen? +- Wie werden Korrekturen propagiert? +- Wie stark verlieren alte Informationen an Gewicht? +- Was bedeutet bewusstes Vergessen? + +**Zieldateien:** + +- `07_temporal_memory.md` +- `08_conflicts_forgetting_and_correction.md` +- `06_versioning_and_provenance.md` + +--- + +## C5. Context Builder + +**Ziel:** + +Definieren, welcher Kontext für eine konkrete LLM-Anfrage zusammengestellt wird. + +**Leitfragen:** + +- Welche Informationsquellen gibt es? +- Welche haben Priorität? +- Wie viel Working Context? +- Welche Erinnerungen? +- Welche Werte? +- Welche offenen Threads? +- Welche Informationen aus Mitai, Shinkan oder Kairo? +- Wie verhindert man Context Pollution? +- Wie wird Unsicherheit transportiert? + +**Zieldatei:** + +- `09_context_builder.md` + +--- + +# Phase D – Reflexionsintelligenz und Outputs + +## D1. Beobachtung, Interpretation und Hypothese + +**Ziel:** + +Ein erkenntnistheoretisch sauberes Modell schaffen. + +**Leitfragen:** + +- Wie unterscheiden wir Tatsache, Nutzerinterpretation und KI-Hypothese? +- Welche Confidence benötigen unterschiedliche Aussagen? +- Wer darf eine Hypothese bestätigen? +- Wie wird eine Hypothese später verworfen? +- Wie verhindert man scheinbare psychologische Gewissheit? + +**Zieldateien:** + +- `02_observation_interpretation_hypothesis.md` +- `06_versioning_and_provenance.md` + +--- + +## D2. Reflection Frontiers + +**Ziel:** + +Offene Bedeutungs- und Erkenntnisräume aus mindnet nutzbar machen. + +**Leitfragen:** + +- Was genau ist ein offenes Ende? +- Wie wird es erkannt? +- Wie wird Relevanz bewertet? +- Wann darf Kanshō es wieder aufgreifen? +- Wie verhindert man obsessives Wiederholen? +- Wann gilt eine Frontier als geschlossen? + +**Zieldatei:** + +- `03_reflection_frontiers.md` + +--- + +## D3. Muster und Entwicklung + +**Ziel:** + +Langfristige Entwicklung sichtbar machen, ohne vorschnelle Persönlichkeitsdiagnosen. + +**Leitfragen:** + +- Ab wann ist etwas ein Muster? +- Welche zeitliche Mindestbasis braucht es? +- Welche Rolle spielt Nutzerbestätigung? +- Wie werden Gegenbeispiele einbezogen? +- Welche Entwicklungen sollen sichtbar werden? +- Wie präsentiert Kanshō Veränderungen über Jahre? + +**Zieldateien:** + +- `04_pattern_detection.md` +- `06_longitudinal_development.md` + +--- + +## D4. Reflection Outputs + +**Ziel:** + +Definieren, welche Artefakte aus einem Dialog entstehen können. + +**Kandidaten:** + +- Journal Entry, +- Reflection Memory, +- Knowledge Delta, +- Action Candidate, +- aktualisierter Thread, +- neue oder geänderte Hypothese. + +**Leitfragen:** + +- Was entsteht automatisch? +- Was benötigt Zustimmung? +- Wo wird was gespeichert? +- Welche Outputs sind sichtbar? +- Welche existieren nur intern? + +**Zieldateien:** + +- `01_reflection_outputs.md` +- `02_journal_entries.md` +- `03_reflection_memories.md` +- `04_knowledge_deltas.md` +- `05_action_candidates.md` +- `06_confirmation_and_human_in_the_loop.md` + +--- + +# Phase E – Journaling, Achtsamkeit und Meditation + +## E1. Journaling + +**Ziel:** + +Das Tagebuch als hochwertigen Bestandteil ausformen, ohne Kanshō darauf zu reduzieren. + +**Leitfragen:** + +- Welche Day-One-artigen Funktionen werden benötigt? +- Welche Medien? +- Welche Metadaten? +- Welche Timeline? +- Welche Suche? +- Welche Rückblicke? +- Welche automatisch erzeugten Inhalte? +- Wie viel Nachbearbeitung durch den Nutzer? + +**Zieldateien:** + +- gesamter Ordner `06_journaling/` + +--- + +## E2. Achtsamkeit + +**Ziel:** + +Ein eigenes Achtsamkeitsverständnis für Kanshō definieren. + +**Leitfragen:** + +- Was bedeutet Achtsamkeit im Produkt? +- Welche Rolle spielt Wahrnehmung? +- Welche Rolle spielt Akzeptanz? +- Welche Rolle spielt Reflexion? +- Was unterscheidet Kanshō von klassischen Mindfulness Apps? +- Welche kurzen situativen Übungen sind sinnvoll? + +**Zieldateien:** + +- `01_mindfulness_concept.md` +- `04_contextual_micro_interventions.md` + +--- + +## E3. Meditation + +**Ziel:** + +Meditation funktional und methodisch definieren. + +**Leitfragen:** + +- vorgefertigt oder generiert? +- personalisiert oder allgemein? +- Stimme und Audio? +- Länge? +- aktuelle Lebenssituation als Kontext? +- sichere Grenzen? +- Nachreflexion? +- Historie? + +**Zieldateien:** + +- `02_meditation_concept.md` +- `03_guided_meditations.md` +- `05_post_meditation_reflection.md` + +--- + +# Phase F – Integration und technische Architektur + +## F1. mindnet und Obsidian + +**Ziel:** + +Die langfristige Wissens- und Archivarchitektur festlegen. + +**Leitfragen:** + +- Welche Informationen liest Kanshō aus mindnet? +- Welche schreibt es zurück? +- Was bleibt kanonisch in Obsidian? +- Was bleibt strukturiert in Datenbanken? +- Wie werden IDs und Backlinks erzeugt? +- Welche Edges werden benötigt? +- Wie werden Reflection Frontiers repräsentiert? + +**Zieldateien:** + +- `02_mindnet_integration.md` +- `03_obsidian_integration.md` + +--- + +## F2. Kairo, Mitai und Shinkan + +**Ziel:** + +Klare Integrationsverträge statt Funktionsduplikation. + +**Leitfragen:** + +- Welche Daten darf Kanshō lesen? +- Welche Daten darf es schreiben? +- Was wird nur vorgeschlagen? +- Was benötigt Bestätigung? +- Welche Events sind relevant? +- Welche Daten gehören fachlich weiterhin ausschließlich in die Quellanwendung? + +**Zieldateien:** + +- `04_kairo_integration.md` +- `05_mitai_integration.md` +- `06_shinkan_integration.md` +- `01_integration_principles.md` + +--- + +## F3. AI Architecture + +**Ziel:** + +Die technische Umsetzung der kollaborativen KI definieren. + +**Leitfragen:** + +- ein Modell oder mehrere Rollen? +- Reflection Agent? +- Memory Agent? +- Context Builder? +- Journal Writer? +- Critic/Verifier? +- Model Routing? +- lokale Modelle? +- Cloud Modelle? +- Prompt Registry? +- Evaluation? + +**Zieldateien:** + +- gesamter Ordner `10_ai_architecture/` + +--- + +## F4. Datenarchitektur + +**Ziel:** + +Kanonische Datenmodelle definieren. + +**Leitfragen:** + +- Conversation +- Message +- Thread +- Reflection Space +- Memory +- Hypothesis +- Insight +- Journal Entry +- Context Reference +- Action Candidate +- Writing Profile +- Self Model + +**Zieldateien:** + +- gesamter Ordner `11_data_architecture/` + +--- + +# Phase G – Experience, Voice, PWA und Offline + +## G1. Mobile-First Experience + +**Ziel:** + +Die Hauptnutzung auf dem Smartphone definieren. + +**Leitfragen:** + +- Was sieht der Nutzer beim Öffnen? +- Wie schnell kann eine Reflexion beginnen? +- Sprache oder Text? +- Einhandbedienung? +- Wie werden lange Dialoge dargestellt? +- Wie erscheinen frühere Threads? +- Wie vermeidet man Informationsüberladung? + +**Zieldateien:** + +- `01_experience_principles.md` +- `02_mobile_first.md` +- `03_home_and_entry_points.md` +- `04_conversation_ui.md` + +--- + +## G2. Desktop Experience + +**Ziel:** + +Desktop nicht nur als vergrößerte Mobile UI behandeln. + +**Leitfragen:** + +- Welche Tätigkeiten sind auf Desktop besser? +- Welche Mehrspaltenansichten? +- Journal und Dialog nebeneinander? +- Recherche in alten Reflexionen? +- Mindnet-Verbindungen? + +**Zieldatei:** + +- `07_desktop_experience.md` + +--- + +## G3. Sprache und Transkription + +**Ziel:** + +Voice als primäre mobile Interaktion prüfen. + +**Leitfragen:** + +- Push-to-talk? +- kontinuierliche Aufnahme? +- Live-Transkription? +- Audio speichern oder nach Transkription löschen? +- Korrektur vor Übergabe? +- offline? +- Unterbrechungen? +- Mischform Text + Sprache? + +**Zieldateien:** + +- gesamter Ordner `13_voice_and_media/` + +--- + +## G4. PWA und Offline + +**Ziel:** + +Festlegen, was ohne Netz noch funktioniert. + +**Leitfragen:** + +- lokale Journaleinträge? +- lokale Dialoge? +- lokale Transkription? +- lokale kleine Modelle? +- Sync Queue? +- Verschlüsselung? +- Konfliktauflösung? +- Installation auf iOS/Android/Desktop? + +**Zieldateien:** + +- gesamter Ordner `14_pwa_and_offline/` + +--- + +# Phase H – Datenschutz, Sicherheit und Vertrauen + +## H1. Privacy by Design + +**Ziel:** + +Besonders sensible persönliche Langzeitdaten schützen. + +**Leitfragen:** + +- Welche Daten sind besonders kritisch? +- Verschlüsselung at rest und in transit? +- lokale Speicherung? +- Cloud Verarbeitung? +- Export? +- vollständiges Löschen? +- selektives Vergessen? +- Zugriff anderer Jinkendo-Apps? + +**Zieldateien:** + +- `01_privacy_principles.md` +- `02_sensitive_personal_data.md` +- `03_encryption_and_access.md` +- `05_export_delete_and_portability.md` + +--- + +## H2. Memory Transparency + +**Ziel:** + +Der Nutzer muss verstehen und kontrollieren können, was Kanshō über ihn „weiß“. + +**Leitfragen:** + +- Kann man gespeicherte Memories ansehen? +- Quelle anzeigen? +- Confidence? +- korrigieren? +- löschen? +- Herleitung anzeigen? +- Self Model editieren? + +**Zieldatei:** + +- `04_memory_transparency.md` + +--- + +## H3. Safety Boundaries + +**Ziel:** + +Grenzen bei psychisch belastenden, medizinischen oder anderweitig hochriskanten Themen definieren. + +**Zieldateien:** + +- `06_ai_safety_boundaries.md` +- `07_crisis_and_high_risk_scenarios.md` +- `06_conversation_safety_and_boundaries.md` + +--- + +# Phase I – MVP und Delivery + +## I1. MVP-Schnitt + +**Ziel:** + +Nach vollständiger fachlicher Konzeption eine erste vertikale Produktversion definieren. + +Wichtig: + +Der MVP soll nicht dadurch entstehen, dass beliebige Features gestrichen werden. Er soll eine **vollständige kleine Reflexionsschleife** ermöglichen. + +Eine mögliche spätere vertikale Scheibe könnte sein: + +1. Reflexionsraum auswählen oder erkennen, +2. kontextbezogenes Gespräch starten, +3. Dialog führen, +4. Thread Memory erzeugen, +5. Tagebucheintrag generieren, +6. Nutzer bestätigt, +7. Eintrag nach Obsidian überführen, +8. Reflection Memory in mindnet schreiben. + +Dies ist noch keine endgültige MVP-Entscheidung. + +**Zieldateien:** + +- gesamter Ordner `16_product_delivery/` + +--- + +# Phase J – Research und Benchmarking + +Diese Phase kann parallel zu den anderen Phasen laufen. + +Zu untersuchen sind insbesondere: + +- Day One, +- KI-Journaling-Produkte, +- Reflection Apps, +- Mindfulness Apps, +- Meditation Apps, +- Personal Memory Systeme, +- Long-Term-Memory-Architekturen, +- Voice Journaling, +- Privacy Patterns, +- Personal AI. + +**Zieldateien:** + +- gesamter Ordner `17_research/` + +--- + +# 5. Empfohlene Reihenfolge des weiteren Interviews + +Die unmittelbar nächste Sequenz sollte lauten: + +1. **Reflection Spaces** +2. **typische Nutzungssituationen** +3. **Gesprächseinstieg** +4. **Dialogmethodik** +5. **Threads und Branching** +6. **Dialogabschluss und Outputs** +7. **Memory Architecture** +8. **Self Model** +9. **Writing Profile** +10. **Context Builder** +11. **Reflection Frontiers** +12. **Journaling** +13. **Achtsamkeit** +14. **Meditation** +15. **Integrationen** +16. **AI Architecture** +17. **Mobile UX / Voice** +18. **Offline** +19. **Privacy / Safety** +20. **MVP** + +Diese Reihenfolge verhindert, dass technische Entscheidungen zu früh getroffen werden, bevor klar ist, welches Verhalten das Produkt tatsächlich benötigt. + +--- + +# 6. Interviewmethode + +Für jedes Kapitel wird derselbe Arbeitsmodus empfohlen. + +## Schritt 1 – Ausgangshypothese + +Auf Basis der bisherigen Entscheidungen wird eine erste strukturierte Hypothese formuliert. + +## Schritt 2 – gezielte Fragen + +Es werden nur Fragen gestellt, die echte Produktentscheidungen verändern können. + +## Schritt 3 – Szenarien + +Die Entscheidung wird anhand konkreter Situationen geprüft. + +## Schritt 4 – Gegenbeispiele und Grenzfälle + +Bewusst problematische oder widersprüchliche Situationen werden getestet. + +## Schritt 5 – Entscheidung + +Ergebnis wird klassifiziert als: + +- entschieden, +- bevorzugte Richtung, +- Hypothese, +- offen, +- verworfen. + +## Schritt 6 – Dokumentation + +Das betreffende Kapitel wird als eigene Datei aktualisiert. + +--- + +# 7. Definition of Done für ein Konzeptkapitel + +Ein Kapitel gilt konzeptionell als ausreichend bearbeitet, wenn mindestens folgende Punkte beantwortet sind: + +- Zweck, +- Begriffe, +- fachliche Verantwortung, +- zentrale Regeln, +- Nutzerinteraktion, +- Daten-/Informationsbedarf, +- Schnittstellen zu anderen Bereichen, +- Edge Cases, +- offene Punkte, +- getroffene Entscheidungen, +- bewusste Nicht-Ziele. + +Technische Kapitel erhalten zusätzlich: + +- Datenmodell, +- API-/Event-Bedarf, +- Persistenz, +- Fehlerfälle, +- Security-/Privacy-Auswirkungen, +- Offline-Auswirkungen, +- Testbarkeit. + +--- + +# 8. Fortschrittsstatus zum Start + +| Themenbereich | Status | +|---|---| +| Produktvision | begonnen / bereits relativ klar | +| Produktidentität | weitgehend entschieden | +| Produktgrenzen zu Jinkendo | weitgehend entschieden | +| Reflection Spaces | als nächster Dialogschritt vorgesehen | +| Dialogmodell | erste Leitplanken vorhanden | +| Threads | Grundidee vorhanden | +| Memory Architecture | erstes Schichtenmodell vorhanden | +| mindnet-Rolle | Grundrichtung vorhanden | +| Self Model | erste Prinzipien vorhanden | +| Writing Profile | erste Prinzipien vorhanden | +| Reflection Frontiers | Konzeptidee vorhanden | +| Journaling | Anforderungen grob | +| Meditation | nur grob | +| Achtsamkeit | nur grob | +| UX | technische Leitplanken vorhanden | +| Voice/Transkription | Anforderung vorhanden | +| Offline | Anforderung vorhanden | +| Integrationen | Produktgrenzen vorhanden, technische Verträge offen | +| AI Architecture | offen | +| Data Architecture | offen | +| Privacy/Safety | offen | +| MVP | offen | + +--- + +# 9. Nächster Interviewblock + +Der nächste konzeptionelle Block ist: + +# **Reflection Spaces** + +Ziel ist, zu beantworten: + +> Wie organisiert Kanshō die unterschiedlichen Lebens-, Situations- und Themenkontexte, in denen Reflexion stattfindet? + +Dabei werden wir insbesondere zwischen folgenden Begriffen unterscheiden müssen: + +- Lebensbereich, +- Rolle, +- Kontext, +- Situation, +- Ereignis, +- Thema, +- Reflexionsraum, +- Dialog, +- Thread, +- Projekt, +- Ziel. + +Erst danach sollte das detaillierte Dialogmodell weiter ausgearbeitet werden. diff --git a/docs/architecture/functional/produktvision_und_produktidentitaet.md b/docs/architecture/functional/produktvision_und_produktidentitaet.md new file mode 100644 index 0000000..a87aac8 --- /dev/null +++ b/docs/architecture/functional/produktvision_und_produktidentitaet.md @@ -0,0 +1,1079 @@ +--- +title: "Kanshō – Produktvision, Produktidentität und konzeptionelle Leitplanken" +version: "0.1" +status: "Arbeitsstand" +date: "2026-08-18" +product_family: "Jinkendo" +document_role: "Product Vision / Product Identity / Scope Baseline" +--- + +# Kanshō – Produktvision, Produktidentität und konzeptionelle Leitplanken + +## 1. Zweck dieses Dokuments + +Dieses Dokument hält den aktuellen Stand der Produktvision für die neue Achtsamkeits- und Reflexionsanwendung innerhalb der Jinkendo-Produktfamilie fest. + +Es ist fachlich der in `fachliche_zielarchitektur.md` definierten Zielstruktur untergeordnet und bildet dort den Bereich Produktvision / Produktidentität aus. + +Es ist bewusst **keine Kurzfassung** und kein verdichtetes Management-Summary. Ziel ist, die bisher formulierten Gedanken, getroffenen Entscheidungen, Abgrenzungen und offenen Punkte möglichst vollständig und nachvollziehbar zu dokumentieren. + +Das Dokument dient als stabile Baseline für die weitere Konzeption. Spätere Änderungen sollen nicht dadurch erfolgen, dass bestehende Inhalte stillschweigend gekürzt oder entfernt werden, sondern durch: + +- Ergänzung neuer Erkenntnisse, +- explizite Änderung bestehender Entscheidungen, +- Kennzeichnung überholter Annahmen, +- Versionierung in Gitea, +- bei grundlegenden Richtungswechseln durch einen nachvollziehbaren Decision Record. + +--- + +# 2. Ausgangslage + +Innerhalb der Jinkendo-Produktfamilie existieren bereits mehrere Anwendungen mit klar abgegrenzten Aufgabenbereichen. + +Die neue Anwendung entsteht daher **nicht als isoliertes Einzelprodukt**, sondern als weitere Komponente eines bereits vorhandenen persönlichen digitalen Ökosystems. + +Bereits vorhandene Systeme übernehmen insbesondere folgende Aufgaben: + +## 2.1 Kairo + +Kairo ist primär für Planung, Steuerung und persönliche Entwicklung zuständig. + +Dazu gehören unter anderem: + +- Ziele, +- Vorhaben, +- Initiativen, +- Projekte, +- persönliche Entwicklungspfade, +- Rituale, +- Roadmaps, +- Meilensteine, +- Aufgaben und Next Best Actions. + +Für die neue Anwendung bedeutet dies: + +**Planung ist nicht ihre Kernaufgabe.** + +Erkenntnisse aus Reflexionen können später an Kairo übergeben werden, wenn daraus eine Absicht, ein Ziel, ein Ritual oder eine konkrete Maßnahme entsteht. + +--- + +## 2.2 mindnet + +mindnet bildet das persönliche Wissensnetz. + +Der derzeitige Schwerpunkt liegt auf: + +- Obsidian als menschenlesbarer Wissens- und Notizbasis, +- Qdrant als semantischer Retrieval-Schicht, +- semantischer Suche, +- Beziehungen zwischen Wissenselementen, +- Edges wie beispielsweise `belongs_to`, `next`, `prev`, `references` und `backlink`, +- perspektivisch der Abbildung tieferer Bedeutungs- und Zusammenhangsstrukturen. + +mindnet ist für die neue Anwendung besonders relevant, weil dort langfristig unter anderem folgende Informationen liegen oder liegen können: + +- Erfahrungen, +- Erlebnisse, +- Entscheidungen, +- Erkenntnisse, +- Werte, +- Leitbild, +- persönliche Prinzipien, +- autobiografische Zusammenhänge, +- noch ungeklärte oder unvollständige Beziehungsketten. + +Die neue Anwendung soll Informationen aus mindnet für Reflexionen nutzen und umgekehrt relevante Ergebnisse wieder in das langfristige Wissenssystem überführen. + +--- + +## 2.3 Shinkan + +Shinkan ist für Training und Trainingsorganisation zuständig. + +Dazu gehören unter anderem: + +- Übungen, +- Trainingsvorlagen, +- Trainingsplanung, +- Programme, +- Medien, +- Trainingsmethodik. + +Für die neue Anwendung bedeutet dies: + +**Trainingsplanung und Übungsverwaltung werden nicht dupliziert.** + +Reflexionen zu Training, Lernen, Kampfkunst oder persönlichen Erfahrungen im Training können jedoch Bestandteil eines Reflexionsdialogs sein. + +--- + +## 2.4 Mitai + +Mitai bildet körperliche Entwicklung und Gesundheitskontext ab. + +Dazu gehören unter anderem: + +- körperliche Entwicklung, +- Fitness, +- Ernährung, +- Essverhalten, +- Vitalwerte, +- gesundheitsbezogene Verläufe. + +Für die neue Anwendung bedeutet dies: + +**Körper- und Gesundheitsdaten werden nicht nochmals als eigenes Tracking-System aufgebaut.** + +Kanshō kann solche Informationen jedoch – abhängig von Berechtigungen und Kontext – in Reflexionen einbeziehen. + +--- + +# 3. Arbeitstitel und Produktname + +Als derzeitiger Arbeitsname wurde vorgeschlagen: + +# **Kanshō** + +Der Name soll zunächst als Arbeitstitel verwendet werden. + +Eine endgültige Entscheidung über Produktname, Schreibweise, Markenfähigkeit, Domain, App-Store-Verfügbarkeit und mögliche Überschneidungen mit bestehenden Angeboten ist noch offen. + +--- + +# 4. Produktvision + +Kanshō soll ein **persönlicher KI-gestützter Reflexionsbegleiter** innerhalb der Jinkendo-Produktfamilie werden. + +Die App soll Menschen nicht primär dabei unterstützen, Aufgaben zu planen, Daten zu tracken oder Inhalte nur abzulegen. + +Ihr Schwerpunkt liegt auf: + +> **Wahrnehmen → Reflektieren → Verstehen → Einordnen** + +Die App soll einen kontinuierlichen, vertrauenswürdigen Dialog über Erlebnisse, Gedanken, Gefühle, Entscheidungen, Entwicklungen und Lebensfragen ermöglichen. + +Dabei soll die KI nicht nur auf einzelne Eingaben reagieren, sondern: + +- den jeweiligen Lebenskontext verstehen, +- den bisherigen Dialog kennen, +- relevante frühere Erfahrungen berücksichtigen, +- das persönliche Wertemodell und Leitbild einbeziehen, +- offene Themen und frühere Reflexionsfäden wiedererkennen, +- Zusammenhänge vorsichtig sichtbar machen, +- passende Fragen stellen, +- langfristige Entwicklung unterstützen. + +Kanshō soll damit deutlich mehr sein als: + +- ein digitales Tagebuch, +- ein Chatbot, +- eine Meditations-App, +- ein Mood Tracker, +- ein persönlicher Assistent. + +Der zentrale Produktgedanke ist: + +> **Kanshō ist der dialogische Reflexionsraum der Jinkendo-Familie.** + +--- + +# 5. Produktidentität + +## 5.1 Gewählte Grundausrichtung + +Von drei möglichen Grundidentitäten wurde folgende Ausrichtung bevorzugt: + +### Personal Reflection Companion + +Kanshō wird primär als **langfristiger persönlicher Reflexionsbegleiter** verstanden. + +Tagebuch, Meditation und Achtsamkeit sind wichtige Funktionen, aber nicht die eigentliche Produktidentität. + +Damit gilt: + +**Nicht:** Tagebuch mit KI-Funktion. + +**Nicht:** Meditations-App mit Journaling. + +**Nicht:** Chatbot mit persönlichem Gedächtnis. + +**Sondern:** Ein langfristiger, dialogischer Reflexionsbegleiter, der Journaling, Achtsamkeit und Meditation als Werkzeuge verwendet. + +--- + +## 5.2 Rolle innerhalb der Produktfamilie + +Die vereinfachte Verantwortungsverteilung lautet: + +- **Mitai:** Was passiert körperlich? +- **Shinkan:** Was wird trainiert und entwickelt? +- **Kairo:** Was soll geschehen und wie wird es operationalisiert? +- **mindnet:** Was weiß und erinnert das persönliche Wissensnetz? +- **Kanshō:** Was bedeutet das Erlebte für die Person? + +Diese Zuordnung ist eine zentrale Produktgrenze. + +--- + +# 6. Kerninteraktion + +Die wichtigste Funktion von Kanshō ist nicht das Speichern eines Tagebucheintrags, sondern ein **geführter Reflexionsdialog**. + +Die App soll deshalb dialogzentriert gedacht werden. + +Ein Dialog kann beispielsweise ausgelöst werden durch: + +- ein aktuelles Erlebnis, +- einen Tagesrückblick, +- eine emotionale Reaktion, +- eine offene persönliche Frage, +- eine Erinnerung, +- ein wiederkehrendes Muster, +- einen beruflichen Konflikt, +- eine Idee, +- eine Zukunftsvision, +- eine bewusste Achtsamkeitsphase, +- eine Meditation, +- eine frühere offene Reflexion. + +Die KI soll nicht nur generische Fragen stellen, sondern den bestehenden Kontext nutzen. + +--- + +# 7. Reflexionskontexte + +Reflexionen finden in unterschiedlichen Lebensbereichen und Situationen statt. + +Bereits benannte Beispiele sind: + +- Urlaub, +- persönliche Entwicklung, +- Beruf, +- allgemeines Befinden, +- Vergangenheitsbewältigung, +- Ziele, +- Visionen, +- Inspiration, +- Kreativität. + +Diese Liste ist ausdrücklich nicht abschließend. + +Eine noch offene konzeptionelle Frage ist, ob solche Kontexte: + +1. als feste Kategorien definiert werden, +2. vollständig dynamisch entstehen, +3. oder über ein hybrides Modell organisiert werden. + +Als derzeit bevorzugte Richtung gilt ein **hybrides Modell**: + +- wenige übergeordnete Lebensräume, +- darunter dynamisch entstehende konkrete Reflexionsräume. + +Beispiele: + +- `Urlaub → Lošinj 2026` +- `Beruf → Institute` +- `Persönliche Entwicklung → Umgang mit Verlust` +- `Kreativität → neue Produktidee` +- `Familie → gemeinsames Erleben` +- `Zukunft → persönliche Vision` + +Diese Reflexionsräume sollen mit Objekten aus Kairo und Knoten aus mindnet verknüpft werden können. + +--- + +# 8. Kontextbezogener Gesprächseinstieg + +Ein neuer Dialog soll nicht mit einer beliebigen oder immer gleichen Standardfrage beginnen. + +Die Eingangsfrage soll sich aus dem vorhandenen Kontext ergeben. + +Dazu kann Kanshō beispielsweise berücksichtigen: + +- aktuellen Reflexionsraum, +- letzten Dialog in diesem Kontext, +- offene Dialogfäden, +- kürzlich gespeicherte Erlebnisse, +- relevante Einträge aus mindnet, +- Werte und Leitbild, +- zeitliche Zusammenhänge, +- ggf. Informationen anderer Jinkendo-Anwendungen. + +Ziel ist ein Einstieg, der sich wie die Fortsetzung eines bestehenden persönlichen Denkprozesses anfühlt. + +--- + +# 9. Dialogfäden + +Ein Gespräch kann mehrere Themen oder Reflexionsfäden enthalten. + +Beispiel: + +Ein Dialog beginnt im Kontext `Urlaub → Lošinj 2026`. + +Während des Gesprächs entstehen möglicherweise mehrere Fäden: + +- körperliches Befinden, +- Erholung, +- Familie, +- Arbeiten während des Urlaubs, +- persönlicher Gestaltungsdrang, +- Zukunftsfragen. + +Diese Themen sollen nicht zwangsläufig in getrennten Chats gestartet werden. + +Kanshō soll im Dialog erkennen können, wenn sich ein eigener Reflexionsfaden entwickelt. + +Mögliche Verhaltensweisen: + +- Faden zunächst nur intern markieren, +- später wieder aufnehmen, +- bei deutlicher thematischer Abzweigung eine Trennung vorschlagen, +- Faden bewusst parken, +- Faden mit vorhandenem mindnet-Kontext verbinden. + +Die KI darf die Dialogstruktur unterstützen, soll den Gesprächsfluss aber nicht unnötig fragmentieren. + +--- + +# 10. Gedächtnismodell + +Ein zentrales Ergebnis der bisherigen Konzeption ist die Erkenntnis, dass ein einziges LLM-Kontextfenster nicht ausreicht. + +Kanshō benötigt mehrere Gedächtnisebenen. + +## 10.1 Working Context + +Enthält beispielsweise: + +- aktuelle Nachrichten, +- aktuelle Frage, +- unmittelbar vorausgehende Aussagen, +- temporäre Gesprächsinformationen. + +Lebensdauer: + +- Minuten bis Stunden, +- primär für den aktuellen Dialog. + +--- + +## 10.2 Thread Memory + +Enthält: + +- Zusammenfassungen einzelner Dialogfäden, +- offene Fragen, +- Zwischenstände, +- noch nicht abgeschlossene Reflexionen, +- relevante Aussagen aus früheren Sitzungen. + +Lebensdauer: + +- Tage, +- Wochen, +- Monate, +- ggf. länger. + +--- + +## 10.3 Episodic Memory + +Enthält bedeutsame Ereignisse oder Erfahrungen wie: + +- Urlaubserlebnisse, +- Konflikte, +- Entscheidungen, +- besondere Erfahrungen, +- persönliche Wendepunkte, +- wichtige Erkenntnisse. + +Diese Informationen sind langfristig relevant und sollen in geeigneter Form in Obsidian beziehungsweise mindnet überführt werden. + +--- + +## 10.4 Self Model + +Das Self Model beschreibt nicht die spontane Interpretation der KI, sondern ein nachvollziehbares persönliches Selbstmodell. + +Mögliche Bestandteile: + +- Werte, +- Leitbild, +- Prinzipien, +- Rollen, +- langfristige Ziele, +- bestätigte persönliche Muster, +- Selbstbeschreibungen, +- wiederkehrende Spannungsfelder. + +Das Self Model soll: + +- versioniert sein, +- Herkunft und Zeitbezug einer Aussage kennen, +- Beobachtungen von Interpretationen unterscheiden, +- nicht stillschweigend von der KI verändert werden. + +--- + +## 10.5 Writing Profile + +Das Writing Profile dient dazu, dass erzeugte Texte langfristig nach der Person selbst klingen. + +Es soll mehr umfassen als ein einfaches Style Prompt. + +Mögliche Bestandteile: + +- Satzlängen, +- Satzrhythmus, +- Wortwahl, +- typische Formulierungen, +- Detailgrad, +- Aufbau von Erzählungen, +- Verhältnis zwischen Ereignisbeschreibung und Reflexion, +- Grad emotionaler Direktheit, +- bevorzugte Übergänge, +- Humor, +- typische Perspektive, +- zeitliche Erzählweise. + +Zusätzlich sollen geeignete eigene Texte als Stilreferenzen genutzt werden. + +--- + +## 10.6 Knowledge Graph / mindnet + +mindnet übernimmt die langfristige Vernetzung von Informationen. + +Dazu gehören: + +- Erfahrungen, +- Erkenntnisse, +- Beziehungen, +- Referenzen, +- Werte, +- Entscheidungen, +- wiederkehrende Themen, +- offene Zusammenhänge. + +Kanshō soll dieses Wissen gezielt abrufen und neue Erkenntnisse wieder zurückführen. + +--- + +# 11. Rolle von mindnet im kurzfristigen Dialog + +Noch nicht abschließend entschieden ist, ob mindnet als kurzfristiger Dialogspeicher geeignet ist. + +Der derzeitige konzeptionelle Stand lautet: + +**mindnet sollte wahrscheinlich nicht der primäre Working-Memory-Speicher laufender Gespräche sein.** + +Gründe dafür sind insbesondere die unterschiedlichen Anforderungen: + +Ein Dialogspeicher benötigt unter anderem: + +- exakte Reihenfolge, +- hohe Änderungsfrequenz, +- Thread-Zustände, +- lokale/offline Synchronisation, +- schnelle Wiederaufnahme, +- Branching, +- Editierbarkeit, +- Zustandsmanagement. + +mindnet ist dagegen besonders geeignet für: + +- langfristiges Wissen, +- semantische Retrieval-Prozesse, +- Beziehungen, +- Episoden, +- Erkenntnisse, +- autobiografischen Kontext. + +Die derzeit bevorzugte Verantwortungsverteilung lautet deshalb: + +> **Kanshō besitzt den Dialog.** +> **mindnet besitzt das langfristige Gedächtnis.** +> **Obsidian bildet das menschenlesbare autobiografische Archiv.** + +Diese Entscheidung ist noch technisch zu validieren. + +--- + +# 12. Offene Enden und unvollständige Zusammenhänge in mindnet + +In mindnet existieren bereits offene Enden, für die noch keine erschöpfende Kausal- oder Bedeutungskette aufgebaut wurde. + +Diese Eigenschaft kann für Kanshō besonders wertvoll sein. + +Arbeitstitel für solche offenen Stellen: + +## Reflection Frontiers + +Reflection Frontiers sind Themen, Beziehungen oder Erfahrungen, die noch nicht vollständig verstanden oder eingeordnet sind. + +Beispiele: + +- Ein Ereignis und eine Reaktion stehen nebeneinander, aber die Bedeutung ist unklar. +- Ein Wert scheint mit einer späteren Entscheidung in Spannung zu stehen. +- Mehrere Erlebnisse ähneln sich, ohne dass ein belastbares Muster bestätigt ist. +- Eine frühere Reflexion wurde nicht abgeschlossen. +- Eine Annahme über sich selbst ist noch nicht geprüft. + +Kanshō kann solche Stellen bei passendem Kontext erneut anbieten. + +--- + +# 13. Vorsicht bei Kausalität und psychologischer Interpretation + +Kanshō darf keine ungesicherten Kausalzusammenhänge als Tatsachen darstellen. + +Zu unterscheiden sind mindestens: + +- beobachtete Tatsache, +- eigene Aussage des Nutzers, +- bestätigte Erkenntnis, +- Interpretation, +- Hypothese, +- vermuteter Zusammenhang, +- offene Frage. + +Beispielsweise sollte die App nicht vorschnell speichern: + +`A verursacht B` + +sondern gegebenenfalls: + +- `A trat gemeinsam mit B auf` +- `A könnte mit B zusammenhängen` +- `B erinnert an A` +- `A steht möglicherweise in Spannung zu B` +- `Hypothese: A beeinflusst B` +- `Zusammenhang ungeklärt` + +Dies ist eine zentrale Qualitäts- und Vertrauensanforderung. + +--- + +# 14. Self Model und „Wesenskern“ + +Ein zentrales Ziel ist, dass langfristig tiefere Verbindungen zur Persönlichkeit und zum eigenen Wesenskern erkennbar werden. + +Dabei gilt jedoch eine wichtige Grenze: + +**Die KI soll keinen Wesenskern erfinden.** + +Das System soll vielmehr ein nachvollziehbares und versioniertes Selbstmodell aus belastbaren Quellen bilden. + +Informationsquellen können sein: + +- explizit formulierte Werte, +- Leitbild, +- Selbstbeschreibungen, +- bestätigte Erkenntnisse, +- frühere Reflexionen, +- dokumentierte Entscheidungen, +- längerfristig wiederkehrende Muster. + +Wird ein potenziell neues grundlegendes Muster erkannt, soll die KI es zunächst als Hypothese behandeln. + +Beispiel: + +> „In mehreren Reflexionen scheint Selbstbestimmung eine wichtige Rolle zu spielen. Das ist bisher nicht ausdrücklich Teil deines Wertemodells. Möchtest du das genauer betrachten?“ + +Eine solche Aussage wird erst nach bewusster Bestätigung Bestandteil eines stabilen Self Models. + +--- + +# 15. Persönlicher Sprach- und Schreibstil + +Ein wesentliches Produktziel lautet: + +> Von Kanshō erzeugte Texte sollen auch nach Jahren noch vertraut wirken und sich wie eigene Texte lesen. + +Die App soll deshalb nicht die typischen Merkmale generischer KI-Texte reproduzieren. + +Kanshō soll sich an Ausdruck, Struktur und Erzählweise der Person angleichen. + +Dazu sollen nicht nur formale Stilregeln genutzt werden, sondern vor allem: + +- eigene frühere Texte, +- thematisch vergleichbare Tagebucheinträge, +- persönliche Formulierungen, +- bestätigte Stilpräferenzen, +- langfristige stilistische Entwicklung. + +Der persönliche Stil darf sich über Jahre verändern. Deshalb sollte das Writing Profile ebenfalls versionierbar beziehungsweise zeitabhängig sein. + +--- + +# 16. Zweistufige Generierung von Tagebucheinträgen + +Für generierte Tagebucheinträge wird ein zweistufiges Modell bevorzugt. + +## Stufe 1 – Bedeutung und Inhalt rekonstruieren + +Zuerst wird bestimmt: + +- Was ist tatsächlich passiert? +- Was wurde ausdrücklich gesagt? +- Was wurde empfunden? +- Welche Erkenntnisse wurden im Dialog entwickelt? +- Welche Aussagen sind Interpretation oder Hypothese? +- Welche Aspekte sollen überhaupt Teil des Tagebucheintrags sein? + +Diese Stufe dient insbesondere der inhaltlichen Wahrhaftigkeit. + +## Stufe 2 – Persönliche Narration + +Erst danach wird aus den bestätigten Inhalten ein persönlicher Text erzeugt. + +Dabei werden verwendet: + +- Writing Profile, +- passende eigene Texte, +- Kontext des Erlebnisses, +- gewünschter Detailgrad, +- zeitliche Perspektive. + +Damit werden Inhaltstreue und sprachliche Gestaltung bewusst getrennt. + +--- + +# 17. Ergebnisse eines Reflexionsdialogs + +Ein Dialog kann mehrere unterschiedliche Ergebnisse erzeugen. + +Diese Ergebnisse müssen voneinander getrennt behandelt werden. + +## 17.1 Journal Entry + +Ein menschenlesbarer autobiografischer Text. + +Zielsystem: + +- primär Obsidian, +- damit indirekt mindnet. + +--- + +## 17.2 Reflection Memory + +Eine verdichtete, aber nachvollziehbare Erkenntnis aus einer Reflexion. + +Beispiele: + +- persönliche Einsicht, +- wiederkehrendes Thema, +- bestätigte Beobachtung. + +Zielsystem: + +- mindnet. + +--- + +## 17.3 Knowledge Delta + +Eine neue oder geänderte Beziehung im persönlichen Wissensnetz. + +Beispiele: + +- neue Verbindung zwischen Erlebnis und Wert, +- neue Referenz, +- korrigierte frühere Annahme, +- neue Hypothese. + +Zielsystem: + +- mindnet. + +--- + +## 17.4 Action Candidate + +Aus einer Reflexion kann eine konkrete Handlungsabsicht entstehen. + +Beispiele: + +- neues Ziel, +- Ritual, +- Experiment, +- Aufgabe, +- persönlicher Entwicklungsschritt. + +Zielsystem: + +- Kairo. + +Kanshō soll diese Handlungsabsicht erkennen und zur Übernahme anbieten. + +Kanshō selbst wird dadurch nicht zum Aufgaben- oder Projektmanager. + +--- + +# 18. Geplanter Funktionsumfang + +Der bisher genannte Funktionsumfang umfasst mindestens folgende Bereiche. + +## 18.1 Tägliche Reflexion + +- geführter Tagesrückblick, +- kontextbezogene Einstiegsfrage, +- Dialog statt starrem Formular, +- Erkennen offener Themen, +- Abschluss mit optionalem Tagebucheintrag, +- Überführung relevanter Erkenntnisse in mindnet. + +--- + +## 18.2 Tagebuch + +Als Referenzrahmen wurde ein Funktionsniveau ähnlich hochwertiger Journaling-Anwendungen genannt. + +Der genaue Funktionsumfang wird später spezifiziert. + +Erwartbare Bereiche sind unter anderem: + +- Tagebucheinträge, +- Text, +- Spracheingabe, +- Medien, +- Zeitbezug, +- Suche, +- Rückblick, +- Kontext, +- Verknüpfungen, +- langfristige Historie. + +Wichtig: + +Das Tagebuch bleibt Teil der Reflexionsarchitektur und wird nicht zur alleinigen Produktidentität. + +--- + +## 18.3 Geführte Meditation + +Kanshō soll geführte Meditation unterstützen. + +Noch offen ist, welche Formen darunter fallen: + +- klassische vorgefertigte Meditation, +- KI-generierte Meditation, +- personalisierte Meditation aus aktuellem Kontext, +- Follow-up-Reflexion nach Meditation, +- Atem- und Achtsamkeitsübungen, +- kurze situative Interventionen. + +Dieser Funktionsbereich wird separat konzipiert. + +--- + +## 18.4 Achtsamkeit + +Achtsamkeit soll nicht nur als Entspannungsfunktion verstanden werden. + +Mögliche Ausprägungen: + +- bewusste Wahrnehmung, +- kurze Check-ins, +- emotionale und körperliche Selbstwahrnehmung, +- situative Reflexion, +- nicht wertendes Beobachten, +- Unterbrechung automatischer Reaktionsmuster. + +Eine genaue Definition des Achtsamkeitsverständnisses von Kanshō steht noch aus. + +--- + +## 18.5 Langfristiger Reflexionsdialog + +Kanshō soll Reflexionen über längere Zeiträume fortsetzen können. + +Dazu gehören: + +- Wiederaufnahme alter Fäden, +- Erkennen wiederkehrender Themen, +- zeitliche Entwicklung, +- Vergleich früherer und heutiger Perspektiven, +- Reflexion über Monate und Jahre. + +--- + +# 19. Technische Grundanforderungen + +Bereits festgehalten wurden folgende technische Anforderungen. + +## 19.1 PWA + +Kanshō wird als Progressive Web App umgesetzt. + +--- + +## 19.2 Mobile First + +Die primäre Nutzung wird auf dem Smartphone erwartet. + +Daraus folgt: + +- mobile-first UX, +- schnelle Öffnung, +- geringe Einstiegshürde, +- gute Spracheingabe, +- kurze situative Interaktionen, +- gleichzeitig Unterstützung längerer Reflexionsgespräche. + +--- + +## 19.3 Responsive Desktop-Nutzung + +Trotz Mobile-First-Ansatz muss eine vollwertige Desktop-Nutzung möglich sein. + +Desktop kann insbesondere für folgende Situationen wichtig werden: + +- längere Texte, +- Rückblicke, +- tiefe Reflexionen, +- Suche, +- Lesen älterer Einträge, +- strukturierte Auswertung. + +--- + +## 19.4 Offline-Fähigkeit + +Die App soll offline nutzbar sein. + +Noch zu entscheiden ist: + +- welche Funktionen vollständig offline laufen, +- welche KI-Funktionen online benötigen, +- wie Dialoge lokal zwischengespeichert werden, +- wie Synchronisation und Konflikte behandelt werden, +- ob lokale Modelle für ausgewählte Funktionen genutzt werden. + +--- + +## 19.5 Transkription + +Spracheingabe und Transkription sind zentrale technische Funktionen. + +Insbesondere auf dem Smartphone soll Reflexion nicht zwingend Tippen erfordern. + +Noch offen: + +- Live-Transkription oder nachträgliche Transkription, +- lokal oder serverseitig, +- Bearbeitung vor Speicherung, +- Sprecher-/Pausenlogik, +- Umgang mit langen Audioaufnahmen. + +--- + +## 19.6 Integration in die Jinkendo-Familie + +Kanshō soll mit den bestehenden Anwendungen verbunden werden. + +Mindestens relevant sind: + +- Kairo, +- mindnet, +- Obsidian, +- Shinkan, +- Mitai. + +Die Integrationen sollen nicht nur technische Datenverbindungen sein, sondern der jeweiligen Produktverantwortung folgen. + +--- + +# 20. Integrationsprinzipien + +## 20.1 Kairo + +Kanshō kann: + +- relevante Ziele oder Entwicklungskontexte lesen, +- Handlungsabsichten erkennen, +- Action Candidates erzeugen, +- Übergabe an Kairo anbieten. + +Kanshō übernimmt keine dauerhafte Aufgaben- oder Zielverwaltung. + +--- + +## 20.2 mindnet + +Kanshō kann: + +- relevantes persönliches Wissen abrufen, +- Werte und Leitbild einbeziehen, +- frühere Erfahrungen finden, +- ähnliche Themen erkennen, +- offene Zusammenhänge aufnehmen, +- neue Reflection Memories erzeugen, +- Knowledge Deltas vorschlagen. + +--- + +## 20.3 Obsidian + +Obsidian soll weiterhin eine zentrale menschenlesbare Wissens- und Tagebuchbasis darstellen. + +Kanshō soll insbesondere: + +- Tagebucheinträge erzeugen, +- strukturierte Reflexionen ablegen, +- bestehende Inhalte referenzieren, +- kein proprietäres geschlossenes Archiv erzeugen. + +Der genaue Ablage- und Synchronisationsmechanismus ist noch zu bestimmen. + +--- + +## 20.4 Shinkan + +Shinkan kann Kontext liefern, wenn Reflexionen mit Training oder persönlicher Entwicklung im Training zusammenhängen. + +Kanshō übernimmt keine Trainingsplanung. + +--- + +## 20.5 Mitai + +Mitai kann – bei entsprechendem Kontext und Berechtigung – körperliche oder gesundheitsbezogene Informationen liefern. + +Kanshō übernimmt kein Vital-, Ernährungs- oder Gesundheitstracking. + +--- + +# 21. Produktprinzipien + +Aus dem bisherigen Dialog lassen sich folgende Leitprinzipien ableiten. + +## 21.1 Dialog vor Formular + +Reflexion soll als Gespräch stattfinden und nicht primär als Checkliste. + +## 21.2 Kontext vor generischer Frage + +Fragen entstehen aus dem persönlichen und situativen Kontext. + +## 21.3 Erinnerung mit Herkunft + +Langfristige Aussagen müssen nachvollziehbar sein. + +## 21.4 Hypothese statt künstlicher Gewissheit + +Die KI darf Zusammenhänge anbieten, aber nicht erfinden. + +## 21.5 Mensch entscheidet über Identität + +Grundlegende Aussagen über Werte, Persönlichkeit und Wesenskern werden nicht stillschweigend festgeschrieben. + +## 21.6 Persönliche Sprache statt KI-Stil + +Generierte Texte sollen die Ausdrucksweise der Person erhalten. + +## 21.7 Reflection before Action + +Erst verstehen, dann gegebenenfalls handeln. + +## 21.8 Keine Funktionsduplikation + +Andere Jinkendo-Produkte behalten ihre jeweiligen Verantwortlichkeiten. + +## 21.9 Menschenlesbares Langzeitarchiv + +Wichtige Inhalte sollen nicht ausschließlich in proprietären internen Datenstrukturen existieren. + +## 21.10 Langfristige Kontinuität + +Das System soll über Monate und Jahre eine nachvollziehbare persönliche Entwicklung unterstützen. + +--- + +# 22. Bewusste Nicht-Ziele + +Kanshō soll derzeit ausdrücklich nicht zu folgenden Produkten werden: + +- Projektmanagementsystem, +- Aufgabenmanager, +- Gesundheits- oder Fitness-Tracker, +- Trainingsplanungsanwendung, +- reines digitales Tagebuch, +- ausschließlich Meditations-App, +- generischer KI-Chat, +- automatischer psychologischer Diagnostiker, +- System, das ungesicherte Persönlichkeitsprofile erzeugt. + +--- + +# 23. Noch offene Kernfragen + +Die folgenden Punkte sind bewusst noch nicht entschieden. + +1. Genaue Struktur der Reflection Spaces. +2. Feste Kategorien versus dynamische Kontexte. +3. Lebenszyklus von Dialogfäden. +4. Technisches Working-Memory-Modell. +5. Datenbank für laufende Dialoge. +6. Synchronisation und Offline-Architektur. +7. Umfang und Rolle lokaler KI. +8. genaue Integration mit Obsidian. +9. Schema für Reflection Memories. +10. Schema für Knowledge Deltas. +11. Versionierung des Self Models. +12. Mechanismus zur Nutzerbestätigung persönlicher Hypothesen. +13. Aufbau und Training des Writing Profiles. +14. Umgang mit widersprüchlichen Erinnerungen. +15. zeitliche Gewichtung alter Informationen. +16. Vergessen, Löschen und Datenschutz. +17. genaue Journaling-Funktionen. +18. Meditationskonzept. +19. Achtsamkeitskonzept. +20. Mobile UX. +21. Spracheingabe und Transkription. +22. Rolle anderer Jinkendo-Anwendungen im Context Builder. +23. Agenten- und Prompt-Architektur. +24. technische API- und Event-Integration. +25. Sicherheits- und Krisengrenzen. +26. Produktname und Branding. + +--- + +# 24. Aktueller Entscheidungsstand + +| Thema | Entscheidung / Arbeitsstand | Status | +|---|---|---| +| Produktidentität | Personal Reflection Companion | entschieden | +| Kerninteraktion | geführter KI-Reflexionsdialog | entschieden | +| Tagebuch | wichtiges Werkzeug, aber nicht Produktkern | entschieden | +| Meditation | wichtiger Funktionsbereich | grundsätzlich vorgesehen | +| Achtsamkeit | wichtiger Funktionsbereich | grundsätzlich vorgesehen | +| Mobile | Mobile First | entschieden | +| Desktop | responsive PWA | entschieden | +| Offline | erforderlich | entschieden, Ausprägung offen | +| Transkription | erforderlich | entschieden, Ausprägung offen | +| mindnet | langfristiges Gedächtnis / Retrieval | bevorzugte Richtung | +| Obsidian | menschenlesbares Langzeitarchiv | bevorzugte Richtung | +| kurzfristiger Dialogspeicher | wahrscheinlich nicht mindnet | Hypothese / zu validieren | +| Dialogfäden | mehrere Threads innerhalb eines Gesprächs möglich | entschieden | +| Thread-Trennung | KI darf Trennung vorschlagen | entschieden | +| Self Model | versioniert und bestätigungsorientiert | entschieden | +| Kausalität | Beobachtung, Hypothese und bestätigte Erkenntnis trennen | entschieden | +| Writing Profile | eigener langfristiger Bestandteil | entschieden | +| Tagebuchgenerierung | Inhalt/Bedeutung und Stil getrennt erzeugen | bevorzugte Richtung | +| Action Candidates | Übergabe an Kairo | entschieden | +| Produktname Kanshō | Arbeitstitel | offen | + +--- + +# 25. Arbeitsdefinition + +Die derzeitige Arbeitsdefinition lautet: + +> **Kanshō ist der persönliche KI-Reflexionsbegleiter innerhalb der Jinkendo-Plattform. Er hilft einem Menschen, Erlebnisse, Gedanken, Gefühle und Wahrnehmungen bewusst zu erfassen, in einem kontinuierlichen und kontextbezogenen Dialog zu reflektieren, mit seinem langfristigen persönlichen Wissens- und Wertemodell zu verbinden und daraus nachvollziehbare Erkenntnisse über sich und seine Entwicklung entstehen zu lassen.** + +Diese Definition ist eine Baseline für die weitere Produktkonzeption und darf später geändert werden, sollte aber nicht ohne dokumentierte Entscheidung stillschweigend verkürzt oder ersetzt werden.