# pipedrive-oss/mattpocock-skills architecture

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

- Interactive diagram: https://gitdiagram.com/pipedrive-oss/mattpocock-skills
- Repository: https://github.com/pipedrive-oss/mattpocock-skills

## Overview

This repository is a collection of composable agent skills for software engineering and related work. The principal workflow is that an engineer selects a skill, then an agent follows its guidance to clarify intent, plan work, implement with feedback, or improve a codebase. The README documents several links among skills and their outputs; because no source excerpts were provided, the graph shows only those documented relationships, not inferred skill-to-skill calls.

Main entry points: [`skills/engineering/grill-with-docs/SKILL.md`](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/grill-with-docs/SKILL.md) (Grill with docs), [`skills/engineering/triage/SKILL.md`](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/triage/SKILL.md) (Triage issues), [`skills/engineering/setup-matt-pocock-skills/SKILL.md`](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md) (Configure skills), [`skills/productivity/grill-me/SKILL.md`](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/productivity/grill-me/SKILL.md) (Grill me)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_alignment["Alignment & language"]
  node_grill_me["Grill me<br/>[SKILL.md]"]
  node_grill_docs["Grill with docs<br/>[SKILL.md]"]
  node_context["Shared language<br/>[CONTEXT.md]"]
  node_adrs["Decision records"]
end

subgraph group_planning["Planning &amp; triage"]
  node_to_prd["Create PRD<br/>[SKILL.md]"]
  node_triage["Triage issues<br/>[SKILL.md]"]
  node_to_issues["Break into issues<br/>[SKILL.md]"]
end

subgraph group_engineering["Engineering feedback"]
  node_tdd["TDD loop<br/>[SKILL.md]"]
  node_diagnose["Diagnose bugs<br/>[SKILL.md]"]
end

subgraph group_design["Design &amp; architecture"]
  node_architecture["Improve architecture<br/>[SKILL.md]"]
  node_zoom_out["System context<br/>[SKILL.md]"]
  node_prototype["Prototype<br/>[SKILL.md]"]
end

subgraph group_productivity["Productivity &amp; setup"]
  node_setup["Configure skills<br/>[SKILL.md]"]
  node_handoff["Handoff work<br/>[SKILL.md]"]
  node_write_skill["Write a skill<br/>[SKILL.md]"]
  node_writing["Writing skills<br/>[SKILL.md]"]
end

node_engineer(("Engineer"))
node_agent(("Coding agent"))
node_tracker["Issue tracker"]

node_engineer -->|"selects"| node_grill_me
node_engineer -->|"selects"| node_grill_docs
node_engineer -->|"selects"| node_to_prd
node_engineer -->|"selects"| node_triage
node_engineer -->|"selects"| node_setup
node_engineer -->|"selects"| node_tdd
node_engineer -->|"selects"| node_diagnose
node_engineer -->|"selects"| node_architecture
node_engineer -->|"selects"| node_zoom_out
node_engineer -->|"selects"| node_prototype
node_engineer -->|"selects"| node_to_issues
node_engineer -->|"selects"| node_handoff
node_engineer -->|"selects"| node_write_skill
node_engineer -->|"selects"| node_writing
node_grill_me -->|"guides"| node_agent
node_grill_docs -->|"guides"| node_agent
node_grill_docs -->|"updates"| node_context
node_grill_docs -->|"documents decisions"| node_adrs
node_to_prd -->|"guides"| node_agent
node_triage -->|"guides"| node_agent
node_triage -.->|"triages against"| node_tracker
node_setup -->|"guides"| node_agent
node_setup -.->|"configures"| node_tracker
node_tdd -->|"guides"| node_agent
node_diagnose -->|"guides"| node_agent
node_architecture -->|"guides"| node_agent
node_zoom_out -->|"guides"| node_agent
node_prototype -->|"guides"| node_agent
node_to_issues -->|"guides"| node_agent
node_handoff -->|"guides"| node_agent
node_write_skill -->|"guides"| node_agent
node_writing -->|"guides"| node_agent

click node_grill_me "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/productivity/grill-me/SKILL.md"
click node_grill_docs "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/grill-with-docs/SKILL.md"
click node_context "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/CONTEXT.md"
click node_adrs "https://github.com/pipedrive-oss/mattpocock-skills/tree/main/docs/adr"
click node_to_prd "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/to-prd/SKILL.md"
click node_triage "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/triage/SKILL.md"
click node_to_issues "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/to-issues/SKILL.md"
click node_setup "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md"
click node_tdd "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/tdd/SKILL.md"
click node_diagnose "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/diagnose/SKILL.md"
click node_architecture "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md"
click node_zoom_out "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/zoom-out/SKILL.md"
click node_prototype "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/prototype/SKILL.md"
click node_handoff "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/productivity/handoff/SKILL.md"
click node_write_skill "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/productivity/write-a-skill/SKILL.md"
click node_writing "https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/in-progress/writing-shape/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_grill_me,node_grill_docs,node_context,node_adrs toneBlue
class node_to_prd,node_triage,node_to_issues toneAmber
class node_tdd,node_diagnose toneMint
class node_architecture,node_zoom_out,node_prototype toneRose
class node_setup,node_handoff,node_write_skill,node_writing,node_engineer,node_agent,node_tracker toneIndigo
```

## Components

### Alignment & language

- [Grill me](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/productivity/grill-me/SKILL.md): `skills/productivity/grill-me/SKILL.md`
- [Grill with docs](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/grill-with-docs/SKILL.md): `skills/engineering/grill-with-docs/SKILL.md`
- [Shared language](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/CONTEXT.md): `CONTEXT.md`
- [Decision records](https://github.com/pipedrive-oss/mattpocock-skills/tree/main/docs/adr): `docs/adr`

### Planning & triage

- [Create PRD](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/to-prd/SKILL.md): `skills/engineering/to-prd/SKILL.md`
- [Triage issues](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/triage/SKILL.md): `skills/engineering/triage/SKILL.md`
- [Break into issues](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/to-issues/SKILL.md): `skills/engineering/to-issues/SKILL.md`

### Engineering feedback

- [TDD loop](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/tdd/SKILL.md): `skills/engineering/tdd/SKILL.md`
- [Diagnose bugs](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/diagnose/SKILL.md): `skills/engineering/diagnose/SKILL.md`

### Design & architecture

- [Improve architecture](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md): `skills/engineering/improve-codebase-architecture/SKILL.md`
- [System context](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/zoom-out/SKILL.md): `skills/engineering/zoom-out/SKILL.md`
- [Prototype](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/prototype/SKILL.md): `skills/engineering/prototype/SKILL.md`

### Productivity & setup

- [Configure skills](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md): `skills/engineering/setup-matt-pocock-skills/SKILL.md`
- [Handoff work](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/productivity/handoff/SKILL.md): `skills/productivity/handoff/SKILL.md`
- [Write a skill](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/productivity/write-a-skill/SKILL.md): `skills/productivity/write-a-skill/SKILL.md`
- [Writing skills](https://github.com/pipedrive-oss/mattpocock-skills/blob/main/skills/in-progress/writing-shape/SKILL.md): `skills/in-progress/writing-shape/SKILL.md`

### Other components

- **Engineer**
- **Coding agent**
- **Issue tracker**

## Connections

- Engineer → Grill me: selects
- Engineer → Grill with docs: selects
- Engineer → Create PRD: selects
- Engineer → Triage issues: selects
- Engineer → Configure skills: selects
- Engineer → TDD loop: selects
- Engineer → Diagnose bugs: selects
- Engineer → Improve architecture: selects
- Engineer → System context: selects
- Engineer → Prototype: selects
- Engineer → Break into issues: selects
- Engineer → Handoff work: selects
- Engineer → Write a skill: selects
- Engineer → Writing skills: selects
- Grill me → Coding agent: guides
- Grill with docs → Coding agent: guides
- Grill with docs → Shared language: updates
- Grill with docs → Decision records: documents decisions
- Create PRD → Coding agent: guides
- Triage issues → Coding agent: guides
- Triage issues → Issue tracker: triages against
- Configure skills → Coding agent: guides
- Configure skills → Issue tracker: configures
- TDD loop → Coding agent: guides
- Diagnose bugs → Coding agent: guides
- Improve architecture → Coding agent: guides
- System context → Coding agent: guides
- Prototype → Coding agent: guides
- Break into issues → Coding agent: guides
- Handoff work → Coding agent: guides
- Write a skill → Coding agent: guides
- Writing skills → Coding agent: guides