← mindsweeper.sg View demo dashboard →

Mindsweeper — end-to-end flow

From multi-agent assessment to three-audience report
v0.3 · 2026-06-04 · Multi-agent architecture reference
Stage 1 · Agent app

Evidence collection

The React app that gathers raw evidence. Three roles, three input modes, branches based on what the user has. Each branch produces evidence — not a finished report.

Landing
Role select
Student · Parent · Teacher
Intake
Confirm details
Input choice
Parent / Teacher only
Student → skips input_choice, goes straight to live chat + portfolio
Written only
PDF, no chat
Conversation only
Transcript, no PDF
Portfolio upload
Portfolio upload
Transcript upload
Transcript upload
(skip chat)
(no portfolio)
Evidence bundle
portfolio + transcript
Evidence: portfolio
requires_chat → gaps flagged
Evidence: transcript
dialogue only
all evidence streams converge → assessment engine
Stage 2 · Assessment engine

Six agents, one blackboard

Evidence from any mode is normalised into a shared student model. Four assessors read and write it; the orchestrator drives live probing and assembles the report; the planner turns the profile into intervention.

Live Socratic chat
real-time probing
Portfolio analysis
uploaded work, PDFs
Offline transcript
prior dialogue
writes evidence ↓ · sources triangulate every finding
Shared student model — the blackboard
every agent reads & writes here · the system of record, not an agent
read evidence · write findings + confidence + open gaps
Knowledge & Skill
mastery · errors · transfer
Mindset & Motivation
drivers · growth vs fixed
Resilience & Affect
persistence · anxiety
Metacognition & Comms
calibration · explaining
OCEAN is not owned by any one assessor — the orchestrator derives it from logged behaviour
↻ live mode only: reads open gaps → picks the single next probe → back to live chat
Intervention planner 6 of 6
Stage-2 work · 8-week plan: knowledge · mindset · habit · problem-solving
Stage 3 · Unified report

One report, one data contract

The orchestrator merges each assessor's region of the blackboard into a single JSON report, written to localStorage as a bridge between the agent app and the teacher console.

One unified report
localStorage.mindsweeper:latestReport
Knowledge map + Mathematical character (incl. OCEAN) + Intervention plan + Narrative summary
Stage 4 · Teacher console

Report viewer — three audience views

Same underlying data, three voices. Each view shows / hides / rephrases sections based on the audience. Switched via toggle in the topbar.

Toggle view in topbar →
Student view
Warm · encouraging
Minimal jargon
Growth framing
2nd-person voice
Parent view
Concerned · supportive
Plain language
Action suggestions
Ways to help at home
Teacher view
Diagnostic · professional
Full CCSS detail
All 16 sections visible
Intervention plans