# devcxl/mattpocock-skills-zh architecture

> Architecture diagram of the GitHub repository devcxl/mattpocock-skills-zh, 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/devcxl/mattpocock-skills-zh
- Repository: https://github.com/devcxl/mattpocock-skills-zh
- Video tour (about a minute): https://gitdiagram.com/devcxl/mattpocock-skills-zh/video

## Overview

This repository is a collection of composable AI-agent skills for software engineering and general productivity, rather than a conventional runtime application. The principal workflow is user/agent invocation, with skills helping clarify work, plan it, implement it, and review or debug the result. README-described orchestration links are shown where explicit; other skills are independent capabilities, not an assumed pipeline. The sampled source is mostly repository tooling, so skill behavior and integrations rely primarily on the README and exact skill paths in the tree.

Main entry points: [`skills/engineering/implement/SKILL.md`](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/implement/SKILL.md) (Implement), [`skills/engineering/grill-with-docs/SKILL.md`](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/grill-with-docs/SKILL.md) (Grill with docs), [`skills/engineering/ask-matt/SKILL.md`](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/ask-matt/SKILL.md) (Ask Matt), [`skills/engineering/to-spec/SKILL.md`](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/to-spec/SKILL.md) (To spec)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engineering["Engineering workflow"]
  node_ask_matt["Ask Matt<br/>[SKILL.md]"]
  node_grill_docs["Grill with docs<br/>[SKILL.md]"]
  node_to_spec["To spec<br/>[SKILL.md]"]
  node_to_tickets["To tickets<br/>[SKILL.md]"]
  node_wayfinder["Wayfinder<br/>[SKILL.md]"]
  node_implement["Implement<br/>[SKILL.md]"]
  node_triage["Triage<br/>[SKILL.md]"]
end

subgraph group_engineering_practice["Engineering practice"]
  node_tdd["TDD<br/>[SKILL.md]"]
  node_code_review["Code review<br/>[SKILL.md]"]
  node_debugging["Diagnose bugs<br/>[SKILL.md]"]
  node_research["Research<br/>[SKILL.md]"]
  node_domain_modeling["Domain modeling<br/>[SKILL.md]"]
  node_architecture["Architecture improvement<br/>[SKILL.md]"]
  node_prototype["Prototype<br/>[SKILL.md]"]
end

subgraph group_productivity["Productivity"]
  node_grill_me["Grill me<br/>[SKILL.md]"]
  node_handoff["Handoff<br/>[SKILL.md]"]
  node_teach["Teach<br/>[SKILL.md]"]
  node_wait_what["Wait, what?<br/>[SKILL.md]"]
  node_questionnaire["Questionnaire<br/>[SKILL.md]"]
end

subgraph group_configuration["Project setup"]
  node_setup["Setup skills<br/>[SKILL.md]"]
end

node_user(("User"))
node_agent(("AI agent"))
node_issue_tracker[("Issue tracker")]

node_user -->|"invokes"| node_ask_matt
node_user -->|"invokes"| node_grill_docs
node_user -->|"invokes"| node_to_spec
node_user -->|"invokes"| node_to_tickets
node_user -->|"invokes"| node_wayfinder
node_user -->|"invokes"| node_implement
node_user -->|"invokes"| node_triage
node_user -->|"invokes"| node_setup
node_agent -->|"invokes"| node_tdd
node_agent -->|"invokes"| node_code_review
node_agent -->|"invokes"| node_debugging
node_agent -->|"invokes"| node_research
node_agent -->|"invokes"| node_domain_modeling
node_agent -->|"invokes"| node_prototype
node_agent -->|"invokes"| node_architecture
node_ask_matt -->|"routes to"| node_grill_docs
node_implement -->|"drives"| node_tdd
node_implement -->|"finishes with"| node_code_review
node_grill_docs -->|"builds on"| node_domain_modeling
node_to_spec -->|"publishes spec"| node_issue_tracker
node_triage -->|"updates issues"| node_issue_tracker
node_wayfinder -->|"maps work"| node_issue_tracker
node_user -->|"invokes"| node_grill_me
node_user -->|"invokes"| node_handoff
node_user -->|"invokes"| node_teach
node_user -->|"invokes"| node_wait_what
node_user -->|"invokes"| node_questionnaire

click node_ask_matt "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/ask-matt/SKILL.md"
click node_grill_docs "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/grill-with-docs/SKILL.md"
click node_to_spec "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/to-spec/SKILL.md"
click node_to_tickets "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/to-tickets/SKILL.md"
click node_wayfinder "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/wayfinder/SKILL.md"
click node_implement "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/implement/SKILL.md"
click node_triage "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/triage/SKILL.md"
click node_setup "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md"
click node_tdd "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/tdd/SKILL.md"
click node_code_review "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/code-review/SKILL.md"
click node_debugging "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/diagnosing-bugs/SKILL.md"
click node_research "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/research/SKILL.md"
click node_domain_modeling "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/domain-modeling/SKILL.md"
click node_architecture "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md"
click node_prototype "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/prototype/SKILL.md"
click node_grill_me "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/grill-me/SKILL.md"
click node_handoff "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/handoff/SKILL.md"
click node_teach "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/teach/SKILL.md"
click node_wait_what "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/wait-what/SKILL.md"
click node_questionnaire "https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/to-questionnaire/SKILL.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_ask_matt,node_grill_docs,node_to_spec,node_to_tickets,node_wayfinder,node_implement,node_triage,node_user toneBlue
class node_tdd,node_code_review,node_debugging,node_research,node_domain_modeling,node_architecture,node_prototype,node_issue_tracker toneAmber
class node_grill_me,node_handoff,node_teach,node_wait_what,node_questionnaire toneMint
class node_setup toneRose
class node_agent toneIndigo
```

## Components

### Engineering workflow

- [Ask Matt](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/ask-matt/SKILL.md): `skills/engineering/ask-matt/SKILL.md`
- [Grill with docs](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/grill-with-docs/SKILL.md): `skills/engineering/grill-with-docs/SKILL.md`
- [To spec](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/to-spec/SKILL.md): `skills/engineering/to-spec/SKILL.md`
- [To tickets](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/to-tickets/SKILL.md): `skills/engineering/to-tickets/SKILL.md`
- [Wayfinder](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/wayfinder/SKILL.md): `skills/engineering/wayfinder/SKILL.md`
- [Implement](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/implement/SKILL.md): `skills/engineering/implement/SKILL.md`
- [Triage](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/triage/SKILL.md): `skills/engineering/triage/SKILL.md`

### Engineering practice

- [TDD](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/tdd/SKILL.md): `skills/engineering/tdd/SKILL.md`
- [Code review](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/code-review/SKILL.md): `skills/engineering/code-review/SKILL.md`
- [Diagnose bugs](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/diagnosing-bugs/SKILL.md): `skills/engineering/diagnosing-bugs/SKILL.md`
- [Research](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/research/SKILL.md): `skills/engineering/research/SKILL.md`
- [Domain modeling](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/domain-modeling/SKILL.md): `skills/engineering/domain-modeling/SKILL.md`
- [Architecture improvement](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md): `skills/engineering/improve-codebase-architecture/SKILL.md`
- [Prototype](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/prototype/SKILL.md): `skills/engineering/prototype/SKILL.md`

### Productivity

- [Grill me](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/grill-me/SKILL.md): `skills/productivity/grill-me/SKILL.md`
- [Handoff](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/handoff/SKILL.md): `skills/productivity/handoff/SKILL.md`
- [Teach](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/teach/SKILL.md): `skills/productivity/teach/SKILL.md`
- [Wait, what?](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/wait-what/SKILL.md): `skills/productivity/wait-what/SKILL.md`
- [Questionnaire](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/productivity/to-questionnaire/SKILL.md): `skills/productivity/to-questionnaire/SKILL.md`

### Project setup

- [Setup skills](https://github.com/devcxl/mattpocock-skills-zh/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md): `skills/engineering/setup-matt-pocock-skills/SKILL.md`

### Other components

- **User**
- **AI agent**
- **Issue tracker**

## Connections

- User → Ask Matt: invokes
- User → Grill with docs: invokes
- User → To spec: invokes
- User → To tickets: invokes
- User → Wayfinder: invokes
- User → Implement: invokes
- User → Triage: invokes
- User → Setup skills: invokes
- AI agent → TDD: invokes
- AI agent → Code review: invokes
- AI agent → Diagnose bugs: invokes
- AI agent → Research: invokes
- AI agent → Domain modeling: invokes
- AI agent → Prototype: invokes
- AI agent → Architecture improvement: invokes
- Ask Matt → Grill with docs: routes to
- Implement → TDD: drives
- Implement → Code review: finishes with
- Grill with docs → Domain modeling: builds on
- To spec → Issue tracker: publishes spec
- Triage → Issue tracker: updates issues
- Wayfinder → Issue tracker: maps work
- User → Grill me: invokes
- User → Handoff: invokes
- User → Teach: invokes
- User → Wait, what?: invokes
- User → Questionnaire: invokes