From 548a4db9f8c697c07512c406b8d6325c93045013 Mon Sep 17 00:00:00 2001 From: Lars Date: Wed, 19 Aug 2026 09:44:15 +0200 Subject: [PATCH] =?UTF-8?q?Lokales=20Cursor-Setup=20und=20Gitignore=20erg?= =?UTF-8?q?=C3=A4nzen,=20damit=20Konzeptarbeit=20reproduzierbar=20weiterge?= =?UTF-8?q?f=C3=BChrt=20werden=20kann.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .cursor/rules/kansho-documentation.mdc | 23 ++++++++ .cursor/rules/kansho-privacy-guardrails.mdc | 26 +++++++++ .cursor/rules/kansho-product-identity.mdc | 26 +++++++++ .gitignore | 38 +++++++++++++ AGENTS.md | 30 +++++++++++ README.md | 59 +++++++++++++++++++++ 6 files changed, 202 insertions(+) create mode 100644 .cursor/rules/kansho-documentation.mdc create mode 100644 .cursor/rules/kansho-privacy-guardrails.mdc create mode 100644 .cursor/rules/kansho-product-identity.mdc create mode 100644 .gitignore create mode 100644 AGENTS.md create mode 100644 README.md diff --git a/.cursor/rules/kansho-documentation.mdc b/.cursor/rules/kansho-documentation.mdc new file mode 100644 index 0000000..667f565 --- /dev/null +++ b/.cursor/rules/kansho-documentation.mdc @@ -0,0 +1,23 @@ +--- +description: Fachdokumentation nicht verdichten, Context Bundles nutzen +globs: docs/**/*.md +alwaysApply: false +--- + +# Kanshō – Dokumentation + +`fachliche_zielarchitektur.md` ist das führende Referenzdokument. Jedes Thema hat ein kanonisches Home; nicht duplizieren, sondern verlinken. + +## Änderungen + +- Keine stillschweigende Kürzung oder Löschung. +- Ergänzen, explizit ersetzen, als überholt kennzeichnen oder Decision Record. +- Dateinamen bleiben stabil, ohne Versionsnummern im Namen. +- Frontmatter mindestens: Titel, Version/Status, Datum, document_role. +- Status klar halten: Entschieden / Bevorzugte Richtung / Hypothese / Offen / Verworfen. + +## Kontext laden + +Nicht alle Kapitel gleichzeitig. Bundles stehen in `documentation_index.md`. + +Querschnittsinvarianten nicht abschwächen: Context Fidelity, Resurfacing/Saturation, Point-in-Time Self, Privacy Gateway. diff --git a/.cursor/rules/kansho-privacy-guardrails.mdc b/.cursor/rules/kansho-privacy-guardrails.mdc new file mode 100644 index 0000000..e3046d6 --- /dev/null +++ b/.cursor/rules/kansho-privacy-guardrails.mdc @@ -0,0 +1,26 @@ +--- +description: Privacy Gateway – Identität lokal, kein direkter AI-Egress +alwaysApply: true +--- + +# Kanshō – Privacy Guardrails + +Invariante: Identität bleibt lokal. Externe Intelligenz erhält nur den notwendigen, minimierten, soweit sinnvoll pseudonymisierten Kontext. + +## Verbindlich + +- Persönlicher Kontext nie direkt an OpenRouter, Provider oder Tools senden. +- Alle persönlichen AI-Aufrufe über eine lokale Privacy-Gateway-/Egress-Schicht. +- Identity Mapping, Klarnamen, Secrets und vollständige Primärquellen bleiben in der Local Trusted Zone. +- Für persönliche Kontexte: Zero Data Retention, kein Provider-Training, kein Prompt-Logging. +- Fail Closed: kein stillschweigender Fallback auf unsichere Provider. +- LLM-Egress und Tool-/Web-Egress sind getrennte Policies. +- Antworten lokal validieren und erst dann demaskieren. + +## Datenklassen + +- A Local Only: Mapping, Secrets, vollständige Identität +- B Pseudonymized AI Context: Normalfall für Dialoge +- C Low-Identity: generische, nicht-personalisierte Inhalte + +Platzhalter wie `[[SELF]]` oder `[[PERSON:PARTNER]]` statt sprechender Aliase. Quelle: `docs/architecture/functional/guardrails.md` diff --git a/.cursor/rules/kansho-product-identity.mdc b/.cursor/rules/kansho-product-identity.mdc new file mode 100644 index 0000000..778c38d --- /dev/null +++ b/.cursor/rules/kansho-product-identity.mdc @@ -0,0 +1,26 @@ +--- +description: Kanshō-Produktidentität, Prinzipien und Nicht-Ziele +alwaysApply: true +--- + +# Kanshō – Produktidentität + +Kanshō ist ein langfristiger persönlicher Reflexionsbegleiter (Personal Reflection Companion) in der Jinkendo-Familie. Kern: Wahrnehmen → Reflektieren → Verstehen → Einordnen. + +Nicht bauen oder vorschlagen als: Tagebuch-App mit KI, Meditations-App, Mood Tracker, generischer Chatbot, Aufgabenmanager, Fitness-Tracker oder automatischer psychologischer Diagnostiker. + +## Prinzipien + +- Dialog vor Formular; Kontext vor generischer Frage. +- Hypothese statt künstlicher Gewissheit; Mensch entscheidet über Identität. +- Reflection before Action; Action Candidates gehen an Kairo, nicht in Kanshō-To-dos. +- Einfache UX, intern differenzierte Modelle. Keine Vereinfachung nur weil Implementierung leichter wird. +- Primäre Startlogik: Kontinuität des Dialogs, kein Funktions-Dashboard. + +## Technik (entschieden, Stack offen) + +PWA, Mobile First, responsive Desktop, Offline und Transkription sind Anforderungen. UI-Framework, Datenbank und KI-Runtime nicht stillschweigend festlegen. + +## Quelle + +Details: `docs/architecture/functional/produktvision_und_produktidentitaet.md` diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..d0a0d89 --- /dev/null +++ b/.gitignore @@ -0,0 +1,38 @@ +# Dependencies +node_modules/ +.pnp +.pnp.js + +# Build / cache +dist/ +build/ +.vite/ +.turbo/ +.cache/ +coverage/ +*.tsbuildinfo + +# Environment and secrets +.env +.env.* +!.env.example +*.pem +*.key + +# Logs +logs/ +*.log +npm-debug.log* + +# OS / editor +.DS_Store +Thumbs.db +*.swp +.idea/ +.vscode/* +!.vscode/extensions.json + +# Test / local data +tmp/ +temp/ +data/local/ diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8c54d33 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,30 @@ +# Kanshō – Agentenleitfaden + +Kanshō ist der dialogische Reflexionsraum der Jinkendo-Familie. Die fachliche Dokumentation in `docs/architecture/functional/` ist führend. Code folgt der Facharchitektur, nicht umgekehrt. + +## Vor jeder größeren Arbeit + +1. `documentation_index.md` lesen und nur das passende Context Bundle laden. +2. Root-Dokumente plus 2–4 betroffene Fachkapitel, nicht den ganzen Ordner. +3. Statuswörter ernst nehmen: Entschieden, Bevorzugte Richtung, Hypothese, Offen, Verworfen. + +## Produktgrenzen + +Kanshō beantwortet: **Was bedeutet das Erlebte für die Person?** + +Andere Produkte behalten ihre Verantwortung: + +- Mitai: körperliches Geschehen +- Shinkan: Training und Entwicklung +- Kairo: Planung und Operationalisierung +- mindnet: persönliches Wissensnetz + +Keine Aufgabenverwaltung, kein Fitness-Tracker, keine psychologische Diagnose, kein stillschweigendes Persönlichkeitsprofil. + +## Dokumentieren + +Bestehende Kapitel nicht stillschweigend kürzen. Änderungen additiv, explizit oder als Decision Record. Dateinamen bleiben stabil. + +## Privacy + +Identität bleibt lokal. Persönlicher Kontext geht nie direkt an externe Modelle. Details: `guardrails.md`. diff --git a/README.md b/README.md new file mode 100644 index 0000000..015cd74 --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +# Kanshō + +Persönlicher KI-Reflexionsbegleiter innerhalb der Jinkendo-Produktfamilie. + +> Wahrnehmen → Reflektieren → Verstehen → Einordnen + +Kanshō ist **kein** Tagebuch mit KI, keine Meditations-App und kein generischer Chatbot. Die Produktidentität ist ein langfristiger, dialogischer Reflexionsbegleiter. Journaling, Achtsamkeit und Meditation sind Werkzeuge, nicht der Kern. + +## Aktueller Stand + +Dieses Repository enthält derzeit die **fachliche Konzeption**. Es gibt noch keine Anwendungs-Codebasis. + +| Bereich | Stand | +|---|---| +| Produktidentität | entschieden: Personal Reflection Companion | +| Technische Form | entschieden: PWA, Mobile First, Offline, Transkription | +| Fachliche Doku | Baseline in `docs/architecture/functional/` | +| App / MVP | noch nicht begonnen | + +Remote: [gitea.stommer.de/Lars/Kansho](https://gitea.stommer.de/Lars/Kansho.git) + +## Dokumentation zuerst laden + +Nicht alle Kapitel gleichzeitig in den Kontext ziehen. Der Index beschreibt sinnvolle Bundles: + +- `docs/architecture/functional/documentation_index.md` + +Führende Root-Dokumente: + +1. `docs/architecture/functional/fachliche_zielarchitektur.md` +2. `docs/architecture/functional/produktvision_und_produktidentitaet.md` +3. `docs/architecture/functional/interview_plan.md` + +Nächster Konzeptblock: Abschluss und Outputs der **Tagesreflexion** (siehe Interviewplan). + +## Lokal weiterarbeiten + +```powershell +git pull +``` + +Änderungen nach Gitea: + +```powershell +git add . +git commit -m "Kurze Begründung, warum die Änderung nötig ist" +git push +``` + +## Cursor / Vibe Coding + +Projektregeln liegen in `.cursor/rules/` und in `AGENTS.md`. Sie halten Produktgrenzen, Dokumentationsprinzipien und Privacy-Guardrails im Agenten-Kontext. + +Noch **nicht** entschieden und deshalb nicht stillschweigend festlegen: + +- UI-Framework / konkreter PWA-Stack +- Datenbank und Sync +- genaue Offline-/KI-Ausprägung +- MVP-Schnitt