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:
parent
58321f7ee7
commit
548a4db9f8
23
.cursor/rules/kansho-documentation.mdc
Normal file
23
.cursor/rules/kansho-documentation.mdc
Normal 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.
|
||||||
26
.cursor/rules/kansho-privacy-guardrails.mdc
Normal file
26
.cursor/rules/kansho-privacy-guardrails.mdc
Normal 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`
|
||||||
26
.cursor/rules/kansho-product-identity.mdc
Normal file
26
.cursor/rules/kansho-product-identity.mdc
Normal 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
38
.gitignore
vendored
Normal 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
30
AGENTS.md
Normal 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 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`.
|
||||||
59
README.md
Normal file
59
README.md
Normal 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
|
||||||
Loading…
Reference in New Issue
Block a user