# chriswiles/claude-code-showcase architecture

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

- Interactive diagram: https://gitdiagram.com/chriswiles/claude-code-showcase
- Repository: https://github.com/chriswiles/claude-code-showcase

## Overview

This repository is a Claude Code configuration showcase: it equips Claude Code with project context, reusable domain skills, specialized agents, slash-command workflows, and automated hooks. The main user flow is an engineer prompting Claude Code, which can consult project memory and matched skills, then use commands or agents to carry out work such as ticket implementation and review. Settings also configure skill suggestions and quality gates; GitHub workflows add PR review and scheduled maintenance. Edges reflect README-documented behavior; source excerpts were unavailable, so implementation-level wiring is not inferred.

Main entry points: [`.claude/commands/ticket.md`](https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/commands/ticket.md) (Ticket Workflow), [`.claude/settings.json`](https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/settings.json) (Hook Settings), [`.claude/hooks/skill-eval.js`](https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/hooks/skill-eval.js) (Skill Evaluator), [`.github/workflows/pr-claude-code-review.yml`](https://github.com/chriswiles/claude-code-showcase/blob/main/.github/workflows/pr-claude-code-review.yml) (PR Review Workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Project Guidance"]
  node_memory["Project Memory<br/>[CLAUDE.md]"]
  node_skills["Domain Skills<br/>[skills]"]
end

subgraph group_interaction["Claude Workflows"]
  node_agents["Specialized Agents<br/>[code-reviewer.md]"]
  node_commands["Slash Commands<br/>[commands]"]
  node_ticket_command["Ticket Workflow<br/>[ticket.md]"]
  node_mcp_config["MCP Configuration<br/>[.mcp.json]"]
end

subgraph group_hooks["Prompt And Tool Hooks"]
  node_hook_settings["Hook Settings<br/>[settings.json]"]
  node_skill_rules["Skill Rules<br/>[skill-rules.json]"]
  node_skill_eval["Skill Evaluator<br/>[skill-eval.js]"]
end

subgraph group_automation["GitHub Automation"]
  node_pr_review["PR Review Workflow"]
  node_scheduled_maintenance["Scheduled Maintenance<br/>[workflows]"]
end

node_engineer(("Engineer"))
node_claude(("Claude Code"))
node_issue_tracker["JIRA / Linear"]
node_github["GitHub"]

node_engineer -->|"prompts"| node_claude
node_claude -->|"loads context"| node_memory
node_claude -->|"applies guidance"| node_skills
node_claude -->|"runs review"| node_agents
node_claude -->|"runs commands"| node_commands
node_claude -->|"uses settings"| node_hook_settings
node_hook_settings -->|"invokes evaluator"| node_skill_eval
node_skill_eval -->|"matches patterns"| node_skill_rules
node_claude -->|"runs ticket flow"| node_ticket_command
node_ticket_command -->|"uses servers"| node_mcp_config
node_ticket_command -.->|"reads and updates"| node_issue_tracker
node_github -->|"triggers review"| node_pr_review
node_pr_review -->|"reviews pull request"| node_github
node_github -->|"triggers schedules"| node_scheduled_maintenance

click node_memory "https://github.com/chriswiles/claude-code-showcase/blob/main/CLAUDE.md"
click node_skills "https://github.com/chriswiles/claude-code-showcase/tree/main/.claude/skills"
click node_agents "https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/agents/code-reviewer.md"
click node_commands "https://github.com/chriswiles/claude-code-showcase/tree/main/.claude/commands"
click node_ticket_command "https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/commands/ticket.md"
click node_mcp_config "https://github.com/chriswiles/claude-code-showcase/blob/main/.mcp.json"
click node_hook_settings "https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/settings.json"
click node_skill_rules "https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/hooks/skill-rules.json"
click node_skill_eval "https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/hooks/skill-eval.js"
click node_pr_review "https://github.com/chriswiles/claude-code-showcase/blob/main/.github/workflows/pr-claude-code-review.yml"
click node_scheduled_maintenance "https://github.com/chriswiles/claude-code-showcase/tree/main/.github/workflows"

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_memory,node_skills toneBlue
class node_agents,node_commands,node_ticket_command,node_mcp_config toneAmber
class node_hook_settings,node_skill_rules,node_skill_eval toneMint
class node_pr_review,node_scheduled_maintenance toneRose
class node_engineer,node_claude,node_issue_tracker,node_github toneIndigo
```

## Components

### Project Guidance

- [Project Memory](https://github.com/chriswiles/claude-code-showcase/blob/main/CLAUDE.md): `CLAUDE.md`
- [Domain Skills](https://github.com/chriswiles/claude-code-showcase/tree/main/.claude/skills): `.claude/skills`

### Claude Workflows

- [Specialized Agents](https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/agents/code-reviewer.md): `.claude/agents/code-reviewer.md`
- [Slash Commands](https://github.com/chriswiles/claude-code-showcase/tree/main/.claude/commands): `.claude/commands`
- [Ticket Workflow](https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/commands/ticket.md): `.claude/commands/ticket.md`
- [MCP Configuration](https://github.com/chriswiles/claude-code-showcase/blob/main/.mcp.json): `.mcp.json`

### Prompt And Tool Hooks

- [Hook Settings](https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/settings.json): `.claude/settings.json`
- [Skill Rules](https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/hooks/skill-rules.json): `.claude/hooks/skill-rules.json`
- [Skill Evaluator](https://github.com/chriswiles/claude-code-showcase/blob/main/.claude/hooks/skill-eval.js): `.claude/hooks/skill-eval.js`

### GitHub Automation

- [PR Review Workflow](https://github.com/chriswiles/claude-code-showcase/blob/main/.github/workflows/pr-claude-code-review.yml): `.github/workflows/pr-claude-code-review.yml`
- [Scheduled Maintenance](https://github.com/chriswiles/claude-code-showcase/tree/main/.github/workflows): `.github/workflows`

### Other components

- **Engineer**
- **Claude Code**
- **JIRA / Linear**
- **GitHub**

## Connections

- Engineer → Claude Code: prompts
- Claude Code → Project Memory: loads context
- Claude Code → Domain Skills: applies guidance
- Claude Code → Specialized Agents: runs review
- Claude Code → Slash Commands: runs commands
- Claude Code → Hook Settings: uses settings
- Hook Settings → Skill Evaluator: invokes evaluator
- Skill Evaluator → Skill Rules: matches patterns
- Claude Code → Ticket Workflow: runs ticket flow
- Ticket Workflow → MCP Configuration: uses servers
- Ticket Workflow → JIRA / Linear: reads and updates
- GitHub → PR Review Workflow: triggers review
- PR Review Workflow → GitHub: reviews pull request
- GitHub → Scheduled Maintenance: triggers schedules