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>
72 lines
4.2 KiB
Markdown
72 lines
4.2 KiB
Markdown
> **Note:** "Swift" is hernoemd naar "Cortex". Dit document bevat historische referenties naar de oude naam.
|
|
|
|
# 🚀 MVP Userstories & Scope: Swift Cortex (Public Prototype)
|
|
|
|
**Betreft:** Scope voor de "Build in Public" fase van het Swift Intent System V2.
|
|
**Doel:** Een werkend, indrukwekkend prototype neerzetten dat de kernwaarde van "Agency" (Multi-intent & Context) demonstreert, zonder te verzanden in productie-complexiteit.
|
|
|
|
---
|
|
|
|
## 1. Scope Definitie
|
|
|
|
We splitsen de ontwikkeling in **MVP** (Wat we nu bouwen voor de publieke demo) en **Post-MVP** (Wat nodig is voor een veilig medisch productiesysteem).
|
|
|
|
### ✅ In Scope (MVP - "The Prototype")
|
|
*Focus: Wow-factor, core mechanics, demonstratie van intelligentie.*
|
|
|
|
1. **Hybrid Architecture:** De naadloze switch tussen Layer 1 (Reflex) en Layer 2 (AI).
|
|
2. **Multi-Intent:** Het kunnen verwerken van samengestelde zinnen ("Zeg af en maak notitie").
|
|
3. **Context Awareness:** Het correct interpreteren van "hij", "deze", "morgen" o.b.v. de huidige schermstatus.
|
|
4. **UI Feedback:** Visualisatie van het "denkproces" en gestapelde resultaten (Stacked Cards).
|
|
5. **Basic Nudge:** Eén hardcoded voorbeeld van proactiviteit (bijv. "Wondcontrole suggestie") om het concept te tonen.
|
|
|
|
### ❌ Out of Scope (Post-MVP - "The Product")
|
|
*Focus: Veiligheid, robuustheid, edge-cases.*
|
|
|
|
1. **Complete Medische Protocollen:** Geen volledige rule-engine voor alle ziektebeelden.
|
|
2. **Complex Rollback:** Geen "Undo" knop voor database mutaties (wel confirmaties vooraf).
|
|
3. **Offline Mode:** Het prototype gaat uit van internetverbinding.
|
|
4. **Advanced Error Handling:** Geen automatische retry-mechanismes of fallbacks als de LLM down is.
|
|
5. **Analytics & Learning:** Geen telemetry opslag voor model-training.
|
|
|
|
---
|
|
|
|
## 2. MVP User Stories
|
|
|
|
Deze stories zijn leidend voor de aankomende bouwfase.
|
|
|
|
### Thema 1: De Slimme Assistent (Core Intelligence)
|
|
|
|
| ID | Story | Acceptatie Criteria |
|
|
|----|-------|---------------------|
|
|
| **US-MVP-01** | Als gebruiker wil ik **twee acties in één zin** kunnen geven ("Zeg Jan af en mail de huisarts"), zodat ik niet hoef te wachten. | - Systeem herkent "en/daarna" signalen.<br>- UI toont twee losse acties in progressie.<br>- Beide acties worden uitgevoerd. |
|
|
| **US-MVP-02** | Als gebruiker wil ik naar **"deze patiënt"** of **"hij"** kunnen verwijzen, zodat ik natuurlijk kan spreken. | - Systeem gebruikt de `ActivePatient` uit de store om "hij" te invullen.<br>- Als er geen patiënt open staat, vraagt het systeem "Wie bedoel je?". |
|
|
| **US-MVP-03** | Als gebruiker wil ik **impliciete tijd** ("morgen", "volgende week") kunnen gebruiken, zodat ik geen datums hoef te noemen. | - "Morgen" wordt correct vertaald naar de datum van morgen.<br>- Context (huidige tijd) wordt meegestuurd naar de AI. |
|
|
|
|
### Thema 2: Hybride Snelheid (Architecture)
|
|
|
|
| ID | Story | Acceptatie Criteria |
|
|
|----|-------|---------------------|
|
|
| **US-MVP-04** | Als gebruiker wil ik dat simpele commando's (**"Agenda", "Zoek Jan"**) direct werken (<20ms), zodat het systeem niet traag voelt. | - Reflex Arc (Regex) vangt deze af.<br>- Geen AI spinner zichtbaar, directe actie. |
|
|
| **US-MVP-05** | Als gebruiker wil ik zien **dat het systeem nadenkt** bij complexe vragen, zodat ik weet dat ik moet wachten. | - Bij trage/AI acties (Layer 2) toont de UI direct een "Processing..." indicator.<br>- Geen "bevroren" scherm. |
|
|
|
|
### Thema 3: De Partner (Proactivity - Concept)
|
|
|
|
| ID | Story | Acceptatie Criteria |
|
|
|----|-------|---------------------|
|
|
| **US-MVP-06** | Als gebruiker wil ik een **proactieve suggestie** zien na een specifieke actie (bijv. wondzorg), zodat ik snap dat het systeem meedenkt. | - *Demo Case:* Na invoeren "Wondverzorging" toont systeem kaartje: "Afspraak wondcontrole inplannen?".<br>- Klikken op "Ja" opent direct het planningsscherm. |
|
|
|
|
---
|
|
|
|
## 3. Technische Randvoorwaarden (MVP)
|
|
|
|
* **Model:** Claude 3.5 Haiku (via Anthropic API).
|
|
* **Latency Target:** Reflex < 50ms, AI < 1.5s (acceptabel voor prototype).
|
|
* **Data:** We gebruiken mock-data voor patiënten en agenda, geen echte EPD koppeling.
|
|
|
|
## 4. 'Build in Public' roadmap
|
|
|
|
1. **Week 1:** De "Reflex" werkend krijgen (De basis).
|
|
2. **Week 2:** De "Cortex" aansluiten (Multi-intent parsing demo).
|
|
3. **Week 3:** De UI polijsten (Stacked Cards & Animaties) & Share video.
|