rules-keeper

name	rules-keeper
description	Use at the start of every conversation and before every task - maintains rules and task state so important context survives compaction. Always active, no exceptions.

Rules Keeper

Overview

You have claude-rules-keeper installed. Context compaction erases your memory. You maintain rules across 4 scopes:

Scope	File	Lifetime
Session	~/.claude/rules-keeper/session-rules.md	Current conversation only (cleared on new conv)
Global	~/.claude/rules-keeper/rules.md	Permanent, all conversations
Project	~/.claude/rules-keeper/projects/<project>/rules.md	Permanent, when in that project
Task	~/.claude/rules-keeper/current-task.md	Current session only

At Conversation Start

1. Read session rules: ~/.claude/rules-keeper/session-rules.md (if exists)
2. Read global rules: ~/.claude/rules-keeper/rules.md
3. Read project rules: Detect project via git rev-parse --show-toplevel basename (if result equals $HOME, fallback to basename $(pwd)), read ~/.claude/rules-keeper/projects/<project>/rules.md if it exists
4. Follow ALL rules from all files

Auto-Detect Rules

When the user states a preference, constraint, or standard:

• Session preference → append to session session-rules.md
• Permanent preference → append to global rules.md (only if user says "toujours", "permanently", etc.)
• Project-specific preference → append to project rules file

Default to session scope unless the user explicitly wants it permanent. Confirm briefly: "Rule noted in [session/global/project] rules."

User Commands

Command	What it does
/rules-add <text>	Add session rule (this conversation only)
/rules-add-smart <text>	Claude reformulates, you validate, then saved
/rules-add-global <text>	Add permanent global rule (all conversations)
/rules-add-project <text>	Add permanent rule for current project
/rules-show	Show all active rules
/rules-remove	Remove a specific rule by number
/rules-clear	Clear all session rules
/rules-save <name>	Save all rules as reusable preset
/rules-load <name>	Load a preset into current session
/rules-doctor	Run diagnostic checks
/rules-upgrade	Check for updates and upgrade
/rules-status	Show status dashboard

Task State

Write to ~/.claude/rules-keeper/current-task.md at task start, after decisions, and before stopping. Keep under 15 lines.

After Compaction

If you see [COMPACTION RECOVERY]:

1. Read global + project + session rules - these are your standing orders
2. Read recovered task context
3. Confirm with user before continuing