Goals

What a Goal is

A Goal is a persistent, multi-day study commitment — “pass Step 1 in three months”, “master cardiology by the end of the month” — rather than a single request. It is where KoiSwarm remembers the outcome you are working toward, keeps a deadline and scope on file, and turns that commitment into work you can do today.

Goals are in beta. The feature is available in the workspace and through SuperAgent, but its wording, surfaces and limits may change.

How a Goal is created

Open Goals → New Goal, or turn on Goal mode under + in the SuperAgent composer. Both begin a conversation about the commitment you want to make.

1. State the commitment. Tell SuperAgent what you want to achieve and, when you know them, the deadline, exam format and how much time you can give each week.
2. Answer the clarifying questions. KoiSwarm asks for the details it cannot safely guess — the exam date, the material scope, the assessment format and what “done” looks like.
3. Review the contract. KoiSwarm proposes a contract: the outcome, scope, deadline, weekly minutes and a measurable success criterion.
4. Approve it. On approval the Goal is saved, and the scheduler turns it into a plan of daily tasks.

From commitment to daily work

An approved Goal becomes the input to Planning, which runs underneath. Planning reads the Goal’s scope, deadline and weekly minutes, extracts the examinable topics from your materials, and produces a continuous, feasible plan of daily tasks. Each task is tagged to the specialist that should do it — USMLE, MCQ, SAQ, Labelling or review — so the plan reads as “do this today” rather than “study everything eventually”.

Open today’s work

The Goal page puts the next task under Today, with its format and planned minutes. Select Open task to begin. Reading opens indexed excerpts from the linked teaching files, with a link to the original. Notes and written practice open a preparation screen, then the relevant agent when the material is ready. Spoken practice opens Live Talk with the Goal’s topic and sources carried into the composer.

Preparation uses the task’s confirmed scope and the current source index. If the index cannot match that task, return to the Goal to check its materials and scope before trying again. Saved questions and answers are retained. If preparation fails, use Retry from the preparation screen.

Keep materials and time current

Give each file its role: syllabus, exam scope, lecture material, reference, past exam or schedule. A syllabus defines what to cover; the teaching files provide what to study and practise. Clear roles help KoiSwarm use the right source for each task.

Use Edit plan to propose a new deadline, scope, priority or success criteria, then review the change before approving it. Shared time & notifications controls the availability that all active Goals share. A separate Goal does not create a separate supply of study time.

Progress comes from what you do

Practice performance is recorded as evidence for the Goal. Reading completion is your own report of time spent; it does not establish that you can answer questions on the material. The scheduler uses the available evidence and your time to decide what comes next, so the plan follows your real position rather than a fixed timetable.

An exam or other reported outcome is kept with the confirmed Goal contract it belongs to. If the requirements later change, the earlier result stays in history but does not confirm the new requirements. A completed Goal can reopen and need a result for its updated contract.

When KoiSwarm asks first

Some changes are material enough that KoiSwarm asks for your approval before applying them:

• changing the deadline or success criterion;
• removing scope;
• reducing the time available;
• a major change to the plan or assessment format.

Minor adjustments — a new file, a small scope addition, a day-to-day reshuffle — are applied automatically, and only touch future days: completed work and past days are never rewritten.

A tight schedule does not itself pause the Goal for another approval. Check its details for unallocated work or a shortfall in available time, then adjust the commitment or shared availability if needed.

Use it well

Keep the deadline, scope and weekly minutes honest, and do the practice inside the same workspace so the evidence KoiSwarm learns from is yours. A Goal produces a working plan; it does not promise the exam result. Review important clinical material against authoritative sources.