# geminilight/gen-mentor architecture

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

- Interactive diagram: https://gitdiagram.com/geminilight/gen-mentor
- Repository: https://github.com/geminilight/gen-mentor

## Overview

GenMentor is a browser-based, goal-oriented tutoring system. Learners submit a goal and background, review the refined goal and skill estimates, then receive a learner profile and scheduled path. Opening a session generates its learning material and quiz; learners can ask a grounded tutor, and quiz evidence updates their profile and progress. The README documents the agent capabilities and browser-local archive. Several agent internals and page connections were not sampled, so those links are shown only where documented; unverified implementation wiring is omitted.

Main entry points: [`app/src/features/onboarding/use-onboarding.ts`](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/onboarding/use-onboarding.ts) (Goal onboarding), [`app/src/features/session/session-view.tsx`](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/session/session-view.tsx) (Session workspace), [`app/src/lib/pipeline.ts`](https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/pipeline.ts) (Content pipeline), [`app/src/components/layout/app-shell.tsx`](https://github.com/geminilight/gen-mentor/blob/main/app/src/components/layout/app-shell.tsx) (Application shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning_setup["Goal and setup"]
  node_onboarding["Goal onboarding<br/>[use-onboarding.ts]"]
  node_goal_refiner["Goal refinement<br/>[route.ts]"]
  node_skill_gap["Skill mapping<br/>[route.ts]"]
  node_path_scheduler["Path scheduler<br/>[route.ts]"]
  node_learning_path["Learning path<br/>[session-row.tsx]"]
end

subgraph group_learning_content["Learning sessions"]
  node_session_view["Session workspace<br/>[session-view.tsx]"]
  node_pipeline["Content pipeline<br/>[pipeline.ts]"]
  node_knowledge_explorer["Knowledge explorer<br/>[route.ts]"]
  node_knowledge_drafter["Knowledge drafter<br/>[route.ts]"]
  node_document_integrator["Document integrator<br/>[route.ts]"]
  node_quiz_generator["Quiz generator<br/>[route.ts]"]
  node_session_reader["Session reader<br/>[session-reader.tsx]"]
  node_tutor["AI session tutor<br/>[route.ts]"]
end

subgraph group_learner_adaptation["Progress and adaptation"]
  node_profile_agent["Learner profiler<br/>[route.ts]"]
  node_feedback["Feedback simulator<br/>[route.ts]"]
  node_progress["Progress and review<br/>[progress-view.tsx]"]
  node_archive[("Browser learner archive<br/>[archive.ts]")]
end

subgraph group_runtime_services["AI runtime"]
  node_api_client["Browser API client<br/>[client.ts]"]
  node_llm_runtime["LLM provider runtime<br/>[core.ts]"]
  node_model_settings["Model settings<br/>[model-settings.tsx]"]
end

subgraph group_client_app["Learner interface"]
  node_app_shell["Application shell<br/>[app-shell.tsx]"]
  node_library["Learning library<br/>[library-view.tsx]"]
end

node_learner(("Learner"))
node_provider{{"LLM provider"}}

node_learner -->|"sets goal"| node_onboarding
node_onboarding -->|"requests refinement"| node_goal_refiner
node_onboarding -->|"requests skill analysis"| node_skill_gap
node_onboarding -->|"requests profile"| node_profile_agent
node_onboarding -->|"requests path"| node_path_scheduler
node_path_scheduler -->|"creates sessions"| node_learning_path
node_learner -->|"chooses session"| node_learning_path
node_learning_path -->|"opens session"| node_session_view
node_session_view -->|"runs generation"| node_pipeline
node_pipeline -->|"requests points"| node_knowledge_explorer
node_pipeline -->|"requests drafts"| node_knowledge_drafter
node_pipeline -->|"requests document"| node_document_integrator
node_pipeline -->|"requests quiz"| node_quiz_generator
node_session_view -->|"renders content"| node_session_reader
node_session_reader -->|"asks questions"| node_tutor
node_session_view -->|"stores session state"| node_archive
node_session_view -->|"submits quiz evidence"| node_profile_agent
node_profile_agent -->|"updates learner profile"| node_archive
node_archive -->|"supplies learning history"| node_progress
node_learner -->|"reviews progress"| node_progress
node_learner -->|"requests feedback"| node_feedback
node_app_shell -.->|"presents workflow"| node_onboarding
node_app_shell -.->|"presents path"| node_learning_path
node_app_shell -.->|"presents progress"| node_progress
node_app_shell -.->|"presents library"| node_library
node_onboarding -.->|"sends requests"| node_api_client
node_session_view -.->|"uses API"| node_api_client
node_api_client -.->|"routes API calls"| node_llm_runtime
node_llm_runtime -->|"calls model"| node_provider
node_model_settings -.->|"configures models"| node_api_client
node_learner -->|"sets provider credentials"| node_model_settings

click node_onboarding "https://github.com/geminilight/gen-mentor/blob/main/app/src/features/onboarding/use-onboarding.ts"
click node_goal_refiner "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/refine-goal/route.ts"
click node_skill_gap "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/identify-skill-gap/route.ts"
click node_profile_agent "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/profile/route.ts"
click node_path_scheduler "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/schedule-path/route.ts"
click node_learning_path "https://github.com/geminilight/gen-mentor/blob/main/app/src/features/path/session-row.tsx"
click node_session_view "https://github.com/geminilight/gen-mentor/blob/main/app/src/features/session/session-view.tsx"
click node_pipeline "https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/pipeline.ts"
click node_knowledge_explorer "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/explore-knowledge/route.ts"
click node_knowledge_drafter "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/draft-knowledge/route.ts"
click node_document_integrator "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/integrate-document/route.ts"
click node_quiz_generator "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/generate-quiz/route.ts"
click node_session_reader "https://github.com/geminilight/gen-mentor/blob/main/app/src/features/session/session-reader.tsx"
click node_tutor "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/tutor/route.ts"
click node_feedback "https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/simulate-feedback/route.ts"
click node_progress "https://github.com/geminilight/gen-mentor/blob/main/app/src/features/progress/progress-view.tsx"
click node_archive "https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/store/archive.ts"
click node_api_client "https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/client.ts"
click node_llm_runtime "https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/llm/core.ts"
click node_model_settings "https://github.com/geminilight/gen-mentor/blob/main/app/src/features/settings/model-settings.tsx"
click node_app_shell "https://github.com/geminilight/gen-mentor/blob/main/app/src/components/layout/app-shell.tsx"
click node_library "https://github.com/geminilight/gen-mentor/blob/main/app/src/features/library/library-view.tsx"

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_onboarding,node_goal_refiner,node_skill_gap,node_path_scheduler,node_learning_path toneBlue
class node_session_view,node_pipeline,node_knowledge_explorer,node_knowledge_drafter,node_document_integrator,node_quiz_generator,node_session_reader,node_tutor toneAmber
class node_profile_agent,node_feedback,node_progress,node_archive toneMint
class node_api_client,node_llm_runtime,node_model_settings toneRose
class node_app_shell,node_library,node_learner,node_provider toneIndigo
```

## Components

### Goal and setup

- [Goal onboarding](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/onboarding/use-onboarding.ts): `app/src/features/onboarding/use-onboarding.ts`
- [Goal refinement](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/refine-goal/route.ts): `app/src/app/api/refine-goal/route.ts`
- [Skill mapping](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/identify-skill-gap/route.ts): `app/src/app/api/identify-skill-gap/route.ts`
- [Path scheduler](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/schedule-path/route.ts): `app/src/app/api/schedule-path/route.ts`
- [Learning path](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/path/session-row.tsx): `app/src/features/path/session-row.tsx`

### Learning sessions

- [Session workspace](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/session/session-view.tsx): `app/src/features/session/session-view.tsx`
- [Content pipeline](https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/pipeline.ts): `app/src/lib/pipeline.ts`
- [Knowledge explorer](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/explore-knowledge/route.ts): `app/src/app/api/explore-knowledge/route.ts`
- [Knowledge drafter](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/draft-knowledge/route.ts): `app/src/app/api/draft-knowledge/route.ts`
- [Document integrator](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/integrate-document/route.ts): `app/src/app/api/integrate-document/route.ts`
- [Quiz generator](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/generate-quiz/route.ts): `app/src/app/api/generate-quiz/route.ts`
- [Session reader](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/session/session-reader.tsx): `app/src/features/session/session-reader.tsx`
- [AI session tutor](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/tutor/route.ts): `app/src/app/api/tutor/route.ts`

### Progress and adaptation

- [Learner profiler](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/profile/route.ts): `app/src/app/api/profile/route.ts`
- [Feedback simulator](https://github.com/geminilight/gen-mentor/blob/main/app/src/app/api/simulate-feedback/route.ts): `app/src/app/api/simulate-feedback/route.ts`
- [Progress and review](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/progress/progress-view.tsx): `app/src/features/progress/progress-view.tsx`
- [Browser learner archive](https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/store/archive.ts): `app/src/lib/store/archive.ts`

### AI runtime

- [Browser API client](https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/client.ts): `app/src/lib/client.ts`
- [LLM provider runtime](https://github.com/geminilight/gen-mentor/blob/main/app/src/lib/llm/core.ts): `app/src/lib/llm/core.ts`
- [Model settings](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/settings/model-settings.tsx): `app/src/features/settings/model-settings.tsx`

### Learner interface

- [Application shell](https://github.com/geminilight/gen-mentor/blob/main/app/src/components/layout/app-shell.tsx): `app/src/components/layout/app-shell.tsx`
- [Learning library](https://github.com/geminilight/gen-mentor/blob/main/app/src/features/library/library-view.tsx): `app/src/features/library/library-view.tsx`

### Other components

- **Learner**
- **LLM provider**

## Connections

- Learner → Goal onboarding: sets goal
- Goal onboarding → Goal refinement: requests refinement
- Goal onboarding → Skill mapping: requests skill analysis
- Goal onboarding → Learner profiler: requests profile
- Goal onboarding → Path scheduler: requests path
- Path scheduler → Learning path: creates sessions
- Learner → Learning path: chooses session
- Learning path → Session workspace: opens session (evidence: `app/src/features/path/session-row.tsx`)
- Session workspace → Content pipeline: runs generation (evidence: `app/src/features/session/session-view.tsx`)
- Content pipeline → Knowledge explorer: requests points
- Content pipeline → Knowledge drafter: requests drafts
- Content pipeline → Document integrator: requests document
- Content pipeline → Quiz generator: requests quiz
- Session workspace → Session reader: renders content (evidence: `app/src/features/session/session-view.tsx`)
- Session reader → AI session tutor: asks questions
- Session workspace → Browser learner archive: stores session state
- Session workspace → Learner profiler: submits quiz evidence
- Learner profiler → Browser learner archive: updates learner profile
- Browser learner archive → Progress and review: supplies learning history
- Learner → Progress and review: reviews progress
- Learner → Feedback simulator: requests feedback
- Application shell → Goal onboarding: presents workflow
- Application shell → Learning path: presents path
- Application shell → Progress and review: presents progress
- Application shell → Learning library: presents library
- Goal onboarding → Browser API client: sends requests
- Session workspace → Browser API client: uses API
- Browser API client → LLM provider runtime: routes API calls
- LLM provider runtime → LLM provider: calls model
- Model settings → Browser API client: configures models
- Learner → Model settings: sets provider credentials
