AI-Rig CLAUDE.md

• Any policy change in one listed instruction file must trigger a relevance review of every other listed file before completion.
• Synchronize applicable shared policy in either direction.
• Preserve intentional agent-specific differences.
• Record when no counterpart change is needed.

Instruction Layering

Repository-wide policy belongs in this top-level file. Lower-scope instruction files inherit it and must add only narrower rules or explicit exceptions, never repeat the same policy.

When a top-level policy changes, review lower layers for conflicts or obsolete duplication rather than copying the new text into them.

Edit Scope — Hard Constraint

ALL edits must stay within this project directory. Never directly edit ~/.claude/ or $CODEX_HOME (cache, settings, hooks, or any file under the user home).

Permitted edit roots (project-local):

• .claude/settings.json, .claude/settings.local.json — project Claude config
• .codex/ — project Codex config, skills, session policy (mirrored to $CODEX_HOME by Makefile, never edited there)
• plugins/*/{agents,skills,rules,hooks,bin}/ — plugin source

Propagation to live cache at ~/.claude/plugins/cache/:

• Makefile installs from the pushed GitHub remote, not local working tree — commit and push first, then make sync-claude
• Never run make sync-*/make clear-* against uncommitted/unpushed changes — cache will not reflect them
• Never suggest or initiate propagation mid-workflow
• Applies to all skills — no skill auto-syncs

Lint/Format — Use pre-commit Hooks, Not Direct Tools

Repo pins lint/format tools via .pre-commit-config.yaml (ruff, eslint, mdformat, prettier, codespell, etc). Never invoke these tools directly (ruff check, ruff format, eslint, mdformat, ...) — version/config drift vs CI.

Invoke the specific hook instead:

pre-commit run <hook-id> --files <path>   # single hook, targeted files
pre-commit run --all-files                # full sweep
pre-commit run <hook-id> --all-files      # single hook, repo-wide