26ed58b7ff
New documents: - prd-cortex-v2.md: Product Requirements Document with MVP scope, user flows, success criteria, and roadmap - to-cortex-v2.md: Technical Design with three-layer architecture, API design, error handling, and logging Renamed files (swift → cortex): - architecture-swift-cortex-v2.md → architecture-cortex-v2.md - fo-swift-intent-system-v2.md → fo-cortex-intent-system-v2.md - haalbaarheidsanalyse-swift-cortex-v2.md → haalbaarheidsanalyse-cortex-v2.md - review-swift-cortex-v2.md → review-cortex-v2.md Updated content: - All swift references replaced with cortex - FO: confidence threshold 0.9 → 0.7 (industry standard) - TO v1.1: Added error handling, input sanitization, improved suïcidaliteit regex, model version note - Legacy docs: Added note about swift → cortex rename 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
89 lines
3.5 KiB
Markdown
89 lines
3.5 KiB
Markdown
> **Note:** "Swift" is hernoemd naar "Cortex". Dit document bevat historische referenties naar de oude naam.
|
|
|
|
# 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"]
|
|
```
|