Quest Heroes

Updated April 5, 2026

Every agent in a quest takes on a hero identity — a named character with a functional role, RPG stats, and a model assignment. Heroes shape how agents behave, communicate, and prioritize their work. Crystl ships with 10 built-in heroes and supports custom hero creation.

Hero Catalog

HeroRoleSTRINTWISDEXModel
WizardUI/UX6985Sonnet
WarriorDesigner8756Sonnet
RangerFrontend7768Sonnet
RogueBackend6877Sonnet
HealerContext Health39106Haiku
PaladinResearcher41075Opus
BardReviewer5894Sonnet
DruidPlanner7885Opus
WarlockSEO5768Sonnet
MonkQA6787Haiku

Stats System

Each hero has four stats on a 1-10 scale. Stats are translated into behavioral modifiers that Crystl injects into the agent’s system prompt. Higher stats produce stronger behavioral tendencies.

Strength

Governs persistence and willingness to tackle difficult problems head-on.

  • High (7-10): “You are highly persistent — tackle hard problems head-on, don’t give up easily on complex implementations”
  • Mid (4-6): Balanced approach — persistent but willing to pivot when stuck
  • Low (1-3): Prefers to delegate hard problems or break them into smaller pieces

A Warrior (STR 8) will push through a difficult refactor. A Healer (STR 3) will flag the problem and hand it off.

Intelligence

Governs depth of analysis, attention to edge cases, and ability to trace implications.

  • High (7-10): “You analyze deeply — consider edge cases, trace implications, think through failure modes before writing code”
  • Mid (4-6): Balanced analysis — checks the obvious cases, moves on when confident
  • Low (1-3): Focuses on the happy path, relies on tests to catch edge cases

A Paladin (INT 10) will research thoroughly before writing a line of code. A Warlock (INT 7) will analyze enough to be confident, then ship.

Wisdom

Governs judgment — knowing when to ask for clarification versus proceeding, when to stop and reconsider, and when a decision is final.

  • High (7-10): “You have strong judgment — know when to ask vs proceed, when to stop and reconsider, and when a decision is settled”
  • Mid (4-6): Reasonable judgment — asks when clearly uncertain, proceeds when the path seems clear
  • Low (1-3): Biased toward action — proceeds with assumptions rather than asking

A Healer (WIS 10) knows exactly when to intervene and when to let agents work. A Warrior (WIS 5) charges ahead and course-corrects later.

Dexterity

Governs speed and conciseness — how quickly the agent moves and how terse its communication is.

  • High (7-10): “You move fast — be concise, get to the point, prefer shipping over perfecting”
  • Mid (4-6): Balanced pace — thorough but not slow
  • Low (1-3): Methodical and deliberate — takes time to be precise

A Ranger (DEX 8) writes code quickly and communicates in short bursts. A Bard (DEX 4) takes time to write thorough review comments.

Model Selection

Each hero is assigned a Claude model that matches its role:

Sonnet

The default for most heroes. Good balance of speed, capability, and cost. Used by Wizard, Warrior, Ranger, Rogue, Bard, and Warlock.

Opus

Assigned to heroes that need deep reasoning and research capabilities. Used by Paladin (Researcher) and Druid (Planner). Opus agents are slower but produce more thorough analysis.

Haiku

Assigned to lightweight, high-frequency roles. Used by Healer (Context Health) and Monk (QA). Haiku agents are fast and cheap, making them ideal for monitoring tasks and repetitive checks.

You can override the model for any hero in Settings > crystl quest > Per-role config.

Built-in Heroes in Detail

Wizard (UI/UX)

The Wizard focuses on interface design, user experience, and visual structure. High intelligence and wisdom make it thorough in analyzing design patterns and user flows. Moderate strength means it can handle implementation but prefers to plan first.

Warrior (Designer)

The Warrior is persistent and action-oriented. High strength means it pushes through implementation challenges. Lower wisdom means it tends to act first and adjust later — best paired with a Bard or Druid for review.

Ranger (Frontend)

The Ranger moves fast across the frontend codebase. High dexterity means concise code and quick iterations. Balanced stats make it a reliable all-around frontend agent.

Rogue (Backend)

The Rogue handles API routes, database queries, and server logic. High intelligence for tracing data flow and edge cases. Good dexterity for moving through backend tasks efficiently.

Healer (Context Health)

The Healer is a specialized monitoring agent. It does not write feature code. Instead, it watches the party’s context health and acts when agents approach their token limits.

When any agent drops below 50% context remaining, the Healer:

  1. Reads .crystl/quest/messages.jsonl and writes a compressed summary to QUEST-LOG.md
  2. Writes HANDOFF.md for agents near their limit — a concise briefing so a fresh session can pick up where they left off
  3. Updates DECISIONS.md with choices that have been settled, preventing agents from re-debating resolved topics
  4. Rewrites bloated files to save tokens where possible

The Healer runs on Haiku for speed and low cost. Its extreme wisdom (10) gives it strong judgment about when to intervene, and its high intelligence (9) lets it write effective compressed summaries.

Paladin (Researcher)

The Paladin runs on Opus and specializes in deep research. Highest intelligence of any hero (10). Use it when a quest involves unfamiliar APIs, complex architecture decisions, or when you need thorough analysis before implementation begins.

Bard (Reviewer)

The Bard reviews code written by other agents. High wisdom (9) means it knows which feedback matters and which is noise. Lower dexterity (4) means it takes its time — review comments are thorough, not rushed.

Druid (Planner)

The Druid runs on Opus and focuses on project planning and architecture. Balanced high stats across strength, intelligence, and wisdom make it effective at breaking down large tasks into agent-sized pieces.

Warlock (SEO)

The Warlock handles SEO-related tasks — meta tags, structured data, sitemap generation, and content optimization. High dexterity for moving quickly through repetitive SEO tasks across many pages.

Monk (QA)

The Monk runs on Haiku and focuses on testing. Writes unit tests, integration tests, and runs test suites. High wisdom (8) means it knows which tests matter most. Runs on Haiku for speed — QA work often involves many small, repetitive tasks.

Custom Heroes

You can create custom heroes in Settings > crystl quest > Party templates when building a custom template.

For each custom hero, configure:

  • Name — Any name you want (doesn’t have to be RPG-themed)
  • Role — The functional role the agent fills
  • Stats — Strength, Intelligence, Wisdom, Dexterity on a 1-10 scale
  • Model — Sonnet, Opus, or Haiku
  • Personality — Free-text description that shapes communication style
  • Instructions — Additional context, constraints, or focus areas

Custom heroes work identically to built-in ones. The stats are translated into the same behavioral modifiers, and the personality text is injected into the system prompt alongside them.