This repository contains my sensible defaults for Claude Code.
npm install -g @anthropic-ai/claude-codeCLAUDE.md— User-scope memory and instructions (read every session)settings.json— User-scope settings (permissions, MCP servers, hooks, etc.)agents/— Subagent definitions (assembled from shared + frontmatter)skills/— Skill definitions (modular, each skill is a directory)commands/— Custom slash-command definitionsplans/— Persistent plansshared/— Shared AI config submodule (dotbrains/shared-ai-config)frontmatter/— Claude Code-specific YAML frontmatter for agents and skillsPLUGINS.md— External MCP servers and plugins (details)RULES.md— Rule definitions and usage (details)
| Agent | Purpose |
|---|---|
tech-lead |
Orchestrates complex workflows across specialist agents |
architect-designer |
High-level design, pattern selection, structural planning |
implementation-specialist |
Precise, scoped coding tasks with zero architectural drift |
requirements-clarifier |
Transforms vague requirements into actionable specifications |
test-automation-engineer |
Comprehensive test coverage, execution, and failure diagnosis |
task-decomposer |
Breaks overwhelming complexity into sequential action items |
| Skill | Purpose | Invocation |
|---|---|---|
ship |
Commit, push, and open a PR | /ship |
explain-code |
Explain code with diagrams and analogies | /explain-code or automatic |
pr-review |
Review a pull request thoroughly | /pr-review <PR number> |
The contents of this repository should be placed in your $HOME.
git clone --recursive https://github.com/dotbrains/claude.git $HOME/.claudeAgent and skill body content is shared with OpenCode via the shared-ai-config submodule. To update after shared content changes:
git submodule update --remote shared
./shared/assemble.sh claudeYou can pull in shared agents, skills, or commands from external repositories:
# Add shared skills
git submodule add https://github.com/example/claude-skills.git skills/shared
# Add community commands
git submodule add https://github.com/example/claude-commands.git commands/sharedThis project is licensed under the PolyForm Shield License 1.0.0 -- see LICENSE for details.