Skip to content

.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.

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: false
FieldRequiredDescription
baseNoWorkspace-level base prompt
llm_optimizedNoProvider- or model-alias-specific prompt additions
composeNoAssembly order for static system prompt segments

Supports either inline or file:

base:
inline: |-
You are Open Agent Harness.
base:
file: ./.openharness/prompts/base.md

file paths resolve relative to the workspace root.

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
RuleDetails
Prioritymodels exact match > providers
Provider keyAI SDK provider identifier
Model keyAlias declared in settings.yaml -> models; resolved to a concrete model_ref during load
compose:
order:
- base
- llm_optimized
- agent
- agent_switches
- subagents
- project_agents_md
- skills
- actions
- environment
include_environment: true

Available segments:

  • base
  • llm_optimized
  • agent
  • actions
  • project_agents_md
  • skills
  • agent_switches
  • subagents
  • environment
RuleDetails
system_reminderNot configured here; injected dynamically by the runtime
actionsAuto-skipped when the current agent has no visible actions
project_agents_mdAuto-skipped when AGENTS.md is absent
skillsAuto-skipped when the current agent has no visible skills
include_environmentWhether 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`.