# rohankgeorge/thinking-tools architecture

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

- Interactive diagram: https://gitdiagram.com/rohankgeorge/thinking-tools
- Repository: https://github.com/rohankgeorge/thinking-tools

## Overview

thinking-tools is a Claude Code marketplace carrying the Brainstorming plugin: a Socratic dialogue skill and a schema-driven decision-document skill. The main workflow clarifies a problem into a plan, or routes decision-dense work to an offline HTML instrument; respondents can return their answers to the conversation. The README documents profile bootstrap and lookup. The validator excerpt confirms schema loading, validation, and renderer-based output; other skill internals are represented only where documented.

Main entry points: [`plugins/brainstorming/skills/brainstorming/SKILL.md`](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/brainstorming/SKILL.md) (Brainstorming skill), [`plugins/brainstorming/skills/decision-instrument/SKILL.md`](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/SKILL.md) (Instrument builder), [`plugins/brainstorming/skills/decision-instrument/scripts/validate.mjs`](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/scripts/validate.mjs) (Schema gate and builder), [`plugins/brainstorming/skills/decision-instrument/assets/instrument-renderer.html`](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/assets/instrument-renderer.html) (HTML renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dialogue["Dialogue planning"]
  node_brainstorm["Brainstorming skill<br/>[SKILL.md]"]
  node_plan["Actionable plan"]
end

subgraph group_instrument["Decision instruments"]
  node_instrument_skill["Instrument builder<br/>[SKILL.md]"]
  node_schema["Instrument schema"]
  node_validator["Schema gate and builder<br/>[validate.mjs]"]
  node_renderer["HTML renderer"]
  node_html["Offline instrument"]
end

subgraph group_profile["Personal profile"]
  node_profile_template["Profile template"]
  node_profile_store[("Local profile")]
end

node_person(("User"))
node_respondent(("Instrument reader"))

node_person -->|"describes problem"| node_brainstorm
node_brainstorm -->|"produces plan"| node_plan
node_brainstorm -->|"routes decision task"| node_instrument_skill
node_person -->|"requests instrument"| node_instrument_skill
node_instrument_skill -->|"authors schema"| node_schema
node_instrument_skill -->|"runs build gate"| node_validator
node_schema -->|"loads schema"| node_validator
node_validator -->|"reads template"| node_renderer
node_validator -->|"writes instrument"| node_html
node_respondent -->|"opens and answers"| node_html
node_respondent -->|"pastes answers"| node_brainstorm
node_brainstorm -.->|"uses template"| node_profile_template
node_brainstorm -.->|"looks up or writes"| node_profile_store

click node_brainstorm "https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/brainstorming/SKILL.md"
click node_instrument_skill "https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/SKILL.md"
click node_validator "https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/scripts/validate.mjs"
click node_renderer "https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/assets/instrument-renderer.html"
click node_profile_template "https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/brainstorming/references/profile-template.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_brainstorm,node_plan,node_person toneBlue
class node_instrument_skill,node_schema,node_validator,node_renderer,node_html toneAmber
class node_profile_template,node_profile_store toneMint
class node_respondent toneIndigo
```

## Components

### Dialogue planning

- [Brainstorming skill](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/brainstorming/SKILL.md): `plugins/brainstorming/skills/brainstorming/SKILL.md`
- **Actionable plan**

### Decision instruments

- [Instrument builder](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/SKILL.md): `plugins/brainstorming/skills/decision-instrument/SKILL.md`
- **Instrument schema**
- [Schema gate and builder](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/scripts/validate.mjs): `plugins/brainstorming/skills/decision-instrument/scripts/validate.mjs`
- [HTML renderer](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/decision-instrument/assets/instrument-renderer.html): `plugins/brainstorming/skills/decision-instrument/assets/instrument-renderer.html`
- **Offline instrument**

### Personal profile

- [Profile template](https://github.com/rohankgeorge/thinking-tools/blob/master/plugins/brainstorming/skills/brainstorming/references/profile-template.md): `plugins/brainstorming/skills/brainstorming/references/profile-template.md`
- **Local profile**

### Other components

- **User**
- **Instrument reader**

## Connections

- User → Brainstorming skill: describes problem
- Brainstorming skill → Actionable plan: produces plan
- Brainstorming skill → Instrument builder: routes decision task
- User → Instrument builder: requests instrument
- Instrument builder → Instrument schema: authors schema
- Instrument builder → Schema gate and builder: runs build gate
- Instrument schema → Schema gate and builder: loads schema
- Schema gate and builder → HTML renderer: reads template
- Schema gate and builder → Offline instrument: writes instrument
- Instrument reader → Offline instrument: opens and answers
- Instrument reader → Brainstorming skill: pastes answers
- Brainstorming skill → Profile template: uses template
- Brainstorming skill → Local profile: looks up or writes