🤖 feat: load ~/.claude/CLAUDE.md as compat global instructions - #3918
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
@codex review |
This comment has been minimized.
This comment has been minimized.
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 6b09d6d001
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
6b09d6d to
966427a
Compare
|
@codex review |
|
Codex Review: Didn't find any major issues. Keep them coming! Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
This comment has been minimized.
This comment has been minimized.
|
@codex review |
|
Codex Review: Didn't find any major issues. Breezy! Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
This comment has been minimized.
This comment has been minimized.
1 participant
Summary
Loads the user's personal global Claude Code instructions file
~/.claude/CLAUDE.mdas a read-only, lowest-precedence global instruction source, gated behind the existing Claude compatibility experiment (formerly "Claude skills compatibility", sameclaude-skills-compatID).Fixes #3026
Background
Xum reads global instructions only from
~/.xum(base candidatesAGENTS.md→AGENT.md→CLAUDE.md), so users with personal instructions in~/.claude/CLAUDE.mdcould not bring them along. The repo already ships opt-in Claude compatibility for skills (.claude/skillsand~/.claude/skillsbehind theclaude-skills-compatexperiment, read-only, lowest precedence). This PR mirrors that mechanism for global instructions.Implementation
readClaudeCompatGlobalInstructionSet: reads only~/.claude/CLAUDE.md(noAGENTS.md/AGENT.mdcandidates, no.local.mdpairing, no.mux/companion, never a write target) withmuxOnly: false, so scopedModel:/Mode:directives in it stay ordinary markdown.~/.xumset, ordered before it in prompt order so native files layer on top and always win. A native~/.xum/AGENTS.mdnever silently disables the user's Claude instructions.InstructionSources.globalbecomes an ordered array of sets (compat first, then native) instead of a single nullable set; prompt builder, Instructions tab, and IPC all consume the same shape.~/.claudedirectory is a silent no-op.claude-skills-compat(persisted settings key). Docs updated indocs/agents/instruction-files.mdxanddocs/agents/agent-skills.mdx.Validation
Model:/Mode:headings inCLAUDE.mdnot extracted while native ones still are, decoy files in~/.claudeignored.Risks
Low. The feature is opt-in behind a default-off experiment; with it off the only behavioral surface is the
InstructionSources.globalshape change, which is compiler-verified across prompt builder, panel, and mocks. Compat reads are host-local and read-only.Generated with
mux• Model:anthropic:claude-fable-5• Thinking:xhigh