# shanraisshan/claude-code-best-practice architecture

> Architecture diagram of the GitHub repository shanraisshan/claude-code-best-practice, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shanraisshan/claude-code-best-practice
- Repository: https://github.com/shanraisshan/claude-code-best-practice

## Overview

This repository is a Claude Code practice and example collection, not an application runtime. Its user workflow is to consult a capability’s best-practice guide and, where provided, inspect a corresponding implementation or configured example. It also documents orchestration, hooks, MCP, and other capabilities. The tree and README support these capability relationships, but no source excerpts were provided, so the graph does not infer runtime call flow or connections among examples.

Main entry points: [`best-practice/claude-commands.md`](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-commands.md) (Commands Guide), [`best-practice/claude-subagents.md`](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-subagents.md) (Subagents Guide), [`best-practice/claude-skills.md`](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-skills.md) (Skills Guide), [`implementation`](https://github.com/shanraisshan/claude-code-best-practice/tree/main/implementation) (Implementation Guides)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guides["Guides and Practices"]
  node_subagents["Subagents Guide"]
  node_commands["Commands Guide<br/>[claude-commands.md]"]
  node_skills["Skills Guide<br/>[claude-skills.md]"]
  node_settings["Settings Guide<br/>[claude-settings.md]"]
  node_memory["Memory Guide<br/>[claude-memory.md]"]
  node_mcp["MCP Guide<br/>[claude-mcp.md]"]
  node_startup["CLI Flags Guide"]
end

subgraph group_examples["Configured Examples"]
  node_subagent_examples["Agent Definitions<br/>[agents]"]
  node_command_examples["Command Definitions<br/>[commands]"]
  node_skill_examples["Skill Definitions<br/>[skills]"]
  node_project_settings["Project Settings<br/>[settings.json]"]
  node_project_memory["Project Instructions<br/>[CLAUDE.md]"]
  node_mcp_config["MCP Config<br/>[.mcp.json]"]
  node_hook_examples["Hook Examples<br/>[hooks]"]
end

subgraph group_workflow["Workflow Materials"]
  node_weather_workflow["Weather Orchestrator"]
  node_workflow_guide["Orchestration Guide"]
end

subgraph group_reference["Reference Materials"]
  node_implementation_guides["Implementation Guides"]
  node_cross_model["Cross-Model Workflow"]
end

node_user(("Claude Code User"))

node_user -->|"consults"| node_subagents
node_user -->|"consults"| node_commands
node_user -->|"consults"| node_skills
node_user -->|"consults"| node_settings
node_user -->|"consults"| node_memory
node_user -->|"consults"| node_mcp
node_user -->|"consults"| node_startup
node_subagents -->|"implemented by"| node_subagent_examples
node_commands -->|"implemented by"| node_command_examples
node_skills -->|"implemented by"| node_skill_examples
node_settings -->|"configured in"| node_project_settings
node_memory -->|"implemented in"| node_project_memory
node_mcp -->|"configured in"| node_mcp_config
node_commands -->|"example at"| node_weather_workflow
node_weather_workflow -->|"documented by"| node_workflow_guide
node_subagents -->|"implementation guide"| node_implementation_guides
node_commands -->|"implementation guide"| node_implementation_guides
node_skills -->|"implementation guide"| node_implementation_guides

click node_subagents "https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-subagents.md"
click node_commands "https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-commands.md"
click node_skills "https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-skills.md"
click node_settings "https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-settings.md"
click node_memory "https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-memory.md"
click node_mcp "https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-mcp.md"
click node_startup "https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-cli-startup-flags.md"
click node_subagent_examples "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/agents"
click node_command_examples "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/commands"
click node_skill_examples "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/skills"
click node_project_settings "https://github.com/shanraisshan/claude-code-best-practice/blob/main/.claude/settings.json"
click node_project_memory "https://github.com/shanraisshan/claude-code-best-practice/blob/main/CLAUDE.md"
click node_mcp_config "https://github.com/shanraisshan/claude-code-best-practice/blob/main/.mcp.json"
click node_hook_examples "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/hooks"
click node_weather_workflow "https://github.com/shanraisshan/claude-code-best-practice/blob/main/.claude/commands/weather-orchestrator.md"
click node_workflow_guide "https://github.com/shanraisshan/claude-code-best-practice/blob/main/orchestration-workflow/orchestration-workflow.md"
click node_implementation_guides "https://github.com/shanraisshan/claude-code-best-practice/tree/main/implementation"
click node_cross_model "https://github.com/shanraisshan/claude-code-best-practice/blob/main/development-workflows/cross-model-workflow/cross-model-workflow.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_subagents,node_commands,node_skills,node_settings,node_memory,node_mcp,node_startup,node_user toneBlue
class node_subagent_examples,node_command_examples,node_skill_examples,node_project_settings,node_project_memory,node_mcp_config,node_hook_examples toneAmber
class node_weather_workflow,node_workflow_guide toneMint
class node_implementation_guides,node_cross_model toneRose
```

## Components

### Guides and Practices

- [Subagents Guide](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-subagents.md): `best-practice/claude-subagents.md`
- [Commands Guide](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-commands.md): `best-practice/claude-commands.md`
- [Skills Guide](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-skills.md): `best-practice/claude-skills.md`
- [Settings Guide](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-settings.md): `best-practice/claude-settings.md`
- [Memory Guide](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-memory.md): `best-practice/claude-memory.md`
- [MCP Guide](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-mcp.md): `best-practice/claude-mcp.md`
- [CLI Flags Guide](https://github.com/shanraisshan/claude-code-best-practice/blob/main/best-practice/claude-cli-startup-flags.md): `best-practice/claude-cli-startup-flags.md`

### Configured Examples

- [Agent Definitions](https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/agents): `.claude/agents`
- [Command Definitions](https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/commands): `.claude/commands`
- [Skill Definitions](https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/skills): `.claude/skills`
- [Project Settings](https://github.com/shanraisshan/claude-code-best-practice/blob/main/.claude/settings.json): `.claude/settings.json`
- [Project Instructions](https://github.com/shanraisshan/claude-code-best-practice/blob/main/CLAUDE.md): `CLAUDE.md`
- [MCP Config](https://github.com/shanraisshan/claude-code-best-practice/blob/main/.mcp.json): `.mcp.json`
- [Hook Examples](https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/hooks): `.claude/hooks`

### Workflow Materials

- [Weather Orchestrator](https://github.com/shanraisshan/claude-code-best-practice/blob/main/.claude/commands/weather-orchestrator.md): `.claude/commands/weather-orchestrator.md`
- [Orchestration Guide](https://github.com/shanraisshan/claude-code-best-practice/blob/main/orchestration-workflow/orchestration-workflow.md): `orchestration-workflow/orchestration-workflow.md`

### Reference Materials

- [Implementation Guides](https://github.com/shanraisshan/claude-code-best-practice/tree/main/implementation): `implementation`
- [Cross-Model Workflow](https://github.com/shanraisshan/claude-code-best-practice/blob/main/development-workflows/cross-model-workflow/cross-model-workflow.md): `development-workflows/cross-model-workflow/cross-model-workflow.md`

### Other components

- **Claude Code User**

## Connections

- Claude Code User → Subagents Guide: consults (evidence: `README.md`)
- Claude Code User → Commands Guide: consults (evidence: `README.md`)
- Claude Code User → Skills Guide: consults (evidence: `README.md`)
- Claude Code User → Settings Guide: consults (evidence: `README.md`)
- Claude Code User → Memory Guide: consults (evidence: `README.md`)
- Claude Code User → MCP Guide: consults (evidence: `README.md`)
- Claude Code User → CLI Flags Guide: consults (evidence: `README.md`)
- Subagents Guide → Agent Definitions: implemented by (evidence: `README.md`)
- Commands Guide → Command Definitions: implemented by (evidence: `README.md`)
- Skills Guide → Skill Definitions: implemented by (evidence: `README.md`)
- Settings Guide → Project Settings: configured in (evidence: `README.md`)
- Memory Guide → Project Instructions: implemented in (evidence: `README.md`)
- MCP Guide → MCP Config: configured in (evidence: `README.md`)
- Commands Guide → Weather Orchestrator: example at (evidence: `README.md`)
- Weather Orchestrator → Orchestration Guide: documented by (evidence: `README.md`)
- Subagents Guide → Implementation Guides: implementation guide (evidence: `README.md`)
- Commands Guide → Implementation Guides: implementation guide (evidence: `README.md`)
- Skills Guide → Implementation Guides: implementation guide (evidence: `README.md`)
