Skip to main content
Write an instruction once, such as “Always use type hints,” and Qualia follows it in every chat. A rule is a saved instruction that Qualia adds to an agent’s context, either on every message or only when you mention it. To package a step-by-step procedure instead, write a skill. See Skills vs rules for when to use each.

What is a rule?

A rule has four parts:
  • Name: lowercase letters, numbers, and hyphens, such as python-style.
  • Description: an optional summary shown when you mention the rule.
  • Instructions: the guidance itself.
  • Mode: whether the rule applies on every message or only when you call it.
Rules persist across sessions. You manage them from Customize agent, the page where you also manage skills, hooks, and MCP servers.

Rule modes

  • Always applied rules join every message’s context with no action from you. Use them for preferences you always want, such as “Use SI units for all measurements” or “Never delete files without confirmation.”
  • Manual rules apply only to a message that mentions them. Use them for guidance you need sometimes, such as conventions for one kind of analysis.

Rule scope

Under Applies in, every rule is either Global or This workspace:
  • Global rules apply in every workspace.
  • This workspace rules apply only in the current workspace.
Pick the scope when you create a rule, and change it later by editing the rule. If you administer an organization, Available to also lets you share a rule with your organization instead of keeping it to Just me. A shared rule applies in all members’ workspaces, and only admins can edit it.

Create a rule

  1. Open the gear menu in the titlebar, choose Customize agent, then choose Rules.
  2. Open the New rule menu and choose New rule.
  3. Choose where it applies, then enter a Name, an optional Description, and the Instructions.
  4. Choose a Mode: Always applied or Manual.
  5. Click Create.

Use a manual rule

To apply a manual rule, type @rule: followed by its name in your message:
“@rule:data-analysis Analyze this dataset and find anomalies”
Qualia adds the rule’s instructions to that message’s context only.

Add a file path rule

A file path rule points the agent at a folder of code on disk. With it, the agent assumes imports in your notebooks resolve from that path. To add one, open the New rule menu and choose New file path. File path rules are always applied. Like other rules, they can be global or scoped to a workspace. Use a global file path for code you share across workspaces, and make sure the path exists on the machine running the workspace.

CLAUDE.md and AGENTS.md

If your workspace root has a CLAUDE.md or AGENTS.md file, Qualia reads it on every message, like an always-applied rule. Keep workspace instructions in these files so that they live in version control beside your code.

Import rules

Import rules from other tools on local workspaces. These options read folders on the machine your workspace runs on, so they don’t appear in Qualia Cloud. Each option is in the New rule menu on the Rules page.
  • Import from Cursor copies the rules in ~/.cursor/rules/. A rule with alwaysApply: true becomes an always-applied rule; every other rule becomes manual.
  • Import from Claude Code copies the RULE.md files in ~/.claude/rules/ and in the workspace’s .claude/rules/ folder.
  • Import from file… asks for the full path to one file, such as a CLAUDE.md outside your workspace. Its contents become a new always-applied rule.
If a rule named like the imported file already exists, Import from file… skips it rather than replacing it. Rename the existing rule first if you want the file’s contents to win.

Re-import rules

Importing makes a copy, so later edits in Cursor or Claude Code don’t reach Qualia on their own. If you import again after the source changed, Qualia lists the rules it would replace and asks first:
  • Keep mine leaves your copies as they are.
  • Update from Cursor or Update from Claude Code replaces each listed copy with the source version. Edits you made to those rules in Qualia are lost.
Rules that are new to Qualia import either way. Workspace-scoped rules and rules named after a built-in rule are never replaced.

Edit rule files on disk

On local workspaces, open the New rule menu and choose Open Rules folder to open the rules folder in your file manager. Each rule has its own folder with a RULE.md file. Qualia picks up edits you make on disk automatically. Qualia Cloud has no rules folder to open, so edit rules on the Rules page instead.

How rules combine

Rules stack. Every always-applied rule, your workspace’s CLAUDE.md or AGENTS.md, and any manual rules you mention all apply to the same message. A common setup:
  • One always-applied rule for your global preferences.
  • Manual rules for different contexts, such as data analysis, model training, or visualization.
  • A CLAUDE.md for workspace-specific conventions.

Write effective rules

  • Be specific. Don’t write vague rules such as “write good code,” because they give the agent nothing to act on. Write “Use tqdm in for loops” or “Add docstrings to all functions” instead.
  • Keep each rule to one concern. Don’t mix Python style and chart styling in one rule, so that you can change each on its own.
  • Test new rules. After creating a rule, try a few prompts to confirm Qualia follows it.
  • Review rules as your work changes. Outdated rules keep steering the agent toward old habits.

Pipelines

A pipeline is a saved set of instructions that produces an artifact each time it runs, such as a report, dashboard, or presentation. Find pipelines under Customize agent > Pipelines. To start a run, select a pipeline and click Run now. Each run opens its own chat, which you’ll find under Pipelines in the Chats sidebar, and writes its own output. To create a pipeline, click New pipeline and fill in its Name, Target artifact, Artifact folder, and Instructions. You can also ask in chat, for example: “Make a pipeline that downloads Hacker News data and visualizes current trends.” The agent investigates the sources and asks you about missing decisions. Then it saves the instructions and continues in the same chat as run 1. The first run builds its artifact in its own output folder and leaves your existing files where they are. Later runs follow the saved instructions, write separate outputs, and can read earlier results to explain what changed. See Follow pipeline runs for how report outputs display. In a shared workspace, pipelines and their schedules belong to the person who created them. Collaborators can see the resulting files and run chats, and they manage their own pipelines. Two people’s pipelines with the same name keep separate run histories.

Scheduled runs

On Qualia Cloud, a pipeline can run on a schedule. In local workspaces, you start runs manually.
  1. Select the pipeline and click Edit pipeline (the pencil).
  2. Under Schedule, choose a Frequency: Every N minutes, Hourly, Daily, Weekly (pick the weekdays), Monthly (pick the day), or Custom cron.
  3. Choose a Timezone. Schedules follow that timezone’s clock, so 9 AM in New York stays 9 AM across daylight-saving changes.
  4. Choose when it Ends: Never, on a date, or after a number of runs. A schedule that reaches its end turns itself off.
  5. Check the summary and the next run times, then save.
The pipeline list shows each schedule’s next run time. Pause, resume, or remove a schedule at any time. A scheduled run starts even while you work in the workspace, and opens as a new chat. Scheduled runs are fully autonomous: the agent never stops to ask, because nobody may be around to answer. See Autonomous mode.
  • If the previous run is still going when the schedule fires, Qualia skips that occurrence instead of queuing it.
  • After downtime, Qualia starts at most one run, rather than replaying every missed run.
  • Scheduled runs pause when the account reaches its usage limit.
  • If the pipeline’s creator loses Owner or Editor access, its scheduled runs stop.