AI Adjustments before or after generation
AI Adjustments turns your instructions into repeatable adjustments. AI chooses Before Generation when someone needs a monthly allocation first, or After Generation for repairs and conditional coverage. The preview shows its choice. Saved adjustments use ordinary eligibility checks, with no AI involved in generation.
- Create the relevant roles and choose their eligible rosters first. For a role filled only by a pattern or finishing rule, keep the role enabled and turn off its ordinary fill checkbox in Coverage & Roles.
How to do it
- 1
Allocate monthly shifts first
For example: Give Anderson ten hospitalist shifts per calendar month on eligible dates, then generate around them. A Before Generation preview shows a plan from locked assignments. Save Adjustment saves the rule without changing the calendar. Press Generate to place those shifts and fill the rest. Dates can change between attempts; the generator prevents additional shifts above the target while preserving existing locks. The result reports any target it could not safely reach.
- 2
Add a rule
Open AI Adjustments in the sidebar. Choose Add Adjustment for conditional coverage, monthly targets or day-of-week balancing. Templates provides weekly empty-role rules, holiday handoffs and Saturday quotas, which the AI entry does not yet interpret. The same section is available in Guided setup.
- 3
Ensure backup when a person holds Call
For example: Whenever Taylor is on Call or Weekend Call, assign Backup from the Physicians group. Prefer the physician assigned to OR that day; otherwise use another available physician. One adjustment can cover both source roles and this preference. The preview names its interpretation; Details shows the full scope. Saved roster groups and shared call pools help resolve your wording. Backup eligibility still applies, and OR stays unchanged.
- 4
Describe and preview monthly targets
For example: Give Anderson, Brown and Clark six primary calls per calendar month, exchanging with Davis or another physician. AI translates your request into a saved rule; ordinary code searches for safe changes and verifies them. Review the monthly before, after and target counts, changed assignments, and anything still unresolved. If the request is unsupported or unclear, revise it before applying.
- 5
Balance particular days
For example: Even out Tuesdays and Thursdays across the schedule and each month, avoiding consecutive weeks when possible. You do not need exact counts. Safe swaps preserve each physician's monthly total, availability, spacing, holidays and patterns. Any day of the week is supported, but grouped weekend blocks stay intact. Unsolved imbalance is reported.
- 6
Combine several goals
Describe the goals together, such as monthly call targets plus Thursday balancing. One saved adjustment can contain several steps behind the scenes. Review the combined plan, then apply or save it. Later steps preserve earlier protections. A plan that includes Before Generation allocation is saved for Generate without changing the current calendar.
- 7
Apply once or keep the adjustment
Leave Run automatically after future generations checked to apply safe changes and save the rule. Uncheck it to apply once. Future generations run saved rules without AI. A changed schedule, request or setting requires a fresh preview. You can save a rule even when the current schedule has no safe improvements.
- 8
Leave a role empty in a physician’s week
Choose the weekly block role, the day its week starts, the physician, the role to clear and the weekdays. For example, leave Clinic empty Monday through Friday when Anderson holds the Monday-starting Call week.
- 9
Keep an outgoing physician on a holiday
Choose the block role and start weekday. When that day is a saved holiday, its assignment changes to the preceding day’s physician if eligible. Later days and linked roles stay as generated. A missing preceding assignment or a lock is reported.
- 10
Assign Saturday quotas
Choose the Saturday role, inclusive date range and each physician’s number of shifts. Assignments must fall in that physician’s own block and on a day they hold the block role. You can exclude particular physicians’ weeks and weekends with a saved holiday anywhere Friday through Monday. An optional Monday role preference chooses Saturdays followed by that existing assignment; it never moves Monday work.
- 11
Save and generate
Save Adjustment commits the settings. Each adjustment has a short editable title, a Before Generation or After Generation label, and a checkbox to enable or pause it. Edit opens your instruction and the full saved explanation; Save Title does not run AI or change the schedule. Before Generation allocations run first. After ordinary scheduling and balancing, empty-cell rules run, followed by holiday handoffs, Saturday quotas, conditional coverage, monthly repairs and day-of-week balancing.
- 12
Review what happened
Open the generation summary’s Adjustments Applied section. It lists changed cells, intentional empty cells, adjustments that could not be applied, and remaining conflicts. Click a changed date to find it in the schedule.
Good to know
- If a roster entry represents unfilled coverage, say so explicitly and ask to override its personal requirements. For example: Unfilled is a coverage placeholder, not a person; ignore its availability, post-call and spacing requirements. The preview names the user override. This rule must be saved so the calendar remembers the exception. Real physicians retain their protections, and locks, weekends, holidays, patterns and other roles stay unchanged.
- Monthly repairs try direct transfers and exchanges, then complete two- or three-cell transfer chains. All changes in a chain must pass validation together. No temporary unsafe assignment is applied.
- Finishing rules are currently available only to pilot accounts. The section appears when your signed-in account has access.
- Conditional coverage never assigns the person on Call as their own Backup. A valid existing backup stays unless an eligible preferred physician can safely replace it. If the preferred physician cannot cover, eligible fallback coverage remains and the unmet preference is reported. Locks, existing holiday assignments, grouped patterns, preferences, absences, recovery, spacing and other roles remain protected. Approved group members are saved explicitly; later group changes do not silently widen the rule.
- After Generation monthly repairs count every day, but only existing unlocked Monday–Thursday assignments can move. Before Generation allocations can use eligible dates on any weekday; holidays, patterns, preferences, locks, absences, recovery and spacing remain protected. Temporary protection during generation does not add user locks. Open is treated as a named physician unless an After Generation rule explicitly records a placeholder override.
- An unmet monthly target is acceptable. Safe improvements elsewhere remain; the rule never adds a conflict to force the count. The search is limited, so No safe repair found does not mean no possible arrangement exists. Partial calendar months stay unchanged, and overlapping monthly targets for one role must be combined.
- Holiday handoffs offer an explicit option to apply despite a same-day role conflict. The overlap remains reported in the summary and calendar. This option never overrides a lock, absence, recovery rule or minimum spacing.
- Locks always win, including locked empty cells. A rule blocked by a lock is reported. Finishing changes are not automatically locked.
- Saturday rules manage unlocked Saturday cells of their target role in the rule’s range. Preserved assignments, including ones outside a partial regeneration window, count toward the quota. Invalid preserved assignments or excess locked shifts remain visible for review.
- If there are not enough eligible Saturdays, generation reports the shortfall. It does not rearrange the Night Call rotation to manufacture additional weeks.
- The block owner is the physician assigned on its starting day before finishing edits. Missing context is reported; the generator does not guess from a substitute later in the week.
- Removed roles or physicians leave a visible rule that needs editing. No rule silently expands to everyone. Conflicting rules and overlapping Saturday quotas are reported.
