Prompts
Section titled “Prompts”.openharness/prompts.yaml stores workspace-level prompt configuration.
It contains what used to live under system_prompt in settings.yaml, but now lives in its own file so runtime settings and prompt text can be managed separately.
Full Example
Section titled “Full Example”base: inline: |- You are Open Agent Harness running inside the current workspace. Prefer workspace-local configuration and tools.
llm_optimized: providers: openai: inline: |- Be concise, tool-oriented, and explicit about assumptions. models: default: inline: |- Prefer short, direct tool call arguments.
compose: order: - base - llm_optimized - agent - actions - project_agents_md - skills include_environment: falseTop-Level Fields
Section titled “Top-Level Fields”| Field | Required | Description |
|---|---|---|
base | No | Workspace-level base prompt |
llm_optimized | No | Provider- or model-alias-specific prompt additions |
compose | No | Assembly order for static system prompt segments |
Supports either inline or file:
base: inline: |- You are Open Agent Harness.base: file: ./.openharness/prompts/base.mdfile paths resolve relative to the workspace root.
llm_optimized
Section titled “llm_optimized”Prompt additions can target either providers or model aliases:
llm_optimized: providers: openai: inline: Be concise and tool-oriented. models: default: file: ./.openharness/prompts/openai-default.md| Rule | Details |
|---|---|
| Priority | models exact match > providers |
| Provider key | AI SDK provider identifier |
| Model key | Alias declared in settings.yaml -> models; resolved to a concrete model_ref during load |
compose
Section titled “compose”compose: order: - base - llm_optimized - agent - agent_switches - subagents - project_agents_md - skills - actions - environment include_environment: trueAvailable segments:
basellm_optimizedagentactionsproject_agents_mdskillsagent_switchessubagentsenvironment
| Rule | Details |
|---|---|
system_reminder | Not configured here; injected dynamically by the runtime |
actions | Auto-skipped when the current agent has no visible actions |
project_agents_md | Auto-skipped when AGENTS.md is absent |
skills | Auto-skipped when the current agent has no visible skills |
include_environment | Whether to append a runtime environment summary (default: false) |
note
For compatibility, the runtime still accepts legacy `system_prompt` config in `settings.yaml`; new configurations should prefer `.openharness/prompts.yaml`.