How to Use the Repertoire Line

The Repertoire Line turns a short, telegraphic line into maintained note content. You communicate only what is different or necessary for this encounter; your saved Templates, defaults, choices, and Building Blocks carry the rest of the wording.

It is deterministic. Repertoire does not send the line to a language model, invent a diagnosis, create clinical conclusions, or silently turn arbitrary prose into note text.

Repertoire is not an EMR or clinical decision-support system. The current public evaluation boundary remains no-PHI: use synthetic or non-identifying examples when trying typed details, never enter patient identifiers, and review every result before completing encounter-specific documentation in your approved EMR.

The quickest useful pattern

Write a Template, then only the choices and details that matter:

AOM: Augmentin, right; mother historian; S: Susan

This uses the AOM Template with its Augmentin and right-side choices, plus Mother historian and Spanish interpreter: Susan. Saved AOM defaults provide the rest.

Resolve a line

1. Type shorthand on an ordinary line in the note.
2. Leave the cursor on that line, or on the empty line immediately below it.
3. Select in the toolbar.
4. Review the generated note and resolved-results bar.

You can also use ⌘+Enter on macOS, Ctrl+Enter on Windows, or type /r after the shorthand. Type /p to keep the Repertoire Line visible and preview its current result. Edit the source line and use /p again to replace the preview, then /r to finish. To resolve wording already in the note, select it, right-click, and choose Resolve.

Autocomplete can suggest maintained names and choices while you type. Accepting a suggestion completes text only; it does not resolve the line.

How resolution proceeds

Repertoire uses a fixed priority so the same line produces the same result:

1. Template names, primary phrases, and saved aliases
2. choices owned by those resolved Templates
3. Building Block names and aliases
4. choices and bounded captures owned by those Building Blocks
5. explicit updates or suppressions for content already active in the note

More specific maintained phrases outrank shorter overlaps. A span of wording is consumed only once. If equally valid destinations remain, Repertoire reports ambiguity instead of choosing one.

Boundaries and punctuation

Semicolons end one segment and begin another. The next segment can be another choice for the current Template or a new Template or Building Block:

AOM: Augmentin; mother historian; follow up 1 wk

A colon explicitly attaches choices to an owner or fills a declared, bounded Building Block slot:

• AOM: Augmentin
• S: Susan

Commas separate peer choices or values within the same segment, as in AOM: Augmentin, right. Ordinary connective wording such as “please add,” “include,” “use,” and “with” is tolerated when it does not change ownership. Repertoire remains forgiving when punctuation is omitted, but explicit punctuation makes ownership easier to inspect.

Use maintained choices

Name a Template followed by one or more of its saved choices:

AOM: Augmentin, right

An explicit choice replaces the saved default only in its own section. It does not disturb defaults in unrelated sections.

Aliases let the line remain terse. For example:

WCC: 6mo; mom historian; follow up 1 wk

Only aliases saved in the library and a deliberately small transparent shorthand set are recognized. Built-in shorthand includes mom/mother, dad/father, wk/week, wks/weeks, and number words from one through ten.

Choose a maintained medication

ADHD: Concerta; increase dose

Because Concerta is an exact maintained medication with one destination, it fills Current medication; increase dose separately selects the plan. Medication capture never infers an action. Label a destination medication, such as new med: Vyvanse.

Add verbatim encounter text

Use # for exact wording that should become a bullet. It runs until the next semicolon or the end of the Repertoire Line:

rash #Location: trunk, itching for 3 days

The bullet attaches to the nearest preceding Template, or stands alone if none precedes it. Use ## for a standalone plain line:

##Awaiting outside records

Repertoire trims surrounding whitespace but otherwise preserves the text; it does not match or learn it. A semicolon returns to normal syntax or starts another literal item: rash #First bullet; #Second bullet.

When wording remains unresolved, the result details offer the same paths immediately: insert it as a # bullet, insert it as a ## standalone line, search the library for it, or map the phrase to an existing maintained item. These actions do not add another syntax category; they help finish or teach the same library-focused workflow.

Fill a bounded Building Block slot

Building Blocks can declare a short text slot tied to maintained wording. The interpreter block uses this for Name/ID:

• S: Susan → Spanish interpreter: Susan
• French Susan → French interpreter: Susan
• HC: Susan → Haitian Creole interpreter: Susan
• V: Susan → Vietnamese interpreter: Susan
• S: D → Spanish interpreter available and offered but declined.
• F: Declined → French interpreter available and offered but declined.

One- and two-letter aliases require a colon, so S Susan and HC Susan remain unresolved. Help lists every supported language code. Captured values never become aliases or library wording.

If you insert the interpreter Building Block without a name/ID, the line ends at the colon—for example, Spanish interpreter:—instead of printing placeholder text.

List what is inside

Type /? after a Template or Building Block to reveal its choices, defaults, and fields. AOM: Augmentin /?, for example, marks Augmentin active. In the full editor, use ↑/↓ through the scrolling list. Command Bar and Quick Line show one gray italic option inside the input; use ←/→ to move. Tab or Enter inserts, and Escape dismisses. /? produces no note output; Ctrl-K remains global search.

Remove a maintained default

Put a hyphen directly before the maintained name or alias:

AOM; -amoxicillin

Only this explicit attached-hyphen form suppresses content. Words such as “no,” “not,” and “without” are not interpreted as commands because doing so could turn ordinary clinical wording into an unsafe instruction.

Change a choice already in the note

When exactly one active Template or Building Block can own a maintained choice, add instead:

Augmentin instead

If more than one active item could own that choice, Repertoire reports ambiguity.

Understand the result

The resolved-results bar reports:

• Resolved Templates: which maintained Template names or aliases matched
• Resolved choices: which explicit choices replaced defaults
• Captured Template details: each value, its destination field, and whether an explicit label or exact maintained choice recognized it
• Resolved Building Blocks: independent maintained content that was inserted
• Ambiguous: wording with more than one valid destination; choose the intended result from details
• Unresolved: meaningful wording that was not safely recognized
• Suppressed or updated: changes applied to maintained content already active in the note

Select the details control to inspect the exact interpretation. Select Help to review examples and repeated safe unresolved wording. Select Undo to reverse the complete resolution action.

Help is also the syntax reference. After a safe unmatched phrase appears twice, its bounded Alias destination search can connect it to an explicitly chosen Template, choice, or Building Block.

Each resolved Template or Building Block is inserted as a top-level block in source order. Semicolons make that intent easiest to inspect.

An explicit standalone follow-up interval, such as follow up one week, replaces a matched Template's saved follow-up default unless the line explicitly selects that Template's own follow-up choice. This prevents two competing follow-up instructions from being generated.

Edit the generated note

Generated bullets are real rich-text list items. Press Enter at the end of a bullet to continue the list. Formatted pasted text keeps supported rich formatting.

The first manual edit makes that generated block clinician-owned. Template controls will no longer overwrite or remove it. Changing a structured dropdown without editing the surrounding text keeps the block linked and system-owned.

Keep or remove the source line

By default, the original Repertoire Line remains above the generated content. In Note Settings, turn off Keep Repertoire Line in note when the shorthand should act only as an instruction. The resolved details remain available either way.

/p always keeps the source line visible while previewing, regardless of this setting. A later /p or /r rebuilds the preview from the edited Repertoire Line, replacing any direct edits made inside the preview. Make lasting changes in the Repertoire Line while previewing; edit generated note text only after /r finishes the resolution.

Complete maintained wording as you type

Optional autocomplete searches the Template, Building Block, and choice wording already stored in your local library. It is deterministic and does not call a model or transmit what you type. Open Menu → Note Settings to turn it on or off.

As you type, a gray italic suffix can appear on the same line:

• Press Tab to accept the first suggestion.
• When several suggestions appear, choose one or press its displayed 1, 2, or 3 key.
• Press Escape to dismiss suggestions for the current line.

Completion changes text only. It does not resolve the line or insert maintained clinical content; use the Repertoire Line control, /r, or the resolve shortcut when you are ready.

Teach Repertoire a new alias

When the same safe, patient-independent phrase is unresolved twice, the Repertoire Line help indicator offers it for review. Repertoire stores only the bounded phrase and a count—not the full line. Dates, contact details, number-heavy wording, identifiers, and other unsafe patterns are excluded.

To keep the wording:

1. Open Repertoire Line help and choose the intended Template, Building Block, or maintained choice.
2. Verify the destination, then choose Create alias.
3. Re-review the affected library item because recognition behavior changed.

Collision and short-alias checks still apply. Delete a phrase when it should remain unresolved, or clear the local log to begin a new observation period. The log stays in this browser and is excluded from library packages and model migration bundles.

What Repertoire deliberately will not infer

Repertoire does not infer:

• diagnoses or differential diagnoses from captured details
• negatives from words such as “no” or “without”
• medication, dose, severity, disposition, or other clinical conclusions that were not explicitly maintained or typed
• an open description without a declared field label
• a value when two Templates or fields could own it
• new synonyms merely because wording seems related

The goal is not to make the user write a prose note inside the Repertoire Line. Open captures stay short, typed, and field-specific. If a line begins to resemble a paragraph, the better solution is usually a new maintained choice, alias, Building Block, or Template default.

Syntax reference

Intent	Pattern	Example
Resolve a Template	Template	AOM
Choose maintained content	Template: choice	AOM: Augmentin
Add several concepts	separate with ;	AOM; mother historian
Separate peer choices	separate with ,	AOM: Augmentin, right
Supply a typed field	field: short value	duration: 3 days
Supply an open field	field: short value	appearance: raised red spots
Fill a Building Block slot	owner/choice plus value	S: Susan
Suppress maintained content	-choice	-amoxicillin
Change active content	choice instead	Augmentin instead
Add a verbatim bullet	#text	rash #Considered broader coverage
Add a verbatim plain line	##text	##Awaiting outside records
Resolve by keyboard	⌘/Ctrl+Enter	current or preceding line
Preview and keep source	append /p	AOM: Augmentin/p
Resolve inline	append /r	AOM: Augmentin/r
List nested structure	append /?	AOM: Augmentin /?

When in doubt, use semicolons between concepts and a colon before an open value, then select . Repertoire will still show exactly what it understood before the generated content leaves your editing workflow.

Next, try the Well Child Check examples, refine titles and aliases, or review your library for approval.