Turn repeated corrections into House Rules
For people who correct their agents a lot: House Rules spots the corrections you keep repeating, like "use pnpm", and proposes standing rules you approve.
House Rules is for people who find themselves correcting their agents the same way again and again, such as "no, use pnpm" or "run the tests first". It reads your past sessions on this computer, groups the corrections that keep coming back, and can turn them into rules every new session follows, once you approve them.
Turn it on#
Preview means House Rules is still in development and is off until you turn it on.
Then open it from the sidebar under AI Tools > House Rules. Your sessions are first read about a minute after you turn it on, then every 6 hours.
See what you keep repeating#
Recurring corrections lists corrections seen at least 3 times in at least 2 sessions, with the projects they came from.
Starting to repeat lists ones seen twice that don't count yet.
Reading and grouping happen on this computer for free. Keys, tokens and email addresses are scrubbed out before anything is stored, and sessions you didn't start yourself (scheduled or automated ones) are never read.
Get rules proposed and approve them#
Turn on Weekly lessons pass in the House Rules view.
Wait for Monday, or click Run now.
When proposals are ready, an Inbox item tells you, and they wait under Waiting for your review in the House Rules view. Click Review.
For each proposed rule, pick Approve, Edit the wording first, Discard, or Not now, then click Save choices.
Nothing becomes a rule until you approve that exact wording.
Where approved rules go#
Your House Rules lists the rules you approved. Rules for all projects are saved next to your Claude settings on this computer, and a project's own rules stay on this computer too, unless you turn on Commit this project's House Rules in Edit Project. Click Retire to stop using a rule.
Each rule also shows whether it is working: Measuring for its first 4 weeks, then whether the correction Stopped recurring, is happening less, or is still happening.
Limits. At most 30 rules for all projects, 20 per project, and 4,000 characters per rules file. An approval past a limit is refused with the reason; retire a rule first.
Leave a project out. Turn on Never read this project in Edit Project, or pick it in Projects House Rules never reads. House Rules then deletes the corrections it collected there.
From Weekly Session Analysis. A finding about CLAUDE.md can be sent to the same review list as a proposed rule. It reads Not measured, since it does not come from your own corrections.
Your phone and agents can't change the project switches; they are desktop only.
Related
- Let auto-replies answer your agentsAuto-replies answer or tidy up a session when its agent says something you expect, so work keeps moving while you are away.
- Keep your agent instructions in one placeCopy your CLAUDE.md or AGENTS.md into the files other AI coding tools read, and see what Default Agent Instructions writes into your projects.
- Give every session your project's documentsAuto Context shows everything a project hands its agents automatically: your instruction files and the documents in the project's .claude/docs folder.