SDKModifying system prompts

Modifying system prompts

The system prompt is the set of instructions Syntic Code gives the model before your prompt. A program can replace it, add to it, or add text only for subagents. This page lists the flags and what each one does.

The Syntic Code SDK packages are not released yet. The options on this page are the ones the syntic command supports today.

Add to the end

--append-system-prompt adds text to the end of the built-in system prompt. The built-in instructions stay in place:

syntic -p "update the docs" --append-system-prompt "Write in British English."

--append-system-prompt-file reads the same text from a file.

Replace the whole prompt

--system-prompt replaces the built-in system prompt with your text. Nothing from the built-in prompt is kept, so write the full set of instructions you want the model to follow:

syntic -p "classify this ticket" --system-prompt "You classify support tickets. Reply with one word."

--system-prompt-file takes the same text from a file. If you pass both the inline and the file form, both are used, with the file’s text first.

Prefer --append-system-prompt unless you need to remove the built-in instructions. Replacing the prompt is the option most likely to change how the agent behaves.

Subagents

--append-subagent-system-prompt <text> appends your text to each subagent’s prompt, and --append-subagent-system-prompt-file reads it from a file. Each subagent’s own instructions come from its agent file; see Subagents for programs.

Keep the prompt cacheable

Per-machine details in the system prompt, such as paths, can stop a cached prompt from being reused on another machine. In a print run, --exclude-dynamic-system-prompt-sections leaves the per-user sections (working folder, platform and date, memory files, git status) out of the system prompt and sends them in the first context message instead, so the prompt is the same on every machine. See Prompt caching.

See what the prompt contains

--dump-system-prompt prints the system prompt that your settings and flags produce, then exits without running a task. Use it to check an append or a replacement before you run anything:

syntic --dump-system-prompt --append-system-prompt "Answer in German."

Output styles

An output style changes how the agent writes its answers. Pick one with --output-style for a run, or with /output-style in the app. Custom styles are Markdown files, and a style can keep or drop the coding instructions. See Output styles.