# jdubois/dr-jskill architecture

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

- Interactive diagram: https://gitdiagram.com/jdubois/dr-jskill
- Repository: https://github.com/jdubois/dr-jskill

## Overview

Dr JSkill combines an agent skill for guiding Spring Boot development with Node-based project generators. The principal generator workflow accepts project options, resolves a Spring Boot version, requests and extracts a starter project, then applies project configuration. README capabilities also include database-backed full-stack projects, frontend choices, Docker/native builds, and production monitoring. Source excerpts establish the generator calls and starter download; other capability branches are documented but not traced through unsampled implementation.

Main entry points: [`scripts/lib/versions.mjs`](https://github.com/jdubois/dr-jskill/blob/main/scripts/lib/versions.mjs) (Starter and setup), [`scripts/create-basic-project.mjs`](https://github.com/jdubois/dr-jskill/blob/main/scripts/create-basic-project.mjs) (Basic generator), [`scripts/create-web-project.mjs`](https://github.com/jdubois/dr-jskill/blob/main/scripts/create-web-project.mjs) (Web generator), [`scripts/create-fullstack-project.mjs`](https://github.com/jdubois/dr-jskill/blob/main/scripts/create-fullstack-project.mjs) (Full-stack generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Generator entrypoints"]
  node_basic["Basic generator"]
  node_web["Web generator"]
  node_fullstack["Full-stack generator"]
  node_latest["Flexible generator"]
end

subgraph group_generation["Project generation"]
  node_generator["Starter and setup<br/>[versions.mjs]"]
end

subgraph group_guidance["Skill and templates"]
  node_skill["Agent instructions<br/>[SKILL.md]"]
  node_assets["Project templates"]
  node_frontend["Frontend options"]
  node_deploy["Docker and native builds"]
  node_versions["Version guidance<br/>[versions.json]"]
end

node_user(("Developer"))
node_spring["Spring Initializr"]
node_project["Generated application"]

node_user -->|"runs"| node_basic
node_user -->|"runs"| node_web
node_user -->|"runs"| node_fullstack
node_user -->|"runs"| node_latest
node_basic -->|"calls"| node_generator
node_web -->|"calls"| node_generator
node_fullstack -->|"calls"| node_generator
node_latest -->|"calls"| node_generator
node_generator -->|"downloads starter"| node_spring
node_generator -->|"extracts and configures"| node_project
node_generator -->|"uses templates"| node_assets
node_user -->|"loads skill"| node_skill
node_skill -->|"guides choices"| node_frontend
node_project -.->|"supports deployment"| node_deploy
node_project -.->|"offers frameworks"| node_frontend
node_generator -.->|"uses version data"| node_versions

click node_basic "https://github.com/jdubois/dr-jskill/blob/main/scripts/create-basic-project.mjs"
click node_web "https://github.com/jdubois/dr-jskill/blob/main/scripts/create-web-project.mjs"
click node_fullstack "https://github.com/jdubois/dr-jskill/blob/main/scripts/create-fullstack-project.mjs"
click node_latest "https://github.com/jdubois/dr-jskill/blob/main/scripts/create-project-latest.mjs"
click node_generator "https://github.com/jdubois/dr-jskill/blob/main/scripts/lib/versions.mjs"
click node_skill "https://github.com/jdubois/dr-jskill/blob/main/SKILL.md"
click node_assets "https://github.com/jdubois/dr-jskill/tree/main/assets"
click node_frontend "https://github.com/jdubois/dr-jskill/tree/main/references"
click node_deploy "https://github.com/jdubois/dr-jskill/tree/main/assets"
click node_versions "https://github.com/jdubois/dr-jskill/blob/main/versions.json"

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_basic,node_web,node_fullstack,node_latest toneBlue
class node_generator toneAmber
class node_skill,node_assets,node_frontend,node_deploy,node_versions toneMint
class node_user,node_spring,node_project toneIndigo
```

## Components

### Generator entrypoints

- [Basic generator](https://github.com/jdubois/dr-jskill/blob/main/scripts/create-basic-project.mjs): `scripts/create-basic-project.mjs`
- [Web generator](https://github.com/jdubois/dr-jskill/blob/main/scripts/create-web-project.mjs): `scripts/create-web-project.mjs`
- [Full-stack generator](https://github.com/jdubois/dr-jskill/blob/main/scripts/create-fullstack-project.mjs): `scripts/create-fullstack-project.mjs`
- [Flexible generator](https://github.com/jdubois/dr-jskill/blob/main/scripts/create-project-latest.mjs): `scripts/create-project-latest.mjs`

### Project generation

- [Starter and setup](https://github.com/jdubois/dr-jskill/blob/main/scripts/lib/versions.mjs): `scripts/lib/versions.mjs`

### Skill and templates

- [Agent instructions](https://github.com/jdubois/dr-jskill/blob/main/SKILL.md): `SKILL.md`
- [Project templates](https://github.com/jdubois/dr-jskill/tree/main/assets): `assets`
- [Frontend options](https://github.com/jdubois/dr-jskill/tree/main/references): `references`
- [Docker and native builds](https://github.com/jdubois/dr-jskill/tree/main/assets): `assets`
- [Version guidance](https://github.com/jdubois/dr-jskill/blob/main/versions.json): `versions.json`

### Other components

- **Developer**
- **Spring Initializr**
- **Generated application**

## Connections

- Developer → Basic generator: runs (evidence: `scripts/create-basic-project.mjs`)
- Developer → Web generator: runs (evidence: `scripts/create-web-project.mjs`)
- Developer → Full-stack generator: runs (evidence: `scripts/create-fullstack-project.mjs`)
- Developer → Flexible generator: runs (evidence: `scripts/create-project-latest.mjs`)
- Basic generator → Starter and setup: calls (evidence: `scripts/create-basic-project.mjs`)
- Web generator → Starter and setup: calls (evidence: `scripts/create-web-project.mjs`)
- Full-stack generator → Starter and setup: calls (evidence: `scripts/create-fullstack-project.mjs`)
- Flexible generator → Starter and setup: calls (evidence: `scripts/create-project-latest.mjs`)
- Starter and setup → Spring Initializr: downloads starter (evidence: `scripts/lib/versions.mjs`)
- Starter and setup → Generated application: extracts and configures (evidence: `scripts/lib/versions.mjs`)
- Starter and setup → Project templates: uses templates (evidence: `scripts/lib/versions.mjs`)
- Developer → Agent instructions: loads skill (evidence: `README.md`)
- Agent instructions → Frontend options: guides choices (evidence: `README.md`)
- Generated application → Docker and native builds: supports deployment (evidence: `README.md`)
- Generated application → Frontend options: offers frameworks (evidence: `README.md`)
- Starter and setup → Version guidance: uses version data (evidence: `README.md`)
