---
############################################
## Everything in this section is optional ##
############################################

# Role Configuration
name: <role-name>                     # The name of the role
model: openai:gpt-4o                  # The model to use for this role
temperature: 0.2                      # The temperature to use for this role when querying the model
top_p: 0                              # The top_p to use for this role when querying the model
reasoning_effort: null                # Reasoning effort level for models that support it (e.g. low, medium, high).
                                      # Only valid when the role's model declares reasoning_levels.
enabled_tools:                        # Tools to enable for this role. Accepts a YAML list (preferred)
  - fs_ls                             # or a comma-separated string (e.g. `enabled_tools: fs_ls,fs_cat`).
  - fs_cat                            # Use `all` to enable every visible tool.
enabled_mcp_servers:                  # MCP servers to enable for this role. Accepts a YAML list (preferred)
  - github                            # or a comma-separated string (e.g. `enabled_mcp_servers: github,gitmcp`).
  - gitmcp                            # Use `all` to enable every configured MCP server.
skills_enabled: true                  # Master switch for skills in this role (default: inherit from global).
                                      # Skills also require `function_calling_support: true` in the global config.
enabled_skills:                       # Skills available when this role is active. Accepts a YAML list (preferred)
  - git-master                        # or a comma-separated string (e.g. `enabled_skills: git-master,ai-slop-remover`).
  - ai-slop-remover                   # Must be a subset of global `visible_skills`. Omit to inherit the global default.
inject_skill_instructions: true       # Inject a short hint pointing the model at `skill__list` when skills are enabled 
                                      # (default: true). Suppressed automatically when no skills are available.
skill_instructions: null              # Custom text for the skill hint (optional; uses built-in default if null)
enabled_macros:                       # Macros invocable when this role is active. Accepts a YAML list (preferred)
  - generate-commit-message           # or a comma-separated string (e.g. `enabled_macros: generate-commit-message,review`).
                                      # An empty list disables all macros. Omit to inherit the global default.
memory: null                          # Per-role memory override (default: inherit). Set to `false` to disable memory
                                      # when this role is active. See the Memory wiki page.

prompt: null                          # A custom prompt to use for this role that will immediately query
                                      # the model for output instead of using the instructions below
# Auto-Continue (Todo System)
# The auto-continue system provides built-in task tracking for improved reliability.
# When enabled, the model can create todo lists and the system will automatically
# prompt it to continue when incomplete tasks remain.
# See the [Todo System documentation](https://github.com/Dark-Alex-17/coyote/wiki/TODO-System) for more information
auto_continue: false                  # Enable automatic continuation when incomplete todos remain (default: false)
max_auto_continues: 10                # Maximum number of automatic continuations before stopping (default: 10)
inject_todo_instructions: true        # Inject default todo tool usage instructions into the system prompt (default: true)
continuation_prompt: null             # Custom prompt used when auto-continuing. If null, uses built-in default
---
You are an expert at doing things. This is where you write the instructions for the role.
