Pin a custom system prompt to a conversation

Set per-thread instructions that travel with every turn — "drafting agent" / "research agent" / firm-style — without touching the global system prompt.

Updated 2026-04-26

Every conversation in the agent drawer can carry its own pinned system prompt. Click the **Prompt** button in the drawer header (visible whenever a conversation is loaded) to open the editor.

When set:

- The pinned prompt is prepended to every turn's system context **before** any page-context block (current document, current collection, current search, route hint), so it sets tone before page context can override it. - The base Kodori system prompt is unchanged — your override layers on top, not in place of. - The drawer header's Prompt button fills with ochre when an override is active so you always know which mode the AI is in. - 4000-character cap (long enough for a paragraph or two of "always cite a clause number, never call mutation tools" instructions).

Three template chips seed the editor for common patterns:

1. **Drafting agent** — "Always cite the clause number when referencing a contract. Prefer formal tone. When the user asks for an alternative phrasing, return three options ranked by risk profile." 2. **Research agent** — "Never call mutation tools (no upload, delete, sensitivity change). Always include verbatim quotes for any claim, with the document id in backticks. If a question requires a mutation to answer, refuse and explain what tool the user should run themselves." 3. **Construction RFI agent** — "Default to RFI / submittal / change-order context. When summarizing a doc, surface dates, party names, and dollar amounts. Cite the document id in backticks."

Hit **Save** to pin, **Clear** to remove (or save with empty text), or **Cancel** to leave the existing pin alone. Pins are per-conversation, per-user — your prompts don't leak to teammates and one conversation's mode doesn't affect another's.

Useful patterns we've seen:

- A paralegal pins "research agent" on a thread for an active matter so the agent never accidentally renames or restores documents while they're investigating. - An AEC project manager pins a project-specific preamble ("This is the Foothill Bridge project. Default to drawing-set context. Always cite RFI numbers.") so daily questions about the project don't need to re-establish context every time. - A drafting attorney maintains parallel "drafting" and "review" threads with different tone settings.

The override is bypassed by all the standard safety primitives — permission trimming still applies, deny-wins on legal holds still applies, the agent still asks for an explicit reason before consequential actions. Pinning a "do whatever I say" prompt won't lift any of those gates.