# Our CLAUDE.md, agents and slash commands are symlinks into one git repo — retained record

> Retained reddit record from reddit:ClaudeCode.

Canonical: https://highsignal.app/data/records/e4ddb8264721996c

[← sources](https://highsignal.app/data)


source: [reddit](https://highsignal.app/data/reddit) (reddit:ClaudeCode)  published 2026-11-19 15:30 ingested 2026-11-20 02:39

[original source ↗](https://www.reddit.com/r/ClaudeCode/comments/1y0c7t5/our_claudemd_agents_and_slash_commands_are/)

## retained text



```
We run our small company out of Claude Code sessions. A kernel CLAUDE.md in the home directory routes tasks to custom agents and lists the rules, like nothing gets sent automatically and only verified numbers go into reports. There are also a handful of agent definitions and slash commands.

All of those live in one git repo. The CLAUDE.md in the home folder, the agent files under ~/.claude/agents and the commands are symlinks into it. We edit and commit in the repo, never through a copy, and the rule is to never replace a link with a copy.

The point is that every change to how our agents behave is a commit with a message, and can be rolled back.

Our knowledge base is a separate repo with its own CLAUDE.md, the schema the agents follow when they write notes. Client projects have their own as well. The kernel tells the agent to switch to the project folder for code work instead of editing from the home directory.

How do you version your CLAUDE.md and custom agents? Same repo as the project, dotfiles, or not at all?
```



document fetched 2026-11-20 00:41 · canonical https://reddit.com/r/ClaudeCode/comments/1y0c7t5/our_claudemd_agents_and_slash_commands_are
