Jean logoJean

Magic Prompts

Customize the prompt templates, models, and reasoning behind every built-in workflow in Jean.

Every magic command in Jean runs a prompt template.

The Magic Prompts pane lets you replace those templates, pick a different model or backend per workflow, and keep the rest of the flow unchanged.

What is customizable

Each built-in workflow exposes:

  • a prompt template
  • a backend override
  • a model override
  • a provider override (for Claude CLI)
  • a reasoning or thinking level override

That means you can keep the UI and command flow identical while changing the engine behind any single workflow.

Prompts you can edit

The pane covers the full set of built-in workflows:

Investigation

  • Investigate Issue
  • Investigate Pull Request
  • Investigate Workflow Run
  • Investigate Security Alert
  • Investigate Advisory
  • Investigate Linear Issue
  • Handle Review Comments

Git and PR work

  • Generate PR Content
  • Generate Commit Message
  • Code Review
  • Resolve Conflicts
  • Generate Release Notes

Session management

  • Session Naming
  • Session Recap
  • Context Summary

System prompts

  • Global system prompt (appended to every session)
  • Parallel execution prompt

Global system prompt

The global system prompt is appended to every session Jean starts.

Use it for:

  • house style rules
  • required tools or commands
  • documentation expectations
  • repo-wide conventions

Keep it short. It is added on top of each backend's default system prompt, so long blocks waste tokens on every request.

Per-workflow model choices

A common pattern is to mix models by workflow. For example:

  • a lighter model for session naming and commit messages
  • a heavier model for code review and PR investigation
  • a reasoning-heavy model for conflict resolution

The backend and model dropdowns for each workflow make this easy to set without changing your global defaults.

When to edit a prompt

Edit a prompt when:

  • the default output does not match your team's tone
  • you want a stricter format for PR titles or commit messages
  • a workflow needs extra guardrails (security, licensing, privacy)
  • you want an existing workflow to load additional context before answering

Leave the default when the existing output is already close to what you want. The built-in templates are tuned for the current backends.

Reverting

Every customized field can be reset to Jean's default.

If a prompt starts misbehaving after an edit, reverting is the fastest way to confirm the template is the cause.

Next reads

On this page