How richology/youth-ai-growth-graph works
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: competencies.json Competencies · renderer.ts 3D renderer · graph-app.ts Graph interaction · types.ts Graph types
Components 26
Open framework
- Growth model
framework - Graph specification
specification
Competency graph
- Four domains
data/domains.json - Competencies
data/competencies.json - Graph relationships
data/dependencies.json - Learning paths
data/learning-paths.json - Framework alignments
data/competency-alignments.json - Life-account links
data/life-account-links.json - Evidence guidance
data/competency-guidance.json - Data schemas
schema - Data validator
tools/validator/validate.py - Guidance builder
tools/build_competency_guidance.py - Web graph builder
tools/build_web_graph.py
Practice methods
- Growth cycle
README.md - Teaching methods
methodology - Practice examples
examples
Graph website
- Browser graph data
site/public/data/graph.json - Graph interaction
site/src/scripts/graph-app.ts - 3D renderer
site/src/lib/renderer.ts - Canvas fallback
site/src/lib/canvas-fallback.ts - Star layout
site/src/lib/star-layout.ts - Terrain layout
site/src/lib/landscape.ts - Graph types
site/src/lib/types.ts
Other components
- Youth learner
- Educator
- Graph visitor
Connections 27
- Youth learner → Growth cycle: takes part
README.md - Educator → Teaching methods: uses methods
README.md - Growth cycle → Competencies: grounds evidence
README.md - Growth model → Four domains: frames growth
README.md - Graph specification → Competencies: defines nodes
README.md - Graph specification → Graph relationships: defines relations
README.md - Four domains → Competencies: organizes
README.md - Competencies → Graph relationships: connected by
README.md - Competencies → Learning paths: supports paths
README.md - Competencies → Framework alignments: mapped to
README.md - Competencies → Life-account links: linked to
README.md - Competencies → Evidence guidance: informs guidance
- Data schemas → Competencies: validates shape
README.md - Teaching methods → Practice examples: illustrated by
README.md - Data validator → Competencies: checks data
tools/validator/validate.py - Guidance builder → Evidence guidance: builds
tools/build_competency_guidance.py - Web graph builder → Browser graph data: writes graph
tools/build_web_graph.py - Competencies → Web graph builder: derives from
README.md - Browser graph data → Graph interaction: loads
- Graph visitor → Graph interaction: explores graph
README.md - Graph interaction → 3D renderer: uses
site/src/scripts/graph-app.ts - Graph interaction → Canvas fallback: uses fallback
site/src/scripts/graph-app.ts - 3D renderer → Star layout: computes positions
site/src/lib/renderer.ts - 3D renderer → Terrain layout: builds terrain
site/src/lib/renderer.ts - 3D renderer → Graph types: uses types
site/src/lib/renderer.ts - Star layout → Graph types: uses types
site/src/lib/star-layout.ts - Canvas fallback → Graph types: uses types
site/src/lib/canvas-fallback.ts