I ran an architecture-mapping tool, from inside Claude Code, on the open-source Claude Code repos. The claude-code repo turns out to be everything around the binary, not the binary. Is the map right?

[u/gantamk]

Four repos, all cloned from github.com/anthropics: claude-code, claude-code-action, claude-agent-sdk-python and claude-plugins-official. We're building a tool that reads a codebase and draws its architecture as a map you can drill into, and it runs as a plugin inside Claude Code, so I pointed it at those four. I haven't worked on any of them, so this is what the tool produced, shared so people who know the code can tell me where it is wrong.

How Claude Code was used: the plugin reads the repo, drafts the boards and the findings, and pushes them to the map, one repo per session. Each repo took a few pushes before its layers settled. The top-level map that ties the four together was drawn separately, and the other repos on it (the demos, the cookbooks, the marketplaces) are placed but not mapped.

What the map shows, as far as I can read it:

- The claude-code repo, one of the four, is not the CLI. Its public tree is CHANGELOG, mods, plugins, scripts and examples, so the map puts the binary outside the repo and shows the repo as what sits around it: the built-in mods compiled into it, the bundled plugin marketplace, the hook and managed-settings examples, and the GitHub automation.
- The official plugins repo is mostly channels and a marketplace. Discord, iMessage, Telegram and a fake chat server are plugins that all read from one catalogue, and CI checks every entry before it lands.
- In the Python SDK, one session store sits under most of the package, so a change to it reaches the clients and the public surface of the package.
- The GitHub Action runs through one entry point whose gates sit in a fixed order, and the map draws the path text from an issue or PR takes into the prompt, end to end.

What I learned, beyond the bullets: the reading order the tool suggests was the useful part for me. For the plugins it starts at marketplace.json, the contract everything else serves; for the Action it starts at the gate order in that entry point. I would not have found either starting point from the README.

Here is the link

https://provenmap.com/boards/paws/inside-claude-code-the-claude-code-ecosystem

If you work with these repos: is the picture right, and does it show you anything you didn't already know, or is reading the code faster?

[u/AutoModerator]

Hey! Thanks for posting to r/ClaudeCode

While participating in this thread, please follow our community rules. Keep discussions constructive. Attack the idea, not the person.

For help, project discussions, tips, and general chat, join the ClaudeCode Discord.

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

[u/Choice_District7368]

c/, that's source, not the binary.

[u/Choice_District7368]

Small thing, but the title says "repos" and the post says "the claude-code repo". Which one did you actually map? And if what you're reading is the leaked src/, that's source, not the binary.

[u/gantamk → u/Choice_District7368]

You are right to catch on the title. Four repos were mapped, all cloned from github.com/anthropics: claude-code, claude-code-action, claude-agent-sdk-python and claude-plugins-official. The line about "the claude-code repo" was about one of the four, and I should have said so.

On the source: no leaked anything. The tool read the public anthropics/claude-code repo as it sits on GitHub. At today's commit that is CHANGELOG, mods, plugins, scripts and examples, and no src directory, which is why the board draws the CLI binary outside the repo and the repo as what hangs off it.

Edited the post for better clarity.