# fzfclee/consulting-skills architecture

> Architecture diagram of the GitHub repository fzfclee/consulting-skills, 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/fzfclee/consulting-skills
- Repository: https://github.com/fzfclee/consulting-skills

## Overview

Consulting Skills is a library of 58 standalone, step-by-step guides for AI agents, not an application with a central runtime orchestrator. A user supplies a business question and context, selects a relevant skill, and the agent follows its inputs, method steps, output template, and quality gate to produce a reviewable decision artifact. The guides cover evidence and problem framing, diagnosis, strategy and customer work, prioritization, measurement, stakeholders, and validation. README documents examples and evaluation results; the sampled source does not show an execution engine, so relationships between individual guides are not inferred.

Main entry points: [`skills`](https://github.com/fzfclee/consulting-skills/tree/main/skills) (Standalone guides), [`catalog.yaml`](https://github.com/fzfclee/consulting-skills/blob/main/catalog.yaml) (Skill catalog), [`skills/evidence-map/SKILL.md`](https://github.com/fzfclee/consulting-skills/blob/main/skills/evidence-map/SKILL.md) (Frame and evidence), [`skills/systems-thinking/SKILL.md`](https://github.com/fzfclee/consulting-skills/blob/main/skills/systems-thinking/SKILL.md) (Reason and diagnose)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Discovery and use"]
  node_catalog["Skill catalog<br/>[catalog.yaml]"]
  node_library["Standalone guides"]
end

subgraph group_methods["Method guides"]
  node_frame["Frame and evidence<br/>[SKILL.md]"]
  node_diagnose["Reason and diagnose<br/>[SKILL.md]"]
  node_strategy["Market and strategy<br/>[SKILL.md]"]
  node_customer["Customer and product<br/>[SKILL.md]"]
  node_prioritize["Prioritize and assess<br/>[SKILL.md]"]
  node_measure["Measure performance<br/>[SKILL.md]"]
  node_stakeholders["Stakeholders and change<br/>[SKILL.md]"]
  node_validate["Plan validation<br/>[SKILL.md]"]
end

subgraph group_examples["Worked examples"]
  node_examples["Worked examples"]
end

subgraph group_quality["Quality evidence"]
  node_evaluation["Evaluation records"]
end

node_user(("User"))
node_artifact["Decision artifact"]

node_user -->|"chooses from"| node_catalog
node_user -->|"provides question"| node_library
node_catalog -->|"lists methods"| node_library
node_library -->|"includes guides"| node_frame
node_library -->|"includes guides"| node_diagnose
node_library -->|"includes guides"| node_strategy
node_library -->|"includes guides"| node_customer
node_library -->|"includes guides"| node_prioritize
node_library -->|"includes guides"| node_measure
node_library -->|"includes guides"| node_stakeholders
node_library -->|"includes guides"| node_validate
node_frame -->|"produces output"| node_artifact
node_diagnose -->|"produces output"| node_artifact
node_strategy -->|"produces output"| node_artifact
node_customer -->|"produces output"| node_artifact
node_prioritize -->|"produces output"| node_artifact
node_measure -->|"produces output"| node_artifact
node_stakeholders -->|"produces output"| node_artifact
node_validate -->|"produces output"| node_artifact
node_examples -->|"illustrates use"| node_user
node_evaluation -->|"reports checks"| node_user

click node_catalog "https://github.com/fzfclee/consulting-skills/blob/main/catalog.yaml"
click node_library "https://github.com/fzfclee/consulting-skills/tree/main/skills"
click node_frame "https://github.com/fzfclee/consulting-skills/blob/main/skills/evidence-map/SKILL.md"
click node_diagnose "https://github.com/fzfclee/consulting-skills/blob/main/skills/systems-thinking/SKILL.md"
click node_strategy "https://github.com/fzfclee/consulting-skills/blob/main/skills/go-to-market-diagnosis/SKILL.md"
click node_customer "https://github.com/fzfclee/consulting-skills/blob/main/skills/jobs-to-be-done/SKILL.md"
click node_prioritize "https://github.com/fzfclee/consulting-skills/blob/main/skills/decision-matrix/SKILL.md"
click node_measure "https://github.com/fzfclee/consulting-skills/blob/main/skills/metrics-tree/SKILL.md"
click node_stakeholders "https://github.com/fzfclee/consulting-skills/blob/main/skills/communications-plan/SKILL.md"
click node_validate "https://github.com/fzfclee/consulting-skills/blob/main/skills/validation-plan/SKILL.md"
click node_examples "https://github.com/fzfclee/consulting-skills/tree/main/examples"
click node_evaluation "https://github.com/fzfclee/consulting-skills/tree/main/evaluations"

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_catalog,node_library,node_user toneBlue
class node_frame,node_diagnose,node_strategy,node_customer,node_prioritize,node_measure,node_stakeholders,node_validate toneAmber
class node_examples toneMint
class node_evaluation toneRose
class node_artifact toneIndigo
```

## Components

### Discovery and use

- [Skill catalog](https://github.com/fzfclee/consulting-skills/blob/main/catalog.yaml): `catalog.yaml`
- [Standalone guides](https://github.com/fzfclee/consulting-skills/tree/main/skills): `skills`

### Method guides

- [Frame and evidence](https://github.com/fzfclee/consulting-skills/blob/main/skills/evidence-map/SKILL.md): `skills/evidence-map/SKILL.md`
- [Reason and diagnose](https://github.com/fzfclee/consulting-skills/blob/main/skills/systems-thinking/SKILL.md): `skills/systems-thinking/SKILL.md`
- [Market and strategy](https://github.com/fzfclee/consulting-skills/blob/main/skills/go-to-market-diagnosis/SKILL.md): `skills/go-to-market-diagnosis/SKILL.md`
- [Customer and product](https://github.com/fzfclee/consulting-skills/blob/main/skills/jobs-to-be-done/SKILL.md): `skills/jobs-to-be-done/SKILL.md`
- [Prioritize and assess](https://github.com/fzfclee/consulting-skills/blob/main/skills/decision-matrix/SKILL.md): `skills/decision-matrix/SKILL.md`
- [Measure performance](https://github.com/fzfclee/consulting-skills/blob/main/skills/metrics-tree/SKILL.md): `skills/metrics-tree/SKILL.md`
- [Stakeholders and change](https://github.com/fzfclee/consulting-skills/blob/main/skills/communications-plan/SKILL.md): `skills/communications-plan/SKILL.md`
- [Plan validation](https://github.com/fzfclee/consulting-skills/blob/main/skills/validation-plan/SKILL.md): `skills/validation-plan/SKILL.md`

### Worked examples

- [Worked examples](https://github.com/fzfclee/consulting-skills/tree/main/examples): `examples`

### Quality evidence

- [Evaluation records](https://github.com/fzfclee/consulting-skills/tree/main/evaluations): `evaluations`

### Other components

- **User**
- **Decision artifact**

## Connections

- User → Skill catalog: chooses from (evidence: `README.md`)
- User → Standalone guides: provides question (evidence: `README.md`)
- Skill catalog → Standalone guides: lists methods (evidence: `README.md`)
- Standalone guides → Frame and evidence: includes guides (evidence: `README.md`)
- Standalone guides → Reason and diagnose: includes guides (evidence: `README.md`)
- Standalone guides → Market and strategy: includes guides (evidence: `README.md`)
- Standalone guides → Customer and product: includes guides (evidence: `README.md`)
- Standalone guides → Prioritize and assess: includes guides (evidence: `README.md`)
- Standalone guides → Measure performance: includes guides (evidence: `README.md`)
- Standalone guides → Stakeholders and change: includes guides (evidence: `README.md`)
- Standalone guides → Plan validation: includes guides (evidence: `README.md`)
- Frame and evidence → Decision artifact: produces output (evidence: `README.md`)
- Reason and diagnose → Decision artifact: produces output (evidence: `README.md`)
- Market and strategy → Decision artifact: produces output (evidence: `README.md`)
- Customer and product → Decision artifact: produces output (evidence: `README.md`)
- Prioritize and assess → Decision artifact: produces output (evidence: `README.md`)
- Measure performance → Decision artifact: produces output (evidence: `README.md`)
- Stakeholders and change → Decision artifact: produces output (evidence: `README.md`)
- Plan validation → Decision artifact: produces output (evidence: `README.md`)
- Worked examples → User: illustrates use (evidence: `README.md`)
- Evaluation records → User: reports checks (evidence: `README.md`)