# Your rules, shared

> Excellent finds the rules you wrote for Claude Code and Codex, shows which reach only one of them, shares them on your OK, and can remind an agent of a rule before it breaks it.

You write rules for your agents in files like `CLAUDE.md` and `AGENTS.md`. Claude Code reads one, Codex reads the
other. A rule written for one often never reaches the other.

## Where Excellent looks

It reads your own instruction files, those in the folders your agents worked in, and those at the top of projects in
common folders such as `~/Sites`, `~/code` and `~/Developer`.

## See which rules reach only one

The menu lists them under **Not told to every agent**. With Pro, when you write a new rule that reaches only one, you
get a notification: **A new rule reaches only Claude Code** (or only Codex).

## Share them

Press **Share…** in the menu, on the Rules page, or in Settings under Rules. Excellent shows you exactly what it will
write before it writes anything. On your OK, it adds one marked block with the missing rules to the file the other
agent reads:

- for Codex, your own `~/.codex/AGENTS.md`, or each repository's `AGENTS.md` if you choose that in Settings;
- for Claude Code, your own `~/.claude/CLAUDE.md`, or each repository's `CLAUDE.md`.

It backs up each file first. **Take Shared Rules Out…** in Settings takes the block back out.

Sharing works between Claude Code and Codex. The other agents the check runs in don't get your rules from it.

## Remind agents of your rules

Reminders need Excellent Pro: they run in its live check. See [Free and Pro](https://www.excellent.so/docs/free-and-pro).

With **Remind agents of my rules** on, Excellent watches for an agent about to break a rule you wrote. It refuses that
action once, with your rule in your words. If the agent tries the same thing again, the normal check decides. It
reminds an agent of the same rule at most three times a session.

Reminders are off by default, and they need protection on. Turn them on in Settings, or on the Protection page under
the written-rules row.

A reminder quotes your rule and names the file it's in. It becomes part of the agent's conversation, which goes to its
provider like the rest of it.

## Never-delete and never-open

When your rules say a folder must never be deleted, or a file never opened, Excellent's check protects it. A few
folders are protected from the start: `~/.ssh`, `~/.aws`, `~/.gnupg` and your keychains, with everything in them, and
your home, Documents and Desktop folders themselves. For a check that holds however a command is written, turn your
rules into the [sandbox](https://www.excellent.so/docs/sandbox).

Source: https://www.excellent.so/docs/rules
