Wulo Platform Documentation

1. Welcome to Wulo

Wulo is a therapist-supervised AI speech practice platform for structured articulation and phonological awareness work. It helps children practise with a voice buddy while keeping the therapist in control of review, interpretation, and next-step planning.

It is designed for therapists and clinical educators supporting children in clinics, schools, or supervised home practice.

At a high level, the workflow is:

1. Choose the active child.
2. Choose an exercise and avatar.
3. Run a guided session.
4. Review the saved session.
5. Review child memory and recommendations.
6. Generate or refine a next-session plan.

The key principle is simple: Wulo is a practice and review tool, not a diagnostic tool. It can surface patterns, suggestions, and evidence, but it does not replace therapist judgement.

What Wulo helps you do

• Deliver structured practice with an AI buddy.
• Review pronunciation and engagement results.
• Preserve therapist-approved child memory over time.
• Inspect recommendation evidence instead of treating AI suggestions as black-box output.
• Create therapist-guided next-session plans.

2. Getting Started

2.1 Signing in

Therapists can sign in with Microsoft or Google. On the sign-in screen, choose the provider you normally use for work. After sign-in, Wulo keeps your session active until it expires, so you do not need to sign in again each time you return during normal use.

If the session expires, Wulo returns you to the login screen and asks you to sign in again.

To sign in:

1. Open Wulo in your browser.
2. Select Continue with Microsoft or Continue with Google.
3. Complete the sign-in process.
4. Wait for Wulo to load your workspace.

2.2 Choosing a mode

After sign-in, Wulo asks which workspace mode you want to use.

Therapists usually prepare the session in Therapist mode, then either switch to Child mode or hand the device over once the practice is ready to begin.

A short onboarding screen appears before first use in that browser. It reminds the therapist to confirm adult access, choose the child and exercise, and stay nearby during practice.

To choose a mode:

1. Sign in.
2. Select Therapist mode when you want review and planning tools.
3. Select Child mode when the child is ready to practise.
4. Use the Workspace page later if you need to switch modes.

2.3 Consent and safe use framing

Before the first child session, Wulo asks the therapist to acknowledge supervised-practice consent.

This consent makes three things clear:

• Wulo is intended for supervised practice.
• It does not replace therapist judgement or diagnosis.
• Therapists remain responsible for interpreting results and deciding next steps.

To acknowledge consent:

1. Read the supervised-practice message.
2. Tick the acknowledgement box.
3. Select Acknowledge and continue.

3. Understanding the Therapist Workspace

The therapist-facing experience has three different surfaces. They work together, but each has a different job.

3.1 Home

The therapist home screen is the launch and preparation surface. It is where you choose who is practising, which buddy the child will see, which exercise is active, and whether you want to start practice or move into review.

On the home screen you can see:

• The child selector.
• The avatar selector.
• The selected exercise context.
• The Start session action.
• The Review progress action.
• The exercise library below.

The compact insight cards on the home surface are quick signals only. Full review happens in the dashboard workspace.

Compact insight cards on Home

3.2 Dashboard

The dashboard is the deep review workspace for one active child. This is where therapists inspect saved sessions, child memory, recommendations, and plans in one place.

The dashboard has five main tabs:

• Session detail: per-session scores, articulation and engagement analysis, pronunciation review, highlights, next steps, therapist notes, and transcript turns or excerpts when they are available.
• Memory: approved durable memory and pending proposals, including blockers, effective cues, preferences, and other evidence-backed observations that should carry across sessions.
• Recommendations: saved recommendation runs with explainable rationale, ranked options, supporting memory and sessions, and evidence that could change the ranking.
• Plan: next-session structure with activities, timing, therapist cues, success markers, carryover work, memory provenance, and the latest planner exchange.
• Reports: therapist, parent, and school progress reports with date-range selection, redaction controls for shared audiences, and HTML or PDF export.

It also includes a child list, session history, summary cards at the top, and review charts that help you understand the child’s recent work over time.

Use the dashboard when you want to:

1. Open a saved session.
2. Review evidence in more detail.
3. Approve or reject memory proposals.
4. Inspect why an exercise was recommended.
5. Generate, refine, or approve a next-session plan.
6. Create and share progress reports with parents or schools.

3.3 Workspace

The Workspace page is the settings surface for everyday session setup. It is where you:

• Change therapist versus child mode.
• Confirm the active child.
• Change the active practice buddy or avatar.

It also shows a simple summary of the current role, current mode, current child, and current buddy so you can confirm that the environment is set correctly.

The active child should stay aligned across Therapist home, Dashboard, and Workspace. If you change it in one place, your review context should follow that child.

4. Managing the Active Child

Wulo uses an active-child model. This means the app is always working in the context of one selected child at a time.

When you change the active child, all of the following change with it:

• Saved sessions.
• Review charts.
• Child memory.
• Recommendation history.
• Planning context.

You can switch the active child from therapist-facing surfaces such as the sidebar child list, the child dropdown, or the home screen child selector.

To change the active child safely:

1. Check the current child name before starting or reviewing anything.
2. Open the child selector or child list.
3. Select the correct child.
4. Wait for the dashboard or home surface to refresh.
5. Re-check the child name before continuing.

This matters because Wulo does not treat sessions, memory, recommendations, and plans as separate floating items. They all follow the active child context.

If the wrong child context appears

1. Open the therapist shell and verify the active child name.
2. Re-select the correct child from the child list or selector.
3. Re-open the dashboard for that child.
4. Check that the session history and summary cards now match the correct case.

5. Exercise Library and Session Preparation

The exercise library sits on the therapist home screen below the main launch area. It is the main place to choose what the child will practise next.

Wulo includes both built-in exercises and custom exercises.

• Built-in exercises give you a structured library organised by step, activity type, and target sound.
• Custom exercises let you add your own therapist-authored practice items for a particular child or target.

Exercise cards and filters help you see useful context quickly, including:

• Target sound badges.
• Exercise type labels.
• Difficulty labels where available.
• Step-based browsing for progression.

To prepare a session:

1. Choose the active child.
2. Choose the avatar or practice buddy.
3. Browse or filter the exercise library.
4. Select the exercise you want.
5. Start the session.

On the therapist home surface, you can start in two ways:

1. Select an exercise and use the main Start session button.
2. Select an exercise card directly from the library to move straight into session launch.

This makes it easy to use the home page either as a slower preparation space or a quick-start surface.

A practical progression through exercise types

Wulo supports a sensible progression from easier listening work towards more expressive speech work, but it does not force a single clinical sequence.

A common pattern is:

1. Listening minimal pairs.
2. Silent sorting.
3. Sound isolation.
4. Vowel blending.
5. Word repetition.
6. Minimal pairs or sentence work.
7. Guided prompt or carryover conversation.

6. Running a Practice Session

A Wulo session begins once the child, exercise, and buddy are selected.

What the live session includes

During a session, Wulo can show:

• The buddy video or avatar panel.
• The microphone control for speaking activities.
• A live conversation panel.
• Exercise-specific activity panels for tasks such as listening minimal pairs, silent sorting, sound isolation, or vowel blending.
• Live speaking feedback for relevant activities.

The exact layout depends on the activity type. Receptive exercises show more task panels, while speaking tasks rely more on voice interaction and live feedback.

How to run a session

1. Confirm the active child.
2. Choose the exercise.
3. Choose the avatar.
4. Start the session.
5. Let the AI buddy guide the child through the practice.
6. Support the child as needed while staying nearby.
7. End the session and review the saved results.

Live interaction and transcript behaviour

The AI buddy speaks first to open the session. For child sessions, the screen stays simple and the conversation appears in the transcript panel as it unfolds.

For speaking activities, the microphone stays available once the session is ready. For listening or sorting tasks, the interactive task panel may be more central than the microphone.

How sessions finish and save

Once the live interaction finishes, Wulo saves the session so it can feed review, memory, recommendations, and planning.

7. Reviewing a Saved Session

Saved sessions are reviewed from the dashboard. Open the active child, then choose a session from the history list. The Session detail tab is the place for full review.

How to open a saved session

1. Open the dashboard.
2. Confirm the active child.
3. Use the session history list on the left.
4. Select the session you want to inspect.
5. Stay on Session detail for the full review.

What you see in Session detail

The Session detail tab includes several layers of review.

In practical terms, this is the per-session review surface. It gives you a scored readout of one saved session: overall result, articulation and engagement detail, pronunciation review, highlights, next steps, therapist notes, and the saved transcript when Wulo has one.

Summary strip at the top of the dashboard

At the top of the dashboard you will usually see a selected-child summary and, when enough data exists, trend or sound summaries. This gives context before you open an individual session.

Session overview cards

When a session is selected, the top cards in Session detail show:

• Session date.
• Overall score.
• Transcript turns.

This is a quick orientation layer before you read deeper.

Session analysis

The session analysis area brings together the overall profile of the session. It uses a radar-style view and score bars for articulation and engagement areas such as target sound accuracy, clarity, consistency, task completion, willingness to retry, and self-correction attempts.

Clinically, this can help you tell the difference between:

• A child who was engaged but not yet accurate.
• A child who was accurate in parts but inconsistent.
• A child who may have needed more support, more time, or a lower task load.

Pronunciation review

The pronunciation review area shows saved speech scores and, when available, a word-level heatmap so you can see which words or attempts were easier or harder.

Review summary

The review summary combines several therapist-friendly elements:

• Celebration.
• Highlights.
• Next steps.
• Therapist note.

This area is useful for preparing your clinical summary or next-session focus.

Transcript access

The transcript area shows the saved conversation. When Wulo can split the transcript into turns, it labels user and assistant turns; otherwise it shows the saved transcript as one block. This can help when you want to check how the child responded, what the buddy asked, or whether a moment in the session should be interpreted with more caution.

Therapist feedback markers

If feedback has been saved, the session can be marked as:

• Helpful session
• Needs follow-up

This is useful when you want to flag sessions that should shape planning or closer review later.

8. Child Memory: What It Is and How It Works

Child memory is a governed, therapist-facing knowledge layer built from reviewed session evidence. It is separate from raw session history.

Raw session history shows what happened. Child memory preserves what has been reviewed and judged useful enough to carry forward.

This matters because:

• Clinically useful facts can be preserved over time.
• Approved memory improves planning and recommendation quality.
• Higher-risk inferences stay reviewable rather than silently turning into durable facts.

Wulo separates child memory into two states:

In everyday therapist terms, the Memory tab is where durable strengths, blockers, effective cues, preferences, and other evidence-backed observations live once they have been reviewed and accepted.

8.1 Memory overview cards

At the top of the Memory tab, Wulo shows three overview cards.

8.2 Approved memory sections

Approved memory is grouped into categories such as:

• Targets.
• Effective cues.
• Ineffective cues.
• Preferences.
• Constraints.
• Blockers.
• General notes.

Each memory item is shown as a short statement. Where available, Wulo also shows confidence and evidence links so you can open the source session directly from the memory item.

This means the Memory tab is not only a list of problems. It is also where the app preserves what is working well enough to repeat, what tends to block progress, and what practical preferences should shape the next session.

In practice:

• Targets helps you see what is currently being worked on.
• Effective cues helps you reuse approaches that have already helped.
• Ineffective cues helps you avoid repeating strategies that have not worked well.
• Preferences and constraints help with practical session design.
• Blockers can highlight barriers such as fatigue, pace, or frustration.
• General notes can hold broader therapist-approved observations.

8.3 Therapist memory note

Wulo also lets therapists write a memory item directly when they want to preserve an important practical observation without waiting for another synthesis cycle.

To add a therapist memory note:

1. Open the Memory tab.
2. Go to Therapist memory note.
3. Choose a category.
4. Write a concise statement.
5. Select Save approved memory.

Common uses include:

• Preserving a cueing strategy that worked especially well.
• Recording a clear preference that affects cooperation.
• Saving a practical constraint that should shape future sessions.

8.4 Pending proposals

Pending proposals are possible memory updates that still need therapist review.

Each proposal shows:

• The proposed statement.
• Its category.
• Its type.
• Confidence, where available.
• Whether it is linked to one or more source sessions.
• Evidence links back to source sessions.

To review a proposal:

1. Open the Memory tab.
2. Go to Pending proposals.
3. Read the statement.
4. Open the evidence links if needed.
5. Select Approve or Reject.

The actions mean:

• Approve moves the proposal into approved memory so it can support planning and recommendations.
• Reject keeps it out of approved memory.

Pending proposals are kept separate from approved memory on purpose. This is a governance and safety feature. It lets the system surface useful ideas without silently converting them into durable clinical facts.

8.5 Memory refresh and evidence freshness

On the home surface, Last memory refresh tells you whether approved memory has been compiled recently enough to act as a current summary.

If memory has not been refreshed, or if there are pending proposals waiting, review the Memory tab before trusting an older recommendation run.

That is especially important when:

• A new session has been reviewed.
• Pending proposals are waiting.
• Approved memory may have changed since the last recommendation run.

9. Recommendations: Inspectable Next-Exercise Suggestions

Wulo can generate therapist-facing exercise recommendations, but these are inspectable, evidence-linked suggestions rather than automatic decisions.

In plain language, this is the place to inspect what the system thinks should come next and why.

The Recommendations tab is built to answer three questions: What does Wulo suggest next?, Why?, and What would change that answer?

9.1 Recommendation overview cards

At the top of the Recommendations tab, Wulo shows:

9.2 Generating a recommendation run

A recommendation run is created for the active child and saved so it can be reopened later.

Recommendation generation depends on reviewed context. In the current app, Wulo needs at least one saved session and some approved child memory before it can produce a durable recommendation run.

To generate recommendations:

1. Open the Recommendations tab.
2. Optionally add a therapist note or constraint.
3. Select Generate recommendations.
4. Open the saved run that appears.

Useful therapist notes include:

• Keep this playful.
• Avoid moving above medium difficulty.
• Favour short verbal models.
• Stay with word-level work for now.

These notes do not remove therapist judgement. They help the ranking reflect your practical intent for that moment.

9.3 Recommendation history

Recommendation runs are saved and reopenable, so therapists can compare runs over time instead of relying only on the latest output.

This is useful when:

• The child’s approved memory has changed.
• A newer session has been reviewed.
• You want to compare how different therapist notes affected the ranking.

9.4 Inspecting the selected recommendation

When you open a saved run, the detail view shows:

• Current target.
• Top score.
• Therapist note.
• Top recommendation summary.
• Ranked options list.

The top recommendation is clearly marked, but the full ranked list stays visible so you can compare alternatives.

9.5 Why the system recommended an exercise

Each ranked candidate includes a detailed explanation layer.

For each candidate, Wulo can show:

• Why it was recommended.
• How it compares to approved memory.
• Ranking factors with score contributions and reasons.
• Supporting approved memory items.
• Supporting sessions.
• What evidence might change the recommendation.

This matters clinically because it makes the recommendation discussable and challengeable.

That explanation layer is the point: Recommendations is not only a ranking output. It is an explainable rationale for what the system currently thinks should come next for this child.

A therapist can ask questions such as:

• Is this recommendation leaning too heavily on old evidence?
• Does the supporting memory still reflect the child accurately?
• Are the linked sessions still the ones I would prioritise?
• Would a different note or a newer review change the ranking?

That is the point of this design. Recommendation quality is meant to be inspected, not blindly obeyed.

9.6 Institutional memory

The Recommendations tab may also show a clinic-level institutional memory section.

In plain language, this is a set of de-identified patterns or strategy insights drawn from reviewed outcomes across the clinic. It may help tune recommendation ranking, but it does not become child-specific approved memory.

Treat it as a clinic-level support signal, not a diagnostic system and not a substitute for case-specific reasoning.

9.7 Evidence status on the therapist home surface

On the home surface, the Evidence status card can show:

A recommendation may become stale if:

• Pending memory proposals exist.
• Approved memory changed after the recommendation was generated.
• A newer reviewed session exists than the saved recommendation run.

10. Planning the Next Session

The Plan tab supports next-session planning using the selected saved session, approved child memory, and therapist input.

In practical terms, the Plan tab turns review into next-session structure: a draft objective, ordered activities, estimated timing, therapist cues, success markers, carryover work, and a visible memory snapshot.

10.1 Plan overview cards

At the top of the Plan tab, Wulo shows:

If the Planner card shows Limited, plan generation and refinement stay unavailable until planner context is ready.

10.2 Generating a plan

To generate a plan:

1. Select a saved session from the dashboard.
2. Open the Plan tab.
3. Add a planning note if needed.
4. Select Generate plan.

A generated plan can include:

• Objective and focus sound.
• Ordered activities with exercise names and estimated minutes.
• Therapist cues.
• Success markers.
• Carryover ideas.
• Estimated duration.

This keeps the plan practical rather than just descriptive.

When a plan exists, the tab can also retain the most recent therapist-planner exchange so you can see what changed after a refinement note.

10.3 Refining a plan

If the first draft does not fit your judgement, you can refine it.

To refine a plan:

1. Open the current draft.
2. Enter a refinement instruction.
3. Select Refine plan.
4. Review the updated version.

Examples of useful refinement notes:

• Start with listening and shorten the sequence.
• Keep this playful for home carryover.
• Reduce verbal load and use shorter modelling.

10.4 Approving a plan

Approving a plan marks it as the therapist-accepted version for that child and saved session context. A draft is still a working suggestion; an approved plan is the version you have accepted for use.

To approve a plan:

1. Review the full draft.
2. Check the activities, cues, and success markers.
3. Confirm the plan fits the child’s current needs.
4. Select Approve plan.

10.5 Memory that informed this plan

One of the most important parts of the Plan tab is the provenance section: Memory that informed this plan.

This section shows:

• How many memory inputs were used.
• When the memory snapshot was compiled.
• Which approved memory statements informed the draft.
• Evidence links back to source sessions where available.

The snapshot is important because it preserves the approved memory that was available when the draft was created, instead of silently rewriting an older plan after memory changes later.

This improves transparency. Therapists can see not only what the plan says, but what reviewed memory the planner relied on when building it.

11. Charts and Dashboard Interpretation

The dashboard includes visual summaries to help you understand recent work for the selected child. These are designed to support review, not replace detailed interpretation.

Selected child summary card

What it shows:

• The currently selected child.
• How many saved or reviewed sessions are available.

What it does not show:

• It is not a full case summary.

Useful use:

• Use it as a quick confirmation that you are looking at the right child before reviewing anything else.

Progress trendline

What it shows:

• A score trend over recent reviewed sessions when enough data exists.

What it does not show:

• It does not explain why a change happened.

Useful use:

• Use it to spot whether performance looks broadly stable, improving, or variable across recent sessions.

Reviewed sessions summary

What it shows:

• How many saved sessions are currently available.

What it does not show:

• It does not tell you whether those sessions were clinically equivalent or equally useful.

Useful use:

• Use it to judge whether you have enough recent evidence to trust trend patterns.

Sound breakdown or focus-sound chart

What it shows:

• A summary of sound-related performance across saved sessions when enough data exists.

What it does not show:

• It is not a complete phonological profile.

Useful use:

• Use it to see which focus sounds may need more attention or a different task type.

Session frequency heatmap

What it shows:

• When sessions were saved across recent weeks.

What it does not show:

• It does not tell you whether practice quality was high.

Useful use:

• Use it to spot gaps in practice frequency or compare consistency across periods.

Session history metrics

What it shows:

• Exercise name.
• Date.
• Overall score.
• Accuracy score.
• Pronunciation score where available.
• Therapist feedback markers where saved.

What it does not show:

• It is not a replacement for the full session review.

Useful use:

• Use the history list to identify which sessions should be opened first, especially flagged sessions or those with unusual changes.

12. Reports: Sharing Progress with Parents and Schools

The Reports tab on the dashboard lets therapists create, review, and export progress reports for different audiences. Reports are generated from saved session evidence and approved child memory, so they stay grounded in reviewed data rather than ad-hoc summaries.

Wulo supports three report types, each shaped for a different reader.

12.1 Report types

12.2 Creating a report

To create a report:

1. Open the dashboard for the active child.
2. Go to the Reports tab.
3. Choose the report type.
4. Set an explicit date range for the reporting period.
5. Select which saved sessions to include.
6. Generate the report draft.

Reports use an explicit date range and selected saved sessions rather than only an automatic window. This gives the therapist control over which evidence appears in the report and which period it covers.

12.3 Redaction controls for shared reports

Parent and school reports include shared-export redaction controls. Before exporting or sharing, the therapist can choose to hide:

• The executive summary.
• Overview metrics.
• The included-session list.
• Internal workflow metadata.
• Individual generated sections.

Redaction is applied per export. The underlying report draft is preserved intact so the therapist can generate different versions for different audiences from the same base report.

This matters because not every piece of clinical detail belongs in every audience. A parent may benefit from a summary of strengths and next steps without seeing raw session metrics. A school report may need structured progress information without internal workflow context.

12.4 Exporting a report

Reports can be exported in both HTML and true PDF formats.

The available export actions are:

• Print view: opens a print-friendly layout in the browser.
• HTML download: saves the report as an HTML file.
• PDF preview: opens a rendered PDF preview in the browser.
• PDF download: saves the report as a PDF file.

To export a report:

1. Open the completed report draft.
2. Review the content and redaction settings.
3. Choose the export format.
4. Use the corresponding action button.

13. Session History and Review Workflow

A practical dashboard workflow after a session often looks like this:

1. Open the saved session from the dashboard.
2. Check the Session detail review.
3. Review pending memory proposals.
4. Approve or reject what should become durable memory.
5. Create or share a progress report if one is due for a parent or school.
6. Generate or inspect recommendations.
7. Create or refine a next-session plan.

In day-to-day work, this often becomes a repeatable pattern:

• First, use the saved session to understand what happened.
• Next, decide what should become durable child memory.
• Then, if a report is needed, create it while the reviewed evidence is fresh.
• Then inspect whether the recommendation logic still fits the updated evidence.
• Finally, turn that review into a therapist-guided next-session plan.

This workflow links session evidence, reviewed memory, reports, recommendations, and planning in one place.

14. Custom Exercises and Local Management

Custom exercises are available for therapist-authored practice tasks.

They are useful when you want to:

• Tailor the task to a specific child.
• Use your own word list.
• Adjust the prompt or tone.
• Work on a target not covered exactly the way you want in the built-in library.

To create a custom exercise:

1. Open the custom exercise editor.
2. Add a name.
3. Add a short therapist description.
4. Choose an exercise type.
5. Add the target sound.
6. Add target words.
7. Set the difficulty.
8. Add the child-facing prompt.
9. Add the coach instructions.
10. Save the exercise.

To edit or delete a custom exercise:

1. Open the exercise from the custom-exercise area.
2. Change the fields you want.
3. Save the update, or use delete if the exercise is no longer needed.

To export or import a custom exercise:

1. Open the custom exercise.
2. Use export to save it as a JSON file.
3. Use import to load a previously saved JSON file.

15. Workspace Settings and Everyday Checks

The Workspace page is intentionally simple. It is for quick environment checks rather than deep configuration.

Use it to:

• Switch between therapist and child mode.
• Confirm the active child.
• Confirm the active buddy or avatar.

A sensible everyday check before practice is:

1. Open Workspace.
2. Confirm the mode.
3. Confirm the active child.
4. Confirm the active buddy.
5. Return to Home and start the session.

This is especially useful when:

• More than one child is being seen in a row.
• A different therapist has just used the device.
• You are moving from review back into practice.

16. Best-Practice Tips for Therapists

• Confirm the active child before you launch or review anything.
• Use child memory to preserve stable clinical observations over time.
• Review pending proposals before trusting an older recommendation run.
• Treat recommendation output as evidence-linked support, not an instruction to obey.
• Use plan provenance when discussing why a session plan was chosen.
• Flag sessions that need follow-up so later review is easier.
• Use the home cards for quick orientation, then move into the dashboard for detailed review.
• Write therapist memory notes when a short practical observation should shape the next few sessions.
• Use redaction controls when sharing reports with parents or schools to keep clinical detail appropriate for the audience.
• Preview PDF exports before sending to confirm layout and redacted sections.

17. Glossary

18. Troubleshooting