Update .gitignore to exclude Python-related files and directories. Enhance AGENTS.md and README.md with clarifications on documentation structure and product identity. Add technical architecture references and local setup instructions. Revise privacy guardrails and product identity documents for consistency. Remove obsolete memory and context documentation. Expand reflection spaces documentation to define context boundaries and lifecycle. Ensure all changes align with the ongoing development of the Kanshō project.
This commit is contained in:
1 parent
3a367b7bcc
commit
d62673e48b
89 files changed
+13463
-241
No files matched your search
@@ -222,3 +222,276 @@ eine relevante Aussage oder Zusammenfassung basiert.
|
||||
|
||||
Dieses **Aufklappen** ist eine Transparenzfunktion für den Nutzer und ist fachlich von dem internen Re-Grounding der KI zu unterscheiden.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Reflection Space als primäre Kontextgrenze
|
||||
|
||||
**Status: fachliche Baseline entschieden**
|
||||
|
||||
Reflection Spaces dienen nicht nur der langfristigen Organisation von Reflexionsinhalten. Sie bilden im normalen Dialog auch die bevorzugte fachliche Kontextgrenze.
|
||||
|
||||
Für die laufende Nutzung gilt deshalb:
|
||||
|
||||
> **Kanshō arbeitet standardmäßig innerhalb des aktuellen Reflection Space und erweitert diesen Kontext nur bei konkreter fachlicher Relevanz um tieferes Langzeitgedächtnis oder mindnet.**
|
||||
|
||||
Damit bleibt die primäre Nutzung auf den aktuellen Reflexionszusammenhang fokussiert.
|
||||
|
||||
Beispiele:
|
||||
|
||||
- Bei einem Urlaubstagebuch kann `Lošinj 2026` der aktuelle Reflection Space sein.
|
||||
- Bei einer längerfristigen Entwicklung kann `Meine Meditationsreise` ein eigener Reflection Space sein.
|
||||
- Bei einer beruflichen Reflexion kann ein konkreter Space wie `Institute` oder `Berufliche Neuorientierung` den aktuellen Kontext bilden.
|
||||
|
||||
Ein Reflection Space ist damit zugleich:
|
||||
|
||||
- ein Bedeutungsraum,
|
||||
- eine Orientierungshilfe,
|
||||
- eine Kontinuitätsstruktur,
|
||||
- eine bevorzugte Kontextgrenze für den laufenden Dialog.
|
||||
|
||||
Er ist jedoch kein exklusiver Container und kein technischer Prompt.
|
||||
|
||||
---
|
||||
|
||||
## Primary und Related Reflection Spaces
|
||||
|
||||
**Status: fachliche Baseline entschieden**
|
||||
|
||||
Eine Session beziehungsweise ein Dialog kann einen **Primary Reflection Space** besitzen und gleichzeitig mit weiteren **Related Reflection Spaces** verbunden sein.
|
||||
|
||||
Der Primary Reflection Space ist der Raum, der den aktuellen Dialog fachlich am stärksten trägt.
|
||||
|
||||
Related Reflection Spaces sind weitere längerfristige Kontexte, die durch einzelne Experiences, Threads, offene Fragen oder Insights berührt werden.
|
||||
|
||||
Beispiel:
|
||||
|
||||
Ein Nutzer schreibt während eines Urlaubs:
|
||||
|
||||
> „Gestern habe ich meinen Urlaubstag dazu genutzt, tief zu meditieren. Dabei hatte ich erstmals das Gefühl, meinen Körper zu verlassen. Das war eine tiefgreifende Erfahrung.“
|
||||
|
||||
Für den unmittelbaren Journaling-Dialog kann gelten:
|
||||
|
||||
- Primary Reflection Space: `Lošinj 2026`
|
||||
- Related Reflection Space: `Meine Meditationsreise`
|
||||
|
||||
Das Erlebnis selbst wird dadurch nicht dupliziert.
|
||||
|
||||
Verbindliche Regel:
|
||||
|
||||
> **Eine Reflexion kann mehrere Spaces berühren, ohne dass ihre Quellen oder fachlichen Kernobjekte mehrfach angelegt werden.**
|
||||
|
||||
---
|
||||
|
||||
## Identity ist nicht Assignment
|
||||
|
||||
**Status: entschieden**
|
||||
|
||||
Die fachliche Identität eines Objekts ist von seiner Zuordnung zu Reflection Spaces zu trennen.
|
||||
|
||||
Eine Experience, ein Thread, eine Open Question oder ein Insight kann Beziehungen zu mehreren Reflection Spaces besitzen.
|
||||
|
||||
Beispiele:
|
||||
|
||||
- eine Experience kann gleichzeitig zu Urlaub und Meditation relevant sein,
|
||||
- ein Thread kann sowohl persönliche Entwicklung als auch Beruf berühren,
|
||||
- eine Open Question kann mehrere längerfristige Reflexionsräume verbinden.
|
||||
|
||||
Daraus folgt:
|
||||
|
||||
> **Mehrfachzuordnung erzeugt keine zweite Identität.**
|
||||
|
||||
Reflection Spaces organisieren Bedeutungszusammenhänge; sie besitzen keine exklusive Eigentümerschaft an den darin referenzierten Objekten.
|
||||
|
||||
---
|
||||
|
||||
## Entstehung und Promotion von Reflection Spaces
|
||||
|
||||
**Status: fachliche Baseline entschieden; konkrete Schwellenwerte offen**
|
||||
|
||||
Nicht jeder situative Kontext wird unmittelbar zu einem langlebigen Reflection Space.
|
||||
|
||||
Für die Entstehung wird derselbe allgemeine Promotion-Gedanke verwendet wie für andere langlebige Reflexionsobjekte:
|
||||
|
||||
> **Possible Context → Space Candidate → Existing Space Enrichment oder Established Reflection Space**
|
||||
|
||||
Ein neuer Reflection Space ist insbesondere dann sinnvoll, wenn ein Zusammenhang:
|
||||
|
||||
- über mehrere Interaktionen hinweg eigenständige Reflexionsrelevanz besitzt,
|
||||
- mehrere zusammenhängende Threads, Experiences, Open Questions oder Insights verbindet,
|
||||
- vom Nutzer ausdrücklich als zusammenhängender Bereich erlebt oder benannt wird,
|
||||
- über einen längeren Zeitraum fortgesetzt werden soll,
|
||||
- eine eigenständige Entwicklungs- oder Historienperspektive benötigt,
|
||||
- nicht sinnvoll in einen bereits etablierten Space integriert werden kann.
|
||||
|
||||
Verbindliche Regel:
|
||||
|
||||
> **Existing before new.**
|
||||
|
||||
Wenn ein geeigneter bestehender Reflection Space vorhanden ist, soll dieser bevorzugt angereichert werden.
|
||||
|
||||
Semantische Ähnlichkeit allein reicht jedoch nicht aus, um zwei unterschiedliche Bedeutungsräume zusammenzuführen.
|
||||
|
||||
---
|
||||
|
||||
## Unterschiedliche Typen von Reflection-Space-Entstehung
|
||||
|
||||
**Status: Arbeitsmodell**
|
||||
|
||||
Reflection Spaces können auf unterschiedliche Weise entstehen.
|
||||
|
||||
### Situativ klar abgegrenzte Spaces
|
||||
|
||||
Diese ergeben sich häufig aus einem klaren zeitlichen oder räumlichen Zusammenhang.
|
||||
|
||||
Beispiele:
|
||||
|
||||
- Urlaub,
|
||||
- Reise,
|
||||
- Seminar,
|
||||
- Projektphase,
|
||||
- klar umrissener Lebensabschnitt.
|
||||
|
||||
Ein Space wie `Lošinj 2026` kann bereits früh mit hoher Confidence erkannt werden, weil Ort, Zeitraum und wiederkehrender Kontext eine klare Klammer bilden.
|
||||
|
||||
### Longitudinal entstehende Spaces
|
||||
|
||||
Andere Reflection Spaces entstehen erst über mehrere Interaktionen hinweg.
|
||||
|
||||
Beispiele:
|
||||
|
||||
- `Meine Meditationsreise`,
|
||||
- `Umgang mit Verlust`,
|
||||
- `Meine Rolle als Vater`,
|
||||
- `Berufliche Neuorientierung`.
|
||||
|
||||
Hier kann zunächst nur ein Thread oder Space Candidate bestehen.
|
||||
|
||||
Erst wenn ausreichend Kontinuität und eigenständige Bedeutung sichtbar werden, entsteht ein etablierter Reflection Space.
|
||||
|
||||
Diese Unterscheidung beschreibt unterschiedliche Entstehungsmuster und noch keine technischen Space-Typen.
|
||||
|
||||
---
|
||||
|
||||
## Reflection-Space-Lifecycle
|
||||
|
||||
**Status: fachliche Baseline entschieden; technische State Machine offen**
|
||||
|
||||
Der Lifecycle eines Reflection Space soll bewusst schlank bleiben.
|
||||
|
||||
Mindestens folgende Zustände beziehungsweise fachliche Phasen müssen abbildbar sein:
|
||||
|
||||
- **Candidate** – möglicher eigenständiger Reflection Space,
|
||||
- **Active** – aktuell relevante und genutzte Reflexionsumgebung,
|
||||
- **Dormant** – derzeit nicht aktiv, aber weiterhin langfristig relevant,
|
||||
- **Historical / Archived** – primär historisch relevant und in der normalen Oberfläche zurückgetreten,
|
||||
- **Reactivated** – ein zuvor ruhender oder historischer Space wird erneut aktuell.
|
||||
|
||||
Dabei gilt:
|
||||
|
||||
- Dormant bedeutet nicht gelöscht.
|
||||
- Historical bedeutet nicht bedeutungslos.
|
||||
- Reaktivierung erzeugt keinen neuen Space, wenn fachlich derselbe Bedeutungsraum fortgesetzt wird.
|
||||
- Frühere Zustände und Historie bleiben nachvollziehbar.
|
||||
- Die konkrete technische Zustandsmaschine wird später festgelegt.
|
||||
|
||||
Ein Space muss nicht allein aufgrund seines Alters archiviert werden. Maßgeblich ist seine aktuelle Reflexionsrelevanz.
|
||||
|
||||
---
|
||||
|
||||
## Automatische Reflection-Space-Erkennung
|
||||
|
||||
**Status: fachliche Baseline entschieden**
|
||||
|
||||
Kanshō soll Reflection Spaces möglichst selbstständig erkennen und den Nutzer nicht zum manuellen Verwalter der Reflexionsstruktur machen.
|
||||
|
||||
Dabei gilt jedoch:
|
||||
|
||||
> **Automatische Reflection-Space-Erkennung darf nicht bedeuten, dass vor jedem Dialogturn ein eigener LLM-Analyseaufruf notwendig ist.**
|
||||
|
||||
Die Erkennung soll möglichst inkrementell und opportunistisch erfolgen.
|
||||
|
||||
Bevorzugte Signalreihenfolge:
|
||||
|
||||
1. bestehender aktiver Primary Reflection Space,
|
||||
2. aktueller Session-Kontext,
|
||||
3. Zeit- und gegebenenfalls Ortsbezug,
|
||||
4. bereits verbundene Threads, Experiences und Open Questions,
|
||||
5. bestehende Space-Beziehungen,
|
||||
6. semantische beziehungsweise Retrieval-Signale,
|
||||
7. strukturierte Einschätzung des ohnehin für die Antwort verwendeten Hauptmodells,
|
||||
8. separater Analyse-Call nur bei echter Ambiguität oder höherwertiger struktureller Neubewertung.
|
||||
|
||||
Designregel:
|
||||
|
||||
> **Space recognition should normally piggyback on existing processing rather than create an additional LLM round trip.**
|
||||
|
||||
---
|
||||
|
||||
## Confidence und Umgang mit Unsicherheit
|
||||
|
||||
**Status: fachliche Baseline entschieden; konkrete Schwellenwerte offen**
|
||||
|
||||
Kanshō darf eine Space-Zuordnung mit unterschiedlicher Sicherheit behandeln.
|
||||
|
||||
Bei hoher Confidence kann eine offensichtliche Zuordnung automatisch erfolgen.
|
||||
|
||||
Bei mittlerer Confidence kann:
|
||||
|
||||
- eine bestehende Zuordnung vorläufig verwendet,
|
||||
- ein Space Candidate geführt,
|
||||
- oder eine spätere Neubewertung vorgesehen werden.
|
||||
|
||||
Bei niedriger Confidence soll Kanshō nicht künstlich eine neue langlebige Struktur erzeugen.
|
||||
|
||||
Der Nutzer soll nur dann mit einer Rückfrage belastet werden, wenn die Zuordnung für die Reflexion tatsächlich relevant ist und nicht sinnvoll im Hintergrund korrigierbar bleibt.
|
||||
|
||||
Verbindliche Regel:
|
||||
|
||||
> **Unsicherheit rechtfertigt Zurückhaltung, nicht automatisch eine Rückfrage.**
|
||||
|
||||
---
|
||||
|
||||
## Reflection Space und Context Builder
|
||||
|
||||
**Status: entschieden als Querschnittsregel**
|
||||
|
||||
Die kanonische Context-Builder-Logik wird in `memory_and_context.md` geführt.
|
||||
|
||||
Für Reflection Spaces gilt daraus abgeleitet:
|
||||
|
||||
- der Primary Reflection Space wird bevorzugt als Reflection Context verwendet,
|
||||
- Related Spaces werden nur situativ aktiviert,
|
||||
- tieferes Long-Term Memory wird nicht standardmäßig geladen,
|
||||
- mindnet erweitert den Space nur bei konkreter Relevanz,
|
||||
- die Space-Struktur dient der Kontextfokussierung und darf nicht selbst zur Quelle unnötiger Prompt-Vergrößerung werden.
|
||||
|
||||
Leitprinzip:
|
||||
|
||||
> **Reflection Space first, Long-Term Memory on demand.**
|
||||
|
||||
---
|
||||
|
||||
## Aktualisierter Stand der offenen Punkte
|
||||
|
||||
**Status: Arbeitsstand nach Lifecycle- und Context-Klärung**
|
||||
|
||||
Weiter offen beziehungsweise bewusst später zu klären sind insbesondere:
|
||||
|
||||
1. konkrete Schwellenwerte für Space Promotion, Merge und Reaktivierung,
|
||||
2. die genaue technische Repräsentation von Primary- und Related-Space-Beziehungen,
|
||||
3. konkrete UI-Regeln für automatische versus sichtbare Space-Zuordnung,
|
||||
4. die spätere Integration mit dem finalen Usage-/Intent-Modell,
|
||||
5. technische Event-/State-Modelle für Lifecycle-Änderungen,
|
||||
6. konkrete Governance-Regeln für automatische Konsolidierung oder Merge,
|
||||
7. die genaue technische Zusammenarbeit zwischen Context Builder und Space-Erkennung.
|
||||
|
||||
Nicht mehr grundsätzlich offen sind:
|
||||
|
||||
- ob Reflection Spaces nur Ablageorte oder aktive Reflexionskontexte sind,
|
||||
- ob eine Session mehreren Spaces zugeordnet sein kann,
|
||||
- ob Mehrfachzuordnung Duplikation erzeugt,
|
||||
- ob jeder situative Kontext automatisch einen Space erzeugt,
|
||||
- ob jeder Turn einen separaten Space-Erkennungs-Call benötigt,
|
||||
- ob ruhende Spaces gelöscht oder neu angelegt werden müssen,
|
||||
- ob bestehende Spaces gegenüber neuen bevorzugt werden sollen.
|
||||
Reference in new issue
Block a user