Lokales Cursor-Setup und Gitignore ergänzen, damit Konzeptarbeit reproduzierbar weitergeführt werden kann.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Lars 2026-08-19 09:44:15 +02:00
parent 58321f7ee7
commit 548a4db9f8
6 changed files with 202 additions and 0 deletions

View File

@ -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.

View File

@ -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`

View File

@ -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`

38
.gitignore vendored Normal file
View File

@ -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/

30
AGENTS.md Normal file
View File

@ -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 24 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`.

59
README.md Normal file
View File

@ -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