2170b23348
Complete rename of "swift" terminology to "cortex" across the codebase: Code Changes: - Rename directories: lib/swift → lib/cortex, components/swift → components/cortex - Rename API routes: /api/swift/* → /api/cortex/* - Rename page routes: /epd/swift → /epd/cortex - Rename store: swift-store.ts → cortex-store.ts Type Renames: - SwiftIntent → CortexIntent - SwiftStore → CortexStore - useSwiftStore → useCortexStore - SwiftContext → CortexContext - useSwiftVoice → useCortexVoice Documentation Updates (docs/intent/): - Safety Net → Nudge (Layer 3 rename) - SafetySuggestion → NudgeSuggestion - evaluateSafetyNet → evaluateNudge - SWIFT_* feature flags → CORTEX_* - All path references updated to match new structure Files affected: 47 files, ~700 lines changed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
87 lines
3.4 KiB
Markdown
87 lines
3.4 KiB
Markdown
# Architecture Proposal: Swift Intent System V2
|
|
|
|
**Status:** Draft
|
|
**Based on:**
|
|
- `ux-evaluation-intent-scalability.md` (The "Don't make me think" rule)
|
|
- `ux-simulation-intent-next-level.md` (The "Be my partner" wish)
|
|
|
|
---
|
|
|
|
## 1. The Triad Consensus (PO, UX, Dev)
|
|
|
|
De PO, UX en Lead Developer hebben de bevindingen geanalyseerd. Dit is de gezamenlijke conclusie:
|
|
|
|
> **"We stoppen met optimaliseren voor milliseconden (Pre-optimization) en starten met optimaliseren voor intelligentie (Agentic UI)."**
|
|
|
|
* **PO:** "Akkoord met hogere 'cost per interaction' (AI tokens) als dit directe tijdwinst oplevert voor de zorgverlener (minder administratie)."
|
|
* **UX:** "De interface moet 'Invisible' worden. Geen commando's leren, maar intenties uitspreken."
|
|
* **Dev:** "De huidige 'Strict Hierarchy' (Strategie 1) is te rigide. We gaan voor een **Hybrid Leader/Follower architectuur**: Lokale snelheid waar kan, AI intelligentie waar moet."
|
|
|
|
---
|
|
|
|
## 2. Core Architecture: "The Swift Cortex"
|
|
|
|
We vervangen de simpele `Classifier` door een slimmere `Cortex`.
|
|
|
|
### Layer 1: The Reflex Arc (Lokaal, <20ms)
|
|
* **Wat:** Regex & Keyword matching (zoals nu).
|
|
* **Doel:** Directe actie voor "High Confidence, Low Risk" commando's.
|
|
* **Scope:** Navigatie, simpele queries ("Agenda vandaag"), start commando's.
|
|
|
|
### Layer 2: The Intent Orchestrator (AI, ~400ms)
|
|
* **Wat:** Een kleine LLM (Haiku/Gemini Flash) die fungeert als "Router".
|
|
* **Nieuwe capability: Multi-Intent Parsing.**
|
|
* *Input:* "Zeg Jan af en zet in zijn dossier dat hij griep heeft."
|
|
* *Output:* `[CancelAppointment(Jan), CreateNote(Jan, "Griep")]`
|
|
* **Nieuwe capability: Entity Disambiguation.**
|
|
* Snap dat "Jan" verwijst naar de patiënt die ik *vandaaag* in mijn agenda heb.
|
|
|
|
### Layer 3: The Nudge (Contextual Logic)
|
|
* **Wat:** Een business logic laag die *na* de intent draait.
|
|
* **Functie:** Proactive Suggestions.
|
|
* *Trigger:* Intent `CreateWoundCareNote` 'completed'.
|
|
* *Logic:* Check `Protocol(Wondzorg)`.
|
|
* *Action:* Suggest `ScheduleFollowUp`.
|
|
|
|
---
|
|
|
|
## 3. Implementation Roadmap
|
|
|
|
### Phase 1: Hybrid Foundation (Week 1-2)
|
|
* [ ] Behoud huidige lokale patterns voor snelheid.
|
|
* [ ] Bouw de **AI Fallback Router** in. Als lokaal faalt (<60% confidence), stuur *direct* volledige context naar AI.
|
|
* [ ] **UX Win:** Geen "Ik begrijp het niet" meer. Altijd een poging tot begrip.
|
|
|
|
### Phase 2: Chains & Context (Week 3-4)
|
|
* [ ] **Context Injectie:** Stuur `ActivePatient`, `RecentIntents`, en `AgendaToday` mee in de AI prompt.
|
|
* [ ] **Multi-Intent Support:** Pas de frontend aan om een *lijst* van acties te verwerken in plaats van één.
|
|
|
|
### Phase 3: Agentic Proactivity (Maand 2)
|
|
* [ ] **Suggestion Engine:** UI element (Toaster/Card) dat vraagt: *"Wil je ook X doen?"*
|
|
* [ ] **Medical Knowledge Base:** Koppel protocollen aan intents.
|
|
|
|
---
|
|
|
|
## 4. Technisch Ontwerp Schets (Dev)
|
|
|
|
```mermaid
|
|
graph TD
|
|
User["User Speech"] --> Reflex["Layer 1: Reflex (Regex)"]
|
|
Reflex -->|Match > 90%| Action["Execute Action"]
|
|
Reflex -->|No Match / Low Conf| Cortex["Layer 2: AI Cortex"]
|
|
|
|
subgraph Context
|
|
Store["Active Patient"]
|
|
Agenda["Today's Schedule"]
|
|
end
|
|
|
|
Context --> Cortex
|
|
|
|
Cortex -->|Multi-Intent Detected| Plan["Execution Plan"]
|
|
Plan --> Action1["Action A"]
|
|
Plan --> Action2["Action B"]
|
|
|
|
Action1 --> Safety["Layer 3: Nudge"]
|
|
Safety -->|Trigger Found| Suggestion["Suggest Follow-up"]
|
|
```
|