# richology/youth-ai-growth-graph architecture

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

- Interactive diagram: https://gitdiagram.com/richology/youth-ai-growth-graph
- Repository: https://github.com/richology/youth-ai-growth-graph

## Overview

Richology is an open youth-AI growth framework, competency graph, and practice methodology, with a website for exploring the graph. Its learning model moves from identifying a real problem through AI collaboration and making work to real-world feedback, iteration, and evidence of growth. The repository pairs human-readable framework and practice materials with structured graph data and schemas; tools derive a browser-facing artifact, which the site presents in star and terrain views. Source excerpts support the website’s rendering dependencies and graph-building step; some links between the broader documented materials are cited to the README rather than sampled implementation.

Main entry points: [`data/competencies.json`](https://github.com/richology/youth-ai-growth-graph/blob/main/data/competencies.json) (Competencies), [`site/src/lib/renderer.ts`](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/renderer.ts) (3D renderer), [`site/src/scripts/graph-app.ts`](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/scripts/graph-app.ts) (Graph interaction), [`site/src/lib/types.ts`](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/types.ts) (Graph types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_framework["Open framework"]
  node_framework_model["Growth model"]
  node_specification["Graph specification"]
end

subgraph group_graphdata["Competency graph"]
  node_domains["Four domains<br/>[domains.json]"]
  node_competencies["Competencies<br/>[competencies.json]"]
  node_relationships["Graph relationships<br/>[dependencies.json]"]
  node_learning_paths["Learning paths"]
  node_alignments["Framework alignments"]
  node_life_links["Life-account links"]
  node_guidance["Evidence guidance"]
  node_schemas["Data schemas"]
  node_validator["Data validator<br/>[validate.py]"]
  node_guidance_builder["Guidance builder"]
  node_web_builder["Web graph builder<br/>[build_web_graph.py]"]
end

subgraph group_practice["Practice methods"]
  node_growth_loop["Growth cycle<br/>[README.md]"]
  node_methodology["Teaching methods"]
  node_examples["Practice examples"]
end

subgraph group_website["Graph website"]
  node_web_graph["Browser graph data<br/>[graph.json]"]
  node_graph_app["Graph interaction<br/>[graph-app.ts]"]
  node_renderer["3D renderer<br/>[renderer.ts]"]
  node_canvas_fallback["Canvas fallback<br/>[canvas-fallback.ts]"]
  node_star_layout["Star layout<br/>[star-layout.ts]"]
  node_landscape["Terrain layout<br/>[landscape.ts]"]
  node_graph_types["Graph types<br/>[types.ts]"]
end

node_learner(("Youth learner"))
node_educator(("Educator"))
node_visitor(("Graph visitor"))

node_learner -->|"takes part"| node_growth_loop
node_educator -->|"uses methods"| node_methodology
node_growth_loop -->|"grounds evidence"| node_competencies
node_framework_model -->|"frames growth"| node_domains
node_specification -->|"defines nodes"| node_competencies
node_specification -->|"defines relations"| node_relationships
node_domains -->|"organizes"| node_competencies
node_competencies -->|"connected by"| node_relationships
node_competencies -->|"supports paths"| node_learning_paths
node_competencies -->|"mapped to"| node_alignments
node_competencies -->|"linked to"| node_life_links
node_competencies -->|"informs guidance"| node_guidance
node_schemas -->|"validates shape"| node_competencies
node_methodology -->|"illustrated by"| node_examples
node_validator -->|"checks data"| node_competencies
node_guidance_builder -->|"builds"| node_guidance
node_web_builder -->|"writes graph"| node_web_graph
node_competencies -->|"derives from"| node_web_builder
node_web_graph -.->|"loads"| node_graph_app
node_visitor -->|"explores graph"| node_graph_app
node_graph_app -->|"uses"| node_renderer
node_graph_app -->|"uses fallback"| node_canvas_fallback
node_renderer -->|"computes positions"| node_star_layout
node_renderer -->|"builds terrain"| node_landscape
node_renderer -->|"uses types"| node_graph_types
node_star_layout -->|"uses types"| node_graph_types
node_canvas_fallback -->|"uses types"| node_graph_types

click node_growth_loop "https://github.com/richology/youth-ai-growth-graph/blob/main/README.md"
click node_framework_model "https://github.com/richology/youth-ai-growth-graph/tree/main/framework"
click node_domains "https://github.com/richology/youth-ai-growth-graph/blob/main/data/domains.json"
click node_competencies "https://github.com/richology/youth-ai-growth-graph/blob/main/data/competencies.json"
click node_relationships "https://github.com/richology/youth-ai-growth-graph/blob/main/data/dependencies.json"
click node_learning_paths "https://github.com/richology/youth-ai-growth-graph/blob/main/data/learning-paths.json"
click node_alignments "https://github.com/richology/youth-ai-growth-graph/blob/main/data/competency-alignments.json"
click node_life_links "https://github.com/richology/youth-ai-growth-graph/blob/main/data/life-account-links.json"
click node_guidance "https://github.com/richology/youth-ai-growth-graph/blob/main/data/competency-guidance.json"
click node_schemas "https://github.com/richology/youth-ai-growth-graph/tree/main/schema"
click node_specification "https://github.com/richology/youth-ai-growth-graph/tree/main/specification"
click node_methodology "https://github.com/richology/youth-ai-growth-graph/tree/main/methodology"
click node_examples "https://github.com/richology/youth-ai-growth-graph/tree/main/examples"
click node_validator "https://github.com/richology/youth-ai-growth-graph/blob/main/tools/validator/validate.py"
click node_guidance_builder "https://github.com/richology/youth-ai-growth-graph/blob/main/tools/build_competency_guidance.py"
click node_web_builder "https://github.com/richology/youth-ai-growth-graph/blob/main/tools/build_web_graph.py"
click node_web_graph "https://github.com/richology/youth-ai-growth-graph/blob/main/site/public/data/graph.json"
click node_graph_app "https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/scripts/graph-app.ts"
click node_renderer "https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/renderer.ts"
click node_canvas_fallback "https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/canvas-fallback.ts"
click node_star_layout "https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/star-layout.ts"
click node_landscape "https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/landscape.ts"
click node_graph_types "https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/types.ts"

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_framework_model,node_specification toneBlue
class node_domains,node_competencies,node_relationships,node_learning_paths,node_alignments,node_life_links,node_guidance,node_schemas,node_validator,node_guidance_builder,node_web_builder toneAmber
class node_growth_loop,node_methodology,node_examples toneMint
class node_web_graph,node_graph_app,node_renderer,node_canvas_fallback,node_star_layout,node_landscape,node_graph_types toneRose
class node_learner,node_educator,node_visitor toneIndigo
```

## Components

### Open framework

- [Growth model](https://github.com/richology/youth-ai-growth-graph/tree/main/framework): `framework`
- [Graph specification](https://github.com/richology/youth-ai-growth-graph/tree/main/specification): `specification`

### Competency graph

- [Four domains](https://github.com/richology/youth-ai-growth-graph/blob/main/data/domains.json): `data/domains.json`
- [Competencies](https://github.com/richology/youth-ai-growth-graph/blob/main/data/competencies.json): `data/competencies.json`
- [Graph relationships](https://github.com/richology/youth-ai-growth-graph/blob/main/data/dependencies.json): `data/dependencies.json`
- [Learning paths](https://github.com/richology/youth-ai-growth-graph/blob/main/data/learning-paths.json): `data/learning-paths.json`
- [Framework alignments](https://github.com/richology/youth-ai-growth-graph/blob/main/data/competency-alignments.json): `data/competency-alignments.json`
- [Life-account links](https://github.com/richology/youth-ai-growth-graph/blob/main/data/life-account-links.json): `data/life-account-links.json`
- [Evidence guidance](https://github.com/richology/youth-ai-growth-graph/blob/main/data/competency-guidance.json): `data/competency-guidance.json`
- [Data schemas](https://github.com/richology/youth-ai-growth-graph/tree/main/schema): `schema`
- [Data validator](https://github.com/richology/youth-ai-growth-graph/blob/main/tools/validator/validate.py): `tools/validator/validate.py`
- [Guidance builder](https://github.com/richology/youth-ai-growth-graph/blob/main/tools/build_competency_guidance.py): `tools/build_competency_guidance.py`
- [Web graph builder](https://github.com/richology/youth-ai-growth-graph/blob/main/tools/build_web_graph.py): `tools/build_web_graph.py`

### Practice methods

- [Growth cycle](https://github.com/richology/youth-ai-growth-graph/blob/main/README.md): `README.md`
- [Teaching methods](https://github.com/richology/youth-ai-growth-graph/tree/main/methodology): `methodology`
- [Practice examples](https://github.com/richology/youth-ai-growth-graph/tree/main/examples): `examples`

### Graph website

- [Browser graph data](https://github.com/richology/youth-ai-growth-graph/blob/main/site/public/data/graph.json): `site/public/data/graph.json`
- [Graph interaction](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/scripts/graph-app.ts): `site/src/scripts/graph-app.ts`
- [3D renderer](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/renderer.ts): `site/src/lib/renderer.ts`
- [Canvas fallback](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/canvas-fallback.ts): `site/src/lib/canvas-fallback.ts`
- [Star layout](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/star-layout.ts): `site/src/lib/star-layout.ts`
- [Terrain layout](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/landscape.ts): `site/src/lib/landscape.ts`
- [Graph types](https://github.com/richology/youth-ai-growth-graph/blob/main/site/src/lib/types.ts): `site/src/lib/types.ts`

### Other components

- **Youth learner**
- **Educator**
- **Graph visitor**

## Connections

- Youth learner → Growth cycle: takes part (evidence: `README.md`)
- Educator → Teaching methods: uses methods (evidence: `README.md`)
- Growth cycle → Competencies: grounds evidence (evidence: `README.md`)
- Growth model → Four domains: frames growth (evidence: `README.md`)
- Graph specification → Competencies: defines nodes (evidence: `README.md`)
- Graph specification → Graph relationships: defines relations (evidence: `README.md`)
- Four domains → Competencies: organizes (evidence: `README.md`)
- Competencies → Graph relationships: connected by (evidence: `README.md`)
- Competencies → Learning paths: supports paths (evidence: `README.md`)
- Competencies → Framework alignments: mapped to (evidence: `README.md`)
- Competencies → Life-account links: linked to (evidence: `README.md`)
- Competencies → Evidence guidance: informs guidance
- Data schemas → Competencies: validates shape (evidence: `README.md`)
- Teaching methods → Practice examples: illustrated by (evidence: `README.md`)
- Data validator → Competencies: checks data (evidence: `tools/validator/validate.py`)
- Guidance builder → Evidence guidance: builds (evidence: `tools/build_competency_guidance.py`)
- Web graph builder → Browser graph data: writes graph (evidence: `tools/build_web_graph.py`)
- Competencies → Web graph builder: derives from (evidence: `README.md`)
- Browser graph data → Graph interaction: loads
- Graph visitor → Graph interaction: explores graph (evidence: `README.md`)
- Graph interaction → 3D renderer: uses (evidence: `site/src/scripts/graph-app.ts`)
- Graph interaction → Canvas fallback: uses fallback (evidence: `site/src/scripts/graph-app.ts`)
- 3D renderer → Star layout: computes positions (evidence: `site/src/lib/renderer.ts`)
- 3D renderer → Terrain layout: builds terrain (evidence: `site/src/lib/renderer.ts`)
- 3D renderer → Graph types: uses types (evidence: `site/src/lib/renderer.ts`)
- Star layout → Graph types: uses types (evidence: `site/src/lib/star-layout.ts`)
- Canvas fallback → Graph types: uses types (evidence: `site/src/lib/canvas-fallback.ts`)
