Files

colinislit 26ed58b7ff docs(cortex): add PRD, TO and rename swift → cortex

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>

2025-12-30 10:22:22 +01:00

3.5 KiB

Raw Blame History

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)

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"]

3.5 KiB Raw Blame History