# Learned rules

> Rules Scout proposes from the corrections your reviewers keep making, and how nothing applies until a person accepts it.

When the same correction happens to more than one draft, it is probably a rule nobody has written down. The Playbook's **Learned** tab is where Scout proposes those rules. Each one carries the badge **Learned from your edits**, and none of them apply to your writing until you accept them.

![The Learned tab of the Playbook](/docs/screens/playbook-learned.png)
_Each proposal shows its confidence and the edits it was learned from._

## Where proposals come from

As reviewers edit drafts, apply flags, dismiss flags with a reason and send drafts back with notes, Scout keeps a record of what changed. Once a week it reads the last two months of that record and looks for the same correction happening more than once: a term always replaced, a structure always added, a claim always cut. When a pattern is clear enough, it appears here as a proposed rule, with the excerpts it was learned from.

Proposals arrive weekly rather than after every edit, which is why the tab does not change from day to day.

## What a proposal shows

- The rule, written as an instruction, as it would appear under [Rules](/playbook/rules).
- A **confidence** percentage.
- **Why Scout suggests it**, a disclosure quoting the edits the pattern was read from.
- Three actions: **Accept**, **Edit first**, **Not a rule**.

The heading counts them: "3 things Scout thinks it has learned. Patterns Scout noticed in your edits. None of them apply to your writing until you accept them."

## Deciding

**Accept** moves the rule into your playbook, in force from the next review.

**Edit first** opens the rule dialog with the proposed wording filled in, so you can tighten it before it applies.

**Not a rule** dismisses it. Scout stops proposing that pattern.

Owners and admins decide. Everyone can read the proposals.

## The Decided section

Below the open proposals, a disclosure headed "Learned rules you have already decided on (N)" lists what was accepted and what was dismissed, so the history of what Scout suggested is not lost when the queue is cleared.

## If there is nothing here

"Scout has not learned anything yet. As you edit drafts, Scout looks for the same correction happening more than once. When it finds a pattern, it proposes a rule here for you to accept or turn down." The fastest way to fill it is to review drafts and say why when you dismiss a flag or send one back.

## Related

- [Rules](/playbook/rules)
- [Flags, comments and sources](/content/flags-comments-and-sources)