Files
triqura-ecd/docs/intent/demo-script-cortex-v2.md
colinislit 6add89dc51 feat(cortex): Epic 5 - Integration & Polish complete (MVP DONE)
Epic 5 completes the Cortex V2 MVP with end-to-end integration:

E5.S1 - Feature Flag Guards
- ActionChainCard wrapped with CORTEX_MULTI_INTENT flag
- ClarificationCard wrapped with CORTEX_V2_ENABLED flag
- NudgeToast wrapped with CORTEX_NUDGE flag
- V1 UI remains functional when flags disabled

E5.S2 - Chain Execution Flow
- handleConfirmAction routes actions to artifacts via routeIntentToArtifact()
- Nudge evaluation triggered after successful action completion
- Sequential chain execution with auto-advance useEffect
- Chain auto-completes when all actions done

E5.S3 - Integration Tests (21 tests)
- Scenario 1: Simple input → Reflex handles (4 tests)
- Scenario 2: Multi-intent → Orchestrator handles (4 tests)
- Scenario 3: Context-dependent → Pronoun resolution (4 tests)
- Scenario 4: Wondzorg → Nudge suggestion (4 tests)
- Scenario 5: Graceful fallback (3 tests)
- Scenario 6: Chain building (2 tests)

E5.S4 - Demo Script
- 5-minute demo flow with exact phrases
- 5 scenes: Reflex speed, Multi-intent, Pronoun, Nudge, Clarification
- Backup scenarios documented
- Test phrases reference included

Files changed:
- components/cortex/chat/chat-panel.tsx (feature flags + execution)
- components/cortex/command-center/command-center.tsx (NudgeToast flag)
- lib/cortex/__tests__/cortex-v2.test.ts (NEW - 21 integration tests)
- docs/intent/demo-script-cortex-v2.md (NEW - demo documentation)
- docs/intent/bouwplan-cortex-v2.md (v1.5 - MVP complete)

MVP Status: 26/26 stories, 48/48 SP - 100% COMPLETE

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-01 13:16:20 +01:00

6.8 KiB

Cortex V2 Demo Script

Duur: 5 minuten Doelgroep: Product stakeholders, developers, demo publiek Versie: 1.0 Datum: 01-01-2026


Pre-Demo Setup

1. Environment Check

# Start development server
pnpm dev

2. Feature Flags

Controleer .env.local:

NEXT_PUBLIC_CORTEX_V2=true
NEXT_PUBLIC_CORTEX_MULTI_INTENT=true
NEXT_PUBLIC_CORTEX_NUDGE=true

3. Browser Setup

  • Open http://localhost:3000/epd/cortex
  • Login met test account
  • Clear browser console (voor schone logs)

4. Test Data

Zorg dat de volgende patiënten beschikbaar zijn:

  • Jan de Vries - Patiënt met afspraken vandaag
  • Marie van den Berg - Patiënt zonder afspraken

Demo Flow (5 minuten)

Scene 1: Snelheid - Reflex Arc (30 sec)

Doel: Toon dat simpele commando's razendsnel worden afgehandeld.

Actie:

Typ: "agenda vandaag"

Verwacht resultaat:

  • Direct resultaat (< 100ms)
  • Agenda artifact opent met vandaag's afspraken
  • Console toont: [Reflex] Handled locally

Talking point:

"Simpele commando's worden lokaal afgehandeld zonder AI. Dat betekent milliseconden responstijd."


Scene 2: Multi-Intent - Orchestrator (90 sec)

Doel: Toon dat het systeem meerdere intenties in één zin herkent.

Actie:

Typ: "Zeg de afspraak van Jan af en maak een notitie dat hij griep heeft"

Verwacht resultaat:

  1. Korte "Even nadenken..." indicator (AI processing)
  2. ActionChainCard verschijnt met 2 acties:
    • Actie 1: "Afspraak annuleren" (Jan) - Status: Confirming
    • Actie 2: "Dagnotitie" (Jan: griep) - Status: Pending
  3. AI reasoning zichtbaar (inklapbaar)

Demo stappen:

  1. Wijs op de 2 gedetecteerde acties
  2. Klap AI reasoning open → toon "en" detectie
  3. Klik "Bevestig" op actie 1
  4. Observeer status change: Executing → Success
  5. Actie 2 gaat automatisch naar "Confirming"
  6. Klik "Bevestig" op actie 2
  7. Chain completes, artifacts zijn geopend

Talking point:

"Het systeem herkent automatisch dat dit twee aparte taken zijn. 'Zeg af' én 'maak notitie'. Beide worden sequentieel uitgevoerd."


Scene 3: Context - Pronoun Resolution (60 sec)

Doel: Toon dat het systeem context gebruikt om pronouns te resolven.

Voorbereiding:

  • Selecteer patiënt "Marie van den Berg" in de ContextBar

Actie:

Typ: "Maak een notitie voor haar: medicatie gegeven om 14:00"

Verwacht resultaat:

  • AI resolves "haar" naar "Marie van den Berg"
  • Dagnotitie artifact opent met Marie's gegevens ingevuld
  • Console toont: patientResolution: 'pronoun'

Talking point:

"Het systeem snapt dat 'haar' verwijst naar de actieve patiënt. Geen naam herhalen nodig."


Scene 4: Proactiviteit - Nudge Suggestie (90 sec)

Doel: Toon proactieve suggesties op basis van medische protocollen.

Actie:

Typ: "Notitie Jan: wond verzorgd en verbonden, ziet er goed uit"

Verwacht resultaat:

  1. Dagnotitie wordt opgeslagen
  2. NudgeToast verschijnt (links-onder):
    • Bericht: "Wondcontrole inplannen over 3 dagen?"
    • Knoppen: "Ja, inplannen" / "Later"
    • Progress bar countdown (5 min expiry)
  3. Klik "Ja, inplannen"
  4. Agenda artifact opent met Jan's gegevens

Talking point:

"Na wondzorg suggereert het systeem automatisch een controle-afspraak. Dit is gebaseerd op medische protocollen en voorkomt dat belangrijke follow-ups vergeten worden."


Scene 5: Fallback - Clarificatie (30 sec)

Doel: Toon graceful handling van ambigue input.

Actie:

Typ: "Plan wondzorg"

Verwacht resultaat:

  • ClarificationCard verschijnt:
    • Vraag: "Wil je een afspraak inplannen of een notitie maken?"
    • Opties: "Afspraak inplannen" / "Notitie maken"
  • Selecteer een optie → flow gaat verder

Talking point:

"Bij onduidelijkheid vraagt het systeem om verduidelijking in plaats van te raden. Dat is veiliger in een medische context."


Backup Scenarios

Als AI niet reageert (timeout)

Symptoom: Lange "Even nadenken..." zonder resultaat

Actie:

  1. Wacht 5 seconden
  2. Systeem valt automatisch terug op Reflex
  3. Toon: "Graceful degradation - het systeem blijft werken"

Talking point:

"Als de AI even niet beschikbaar is, valt het systeem terug op lokale verwerking. De gebruiker merkt nauwelijks iets."


Als geen patiënt geselecteerd

Symptoom: Context resolution faalt

Actie:

Typ: "notitie jan medicatie gegeven"

Verwacht:

  • Systeem extraheert "jan" expliciet uit de tekst
  • Werkt zonder context

Talking point:

"Ook zonder actieve patiënt werkt het systeem - het haalt de naam uit je invoer."


Feature Flag Demo

Doel: Toon feature control

Actie:

  1. Zet NEXT_PUBLIC_CORTEX_NUDGE=false in .env.local
  2. Herstart dev server
  3. Herhaal wondzorg notitie
  4. NudgeToast verschijnt NIET

Talking point:

"Alle V2 features zitten achter feature flags. We kunnen ze individueel in- of uitschakelen voor geleidelijke rollout."


Closing Statement

"Dit is Cortex V2: een systeem dat begrijpt wat je bedoelt, meerdere taken tegelijk aankan, context gebruikt voor slimme interpretatie, en proactief meedenkt op basis van protocollen.

De architectuur is een three-layer systeem:

  • Layer 1 (Reflex): Razendsnelle lokale verwerking voor simpele taken
  • Layer 2 (Orchestrator): AI voor complexe, multi-intent analyse
  • Layer 3 (Nudge): Proactieve suggesties op basis van regels

Dit is de transformatie van een 'spraakgestuurd toetsenbord' naar een echte AI Collega."


Test Zinnen Referentie

Simpele commando's (Reflex)

  • agenda vandaag
  • zoek marie
  • notitie jan medicatie
  • overdracht

Multi-intent (Orchestrator)

  • Zeg Jan af en maak notitie dat hij griep heeft
  • Zoek Marie en plan een afspraak
  • Eerst overdracht maken en dan agenda bekijken

Context-dependent (Pronoun)

  • Maak notitie voor hem (met actieve patiënt)
  • Verzet haar afspraak naar morgen
  • Zoek die patiënt op

Nudge triggers

  • Notitie: wond verzorgd → Wondcontrole suggestie
  • Notitie: medicatie gewijzigd → Medicatie controle suggestie

Ambigue input (Clarification)

  • Plan wondzorg
  • Afspraak
  • Jan

Technische Details

Console Logging

Tijdens demo zijn deze logs zichtbaar:

[Reflex] Handled locally: agenda_query (0.95)
[Orchestrator] AI classification: 2 actions detected
[ChatPanel] Opening artifact: dagnotitie
[ChatPanel] Nudge suggestions: 1
[CommandCenter] Opening artifact from nudge: create_appointment

Performance Metrics

Actie Target Gemiddeld
Reflex classificatie < 20ms ~5ms
Orchestrator (AI) < 3s ~1-2s
Artifact open < 100ms ~50ms

Versiehistorie

Versie Datum Wijziging
1.0 01-01-2026 Initiële versie