Claude Config: Four Layers, Not One File — Find Your Settings
Claude's settings do not live in a single file. The video explains the four layers (agents, agent scopes, identity profiles and presets) and how the config-guide skill acts as an index to five reference files, with a warning about what happens when one goes missing.
It is natural to assume that Claude's settings live in one file. The video says they do not. They live in four layered objects, and the config-guide skill routes each question to one of five reference files. The video explains that structure, where the guide stops, and one quiet way it can fail.
The four layers
Claude's configuration model has four layers, described from the top down:
- Agents sit at the top.
- Agent scopes control how settings resolve and inherit, field by field, across a workspace.
- Identity profiles carry scopes, rules, credentials and repository permissions.
- Presets hold connections, GitHub repositories and custom instructions, attached to each profile.
Knowing which layer a setting belongs to is the key to finding it, rather than searching for a single configuration file.
An index, not an answer
The config-guide skill does not hold the answers itself. It is an index. When you ask a question, it opens one of five reference files: agents and scopes, identity profiles, connections and presets, GitHub and instructions, or best practices. The video says that splitting the skill into five short files instead of one long one is deliberate, so that each reference stays focused.
What the guide covers today
The video is clear about the guide's limits. Right now it covers only the Slack surface, and it does not say what changes elsewhere, so the video advises verifying fresh for anything outside Slack. After explaining any of this, the skill always closes the same way, pointing you to debug plugins in a brand-new Slack thread. A fresh thread means a fresh container that reflects your current configuration rather than a cached one. The video states plainly that this new-thread step is not busywork.
The quiet failure
The risk worth knowing is that the design works only because all five reference files are actually there. If one goes missing, nothing breaks loudly. The skill simply does not answer that part of your question, and you get no error telling you why. The guide's whole job is routing you to the right file, and it goes quiet rather than loud when that file is absent. The video limits its claims to what this skill specifies today and does not describe how Claude's configuration works outside it.
Key takeaways
- Claude's settings are not in one file; they are in four layered objects.
- The layers are agents, agent scopes, identity profiles and presets.
- Agent scopes control how settings resolve and inherit field by field across a workspace.
- The config-guide skill is an index that opens one of five reference files per question.
- The five files are agents and scopes, identity profiles, connections and presets, GitHub and instructions, and best practices.
- The guide currently covers only the Slack surface, so verify fresh elsewhere.
- If a reference file is missing, the skill silently fails to answer that part of the question.
Try it yourself
Paste a prompt into Claude describing an app with company-wide defaults, team overrides and per-user overrides layered on top of each other. Ask it to walk you through structuring those as layered objects, like agents, scopes and profiles, so a user's change is never silently overwritten by a team default. Then ask it to show you one way the design could quietly fail if a piece of it went missing. Use your own settings design rather than the video's example.
Chapters
Full transcript(auto-generated, with timestamps)
The naive framing: "where's the file with my settings?"
[0:00]Someone assumed Claude's settings live in one file. They don't. They live in four layered objects and the skill routes each question to one of five reference files. So, where's the layer that holds mine? Claude's configuration
Four layers, one index
[0:12]Model has four layers. Agents sit at the top. Agent scopes control how settings resolve and inherit field by field across a workspace. Identity profiles carry scopes, rules, credentials, and repo permissions, and presets connections, GitHub repos, and custom instructions attached to each profile. The skill itself doesn't hold the answer. It's an index. Ask a question and it opens one of five reference files: agents and scopes, identity profiles, connections and presets, GitHub and instructions, or best practices.
Slack only — verify fresh
[0:40]Splitting the skill into five short files instead of one long one is deliberate. Each reference stays focused. Right now, the guide covers only the Slack surface. It doesn't say what changes elsewhere. And after explaining any of this, the skill always closes the same way. It points you to debug plugins run in a brand new Slack thread. A fresh thread means a fresh container, reflecting your current configuration instead of a cached one.
Quiet when a file's missing
[1:02]Here's the risk worth knowing. This only works because all five reference files are actually there. If one goes missing, nothing breaks loudly. The skill just doesn't answer that part of your question, and you won't get an error telling you why. Claude's settings live across four
Carry-out
[1:16]Layers, not one file. The guide's whole job is routing you to the right one, and it goes quiet, not loud, if that file is missing. Your turn. Paste this into Claude. I'm
Your turn
[1:26]Designing settings for an app with company-wide defaults, team overrides, and per user overrides layered each other. Walk me through structuring that as layered objects like agent scopes and profiles, so a user's change never gets silently overwritten by a team default. Then show me one way the design could quietly fail if a piece of it goes missing. Four layers, not one file. Lay
Outro
[1:46]'em in for bear.
More from Claude
2:26Confluence API: Two APIs, Not One — What Claude Must Know
1:53BigQuery API with Claude: DONE Isn't Proof It Worked
2:15Claude Datadog API: Does Claude Already Know This API?
1:46Asana API with Claude: Unwrap Data, Trust the GID
1:40Debug Plugins: Your Claude Plugin Is Stale, Not Broken
1:48