
How Presets Work
Presets use tag-based matching to connect with workflows. Every preset declares atag that specifies what kind of workflow inputs it targets. When you load presets for a workflow, Reliant matches the preset’s tag against the workflow’s tag or a group’s tag for multi-agent workflows. Only presets with matching tags appear as options.
A preset with tag: agent works with any workflow that has tag: agent on its inputs or groups. The same researcher preset can configure a standalone agent workflow, or configure just the research phase of a multi-phase workflow—the tag matching handles it automatically.
Presets can be partial. A preset doesn’t need to specify every parameter the workflow accepts. It might only set model and temperature, leaving other parameters to their defaults or to be configured inline.
However, every parameter a preset does specify must exist in the target workflow. Presets can’t include unknown or extra parameters—strict validation catches typos and stale parameters early rather than silently ignoring them.
When multiple presets match different groups in a workflow, each group gets its own preset selection. A multi-agent workflow might have one group configured with the researcher preset and another with the code reviewer preset.
Targeting Top-Level Inputs with “default”
In multi-group workflows, you may need to apply a preset to the workflow’s top-level inputs (those not in any group). The special group namedefault targets these ungrouped inputs.
default has this special meaning, you can’t name your own input groups default. If you try, the workflow will fail validation with an error indicating that default is reserved.
Provider-Agnostic Model Selection
Presets use tag-based model selection to work across different AI providers. Instead of hardcoding a specific model likeclaude-4.6-opus, presets specify what they need semantically:
flagship— Best quality for complex tasksmoderate— Good balance of quality and costfast— Quick responses for simple taskscheap— Lowest cost for budget-conscious usagereasoning— Extended thinking capabilitylocal— Runs on local hardware (Ollama, LM Studio, etc.)
tags: [local, fast] prefers models with both tags, but falls back to local-only or fast-only models if no perfect match exists. This enables graceful degradation—presets work whether or not users have local models configured.
Built-in Presets
Reliant includes a suite of built-in presets for common development roles. These are available immediately without configuration.| Preset | Model | Key Tools | Purpose |
|---|---|---|---|
| general | claude-4.6-opus | tag:default, tag:mcp | Versatile coding assistant with discovery-first approach. Can spawn specialized agents. |
| researcher | claude-4.6-opus | tag:search, tag:web, view, bash | Codebase investigation and analysis. Methodical process: planning, architecture analysis, pattern recognition. |
| planner | claude-4.6-opus | view, tag:search, create_plan | Strategic orchestration. Synthesizes research into step-by-step implementation plans. |
| code_reviewer | claude-4.5-sonnet | tag:search, tag:web, view, bash | Code quality feedback. Evaluates correctness, security, maintainability. Read-only. |
| tester | claude-4.5-sonnet | view, write, edit, patch, bash | Test suite creation. Builds harnesses, writes unit/integration/E2E tests. |
| reproducer | claude-4.5-sonnet | view, edit, tag:search, bash | Runtime bug reproduction. Discovers entry points, adds logging, captures evidence. |
| debug | claude-4.5-sonnet | view, tag:search, bash | Debugging orchestrator. Spawns researchers, testers, reproducers to find root causes. |
| refactor | claude-4.6-opus | view, edit, patch, write, find_replace, move_code | Systematic code improvement. Strict methodology: assess, verify tests, transform incrementally. |
| git | claude-4.5-sonnet | bash, view, tag:search | Version control operations. Conventional commits, atomic changes. |
| conflict-resolver | claude-4.5-sonnet | bash, view, tag:search, edit, patch | Git conflict resolution. Classifies conflicts, preserves intent from both branches. |
| documentation | claude-4.5-sonnet | view, write, edit, bash, fetch | Technical writing. Narrative-driven docs that teach through explanation and example. |
| ux | claude-4.5-sonnet | fetch, glob, grep, view, write, edit, bash | UI design and implementation. WCAG 2.1 AA compliant, various style modes. |
| workflow_builder | claude-4.6-opus | update_workflow, validate_workflow, view, grep | Workflow modification through conversation. Analyzes codebase, suggests patterns. |
| auditor | claude-4.5-sonnet | tag:search, view, bash | Post-implementation QA. Checks completeness, correctness, cleanup before merge. |
Detailed Examples
researcher is ideal when you need to understand a codebase before making changes. It follows a methodical investigation process: planning and scope definition, architecture and codebase analysis, pattern recognition, and historical analysis. The agent maps dependencies, identifies conventions, and documents findings—producing research that informs implementation decisions. refactor handles structural code changes safely. It uses specialized tools likefind_replace for renaming across files and move_code for relocating functions. The strict methodology requires: assess and plan the changes, verify tests pass before starting, execute incremental transformations, and verify behavior preservation after each step.
debug coordinates the debugging process by spawning specialized agents rather than doing everything itself. It delegates investigation to researchers, test isolation to testers, and runtime evidence gathering to reproducers. The goal is identifying the root cause with high confidence before any fix is attempted.
Creating Custom Presets
Custom presets live in.reliant/presets/ in your project directory. Each preset is a YAML file:
Preset Structure
tag field determines which workflows and groups this preset can configure. Most presets use tag: agent to match the standard agent workflow inputs.
Configurable Parameters
model: The AI model to use. Specify by explicit ID ({ id: "claude-4.6-opus" }), by semantic tags ({ tags: [flagship] }), or constrain to a specific provider ({ tags: [moderate], provider: "anthropic" }). Tag-based selection makes presets provider-agnostic—they work with whatever providers you have configured. Available tags include flagship, moderate, fast, cheap, reasoning, and codex for code-optimized model selection where supported.
temperature: Response randomness from 0.0 to 1.0. Lower values (0.1-0.3) produce focused, deterministic output for research and debugging. Higher values (0.7-1.0) increase creativity for brainstorming.
system_prompt: Instructions defining the agent’s role, approach, and constraints. This is where you customize behavior most significantly.
tools: Tools the agent can access. Specify by name (view, edit, bash) or by tag (tag:search, tag:default, tag:mcp).
compaction_threshold: Token count that triggers conversation compaction.
max_turns: Maximum conversation turns before the agent stops.
Tool Specification
!tag:shell— exclude an entire tag after includesmcp__server__*— include all MCP tools from a server via wildcard!mcp__server__tool— remove a specific tool
tag:default, tag:mcp) with precise exclusions for safer preset defaults.
Config-as-Code
Presets in.reliant/presets/ are regular files that can be checked into version control:
Team standardization: Share agent configurations across your team. Everyone uses the same carefully tuned presets.
Project-specific customization: A security-focused project might have stricter code review presets. A documentation project might have presets optimized for technical writing.
Iterative improvement: Refine your presets and commit the improvements. Your agent configurations evolve alongside your codebase.
Override built-ins: Project presets with the same name as built-in presets take precedence. Create a general.yaml in your project to customize the general preset without changing Reliant itself.
Preset Loading Order
- Built-in presets (embedded in Reliant)
- Project presets (from
.reliant/presets/)
Examples
Specialized Debugging Preset
For complex debugging sessions requiring maximum context:Fast Implementation Preset
For straightforward tasks where speed matters:Security Audit Preset
For security-focused code review:Managing Presets in the UI
While presets can be created as YAML files, Reliant also provides UI-based management.Viewing Presets
Open the Workflow/Preset selector in the app header (top-left). All available presets appear organized into:- Your Presets - Custom presets you’ve created
- Built-in Presets - System presets that come with Reliant
Editing Presets
Hover over any non-built-in preset to reveal edit and delete buttons. Click the pencil icon to modify the name and description. For project presets (YAML files in.reliant/presets/), editing updates the file directly.
Note: Built-in presets can’t be edited. To customize one, create a project preset with the same name—it will override the built-in version.
Deleting Presets
Click the trash icon on any custom preset to delete it. For project presets, this removes the YAML file. Deletion can’t be undone.Setting Default Presets
Default presets automatically apply when you start a new chat:- Go to the Workflows tab
- Hover over a workflow with a preset badge
- Click the gear icon
- Select your preferred preset
- Click Save
Creating Presets from Chat
The easiest way to create a preset is to save your current configuration:- Configure your workflow parameters (model, temperature, tools, system prompt)
- Click Save as Preset in the parameters panel
- Enter a name and description
- Click Save
.reliant/presets/ and becomes available immediately.
What Gets Saved
- Model, temperature, tools, system prompt
- Tag (inherited from current workflow/group)
Best Practices
Name presets descriptively. Use names indicating purpose:fast-prototyping, careful-refactor, security-audit. Avoid generic names like my-preset.
Write useful descriptions. Include what makes the preset different: “Lower temperature for deterministic debugging” or “Opus model for complex architectural decisions.”
Start from built-in presets. If one is close to what you need, select it first, make adjustments, then save as new.
Related Topics
- Multi-Agent Patterns - How presets configure agents in multi-agent workflows
- Workflows - Overview of the workflow system
- Creating Custom Workflows - Build workflows that use your presets