# shinpr/claude-code-workflows architecture

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

- Interactive diagram: https://gitdiagram.com/shinpr/claude-code-workflows
- Repository: https://github.com/shinpr/claude-code-workflows

## Overview

This repository packages Claude Code development workflows as general, frontend, and full-stack plugins. The principal path scopes the requested outcome and exclusions, optionally designs and plans the work, implements tasks with verification and quality checks, then independently reviews the result. README-documented capabilities also include diagnosis, reverse engineering, quality profiles, and frontend/full-stack recipes. The workflow content is represented by exact skill and agent paths from the tree; source excerpts do not show how recipes invoke agents, so those internal dispatch links are omitted.

Main entry points: [`dev-workflows/skills`](https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows/skills) (General workflows), [`skills/recipe-implement/SKILL.md`](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-implement/SKILL.md) (Outcome and scope), [`skills/recipe-build/SKILL.md`](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-build/SKILL.md) (Task delivery cycle), [`dev-workflows-frontend/skills`](https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-frontend/skills) (Frontend workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow recipes"]
  node_general["General workflows"]
  node_frontend["Frontend workflows"]
  node_fullstack["Full-stack workflows"]
  node_diagnose["Problem diagnosis<br/>[SKILL.md]"]
  node_reverse["System reverse engineering<br/>[SKILL.md]"]
  node_quality["Quality profile<br/>[SKILL.md]"]
  node_frontendrecipes["Frontend recipes"]
  node_fullstackrecipes["Full-stack recipes"]
end

subgraph group_stages["Delivery stages"]
  node_scope["Outcome and scope<br/>[SKILL.md]"]
  node_design["Design and review<br/>[SKILL.md]"]
  node_planning["Work planning<br/>[SKILL.md]"]
  node_taskcycle["Task delivery cycle<br/>[SKILL.md]"]
  node_finalreview["Independent review<br/>[SKILL.md]"]
end

subgraph group_agents["Specialist agents"]
  node_agentset["Workflow agents"]
end

subgraph group_guidance["Skills and guidance"]
  node_skillset["Shared development skills"]
end

node_user(("Change requester"))
node_claude(("Claude Code"))

node_user -->|"requests change"| node_claude
node_claude -->|"uses plugin"| node_general
node_claude -->|"uses plugin"| node_frontend
node_claude -->|"uses plugin"| node_fullstack
node_general -->|"scopes work"| node_scope
node_scope -->|"complex work"| node_design
node_design -->|"approves scope"| node_planning
node_scope -->|"direct task path"| node_taskcycle
node_planning -->|"plans tasks"| node_taskcycle
node_taskcycle -->|"implements then reviews"| node_finalreview
node_general -->|"offers diagnosis"| node_diagnose
node_general -->|"documents systems"| node_reverse
node_general -->|"configures quality"| node_quality
node_frontend -->|"provides frontend path"| node_frontendrecipes
node_fullstack -->|"provides full-stack path"| node_fullstackrecipes
node_claude -.->|"uses specialists"| node_agentset
node_claude -.->|"uses guidance"| node_skillset

click node_general "https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows/skills"
click node_frontend "https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-frontend/skills"
click node_fullstack "https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-fullstack/skills"
click node_scope "https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-implement/SKILL.md"
click node_design "https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-design/SKILL.md"
click node_planning "https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-plan/SKILL.md"
click node_taskcycle "https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-build/SKILL.md"
click node_finalreview "https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-review/SKILL.md"
click node_diagnose "https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-diagnose/SKILL.md"
click node_reverse "https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-reverse-engineer/SKILL.md"
click node_quality "https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-quality-profile/SKILL.md"
click node_agentset "https://github.com/shinpr/claude-code-workflows/tree/main/agents"
click node_skillset "https://github.com/shinpr/claude-code-workflows/tree/main/skills"
click node_frontendrecipes "https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-frontend/skills"
click node_fullstackrecipes "https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-fullstack/skills"

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_general,node_frontend,node_fullstack,node_diagnose,node_reverse,node_quality,node_frontendrecipes,node_fullstackrecipes toneBlue
class node_scope,node_design,node_planning,node_taskcycle,node_finalreview toneAmber
class node_agentset,node_user toneMint
class node_skillset toneRose
class node_claude toneIndigo
```

## Components

### Workflow recipes

- [General workflows](https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows/skills): `dev-workflows/skills`
- [Frontend workflows](https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-frontend/skills): `dev-workflows-frontend/skills`
- [Full-stack workflows](https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-fullstack/skills): `dev-workflows-fullstack/skills`
- [Problem diagnosis](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-diagnose/SKILL.md): `skills/recipe-diagnose/SKILL.md`
- [System reverse engineering](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-reverse-engineer/SKILL.md): `skills/recipe-reverse-engineer/SKILL.md`
- [Quality profile](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-quality-profile/SKILL.md): `skills/recipe-quality-profile/SKILL.md`
- [Frontend recipes](https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-frontend/skills): `dev-workflows-frontend/skills`
- [Full-stack recipes](https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-fullstack/skills): `dev-workflows-fullstack/skills`

### Delivery stages

- [Outcome and scope](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-implement/SKILL.md): `skills/recipe-implement/SKILL.md`
- [Design and review](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-design/SKILL.md): `skills/recipe-design/SKILL.md`
- [Work planning](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-plan/SKILL.md): `skills/recipe-plan/SKILL.md`
- [Task delivery cycle](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-build/SKILL.md): `skills/recipe-build/SKILL.md`
- [Independent review](https://github.com/shinpr/claude-code-workflows/blob/main/skills/recipe-review/SKILL.md): `skills/recipe-review/SKILL.md`

### Specialist agents

- [Workflow agents](https://github.com/shinpr/claude-code-workflows/tree/main/agents): `agents`

### Skills and guidance

- [Shared development skills](https://github.com/shinpr/claude-code-workflows/tree/main/skills): `skills`

### Other components

- **Change requester**
- **Claude Code**

## Connections

- Change requester → Claude Code: requests change (evidence: `README.md`)
- Claude Code → General workflows: uses plugin (evidence: `README.md`)
- Claude Code → Frontend workflows: uses plugin (evidence: `README.md`)
- Claude Code → Full-stack workflows: uses plugin (evidence: `README.md`)
- General workflows → Outcome and scope: scopes work (evidence: `README.md`)
- Outcome and scope → Design and review: complex work (evidence: `README.md`)
- Design and review → Work planning: approves scope (evidence: `README.md`)
- Outcome and scope → Task delivery cycle: direct task path (evidence: `README.md`)
- Work planning → Task delivery cycle: plans tasks (evidence: `README.md`)
- Task delivery cycle → Independent review: implements then reviews (evidence: `README.md`)
- General workflows → Problem diagnosis: offers diagnosis (evidence: `README.md`)
- General workflows → System reverse engineering: documents systems (evidence: `README.md`)
- General workflows → Quality profile: configures quality (evidence: `README.md`)
- Frontend workflows → Frontend recipes: provides frontend path (evidence: `README.md`)
- Full-stack workflows → Full-stack recipes: provides full-stack path (evidence: `README.md`)
- Claude Code → Workflow agents: uses specialists
- Claude Code → Shared development skills: uses guidance
