# chagumu01/growth-loop-agent architecture

> Architecture diagram of the GitHub repository chagumu01/growth-loop-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chagumu01/growth-loop-agent
- Repository: https://github.com/chagumu01/growth-loop-agent

## Overview

Growth Loop Agent is a learning assistant that turns learning notes into feedback, quizzes, courses, and follow-up actions. The main path runs from a learner’s note through the agent API to feedback and a quiz; course generation, personal memory, confirmed actions, and optional misconception checks are distinct branches. The README documents those capabilities and the Android and WeChat entry points. Sampled route imports support several API-to-service links; unsampled UI and subsystem internals are represented at their exact tree paths, without assuming their call details.

Main entry points: [`lib/agent/quiz.ts`](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/agent/quiz.ts) (Conversation and quiz), [`app/api/agent/route.ts`](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/agent/route.ts) (Agent API), [`app/api/learning-program/route.ts`](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/learning-program/route.ts) (Course API), [`app/api/memory/route.ts`](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/memory/route.ts) (Memory API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Learner experience"]
  node_workspace["Learning workspace<br/>[workspace.tsx]"]
  node_studio["Course studio"]
  node_memoryui["Memory panel<br/>[memory-panel.tsx]"]
  node_actionsui["Actions panel<br/>[actions-panel.tsx]"]
end

subgraph group_api["API entry points"]
  node_agentapi["Agent API<br/>[route.ts]"]
  node_courseapi["Course API<br/>[route.ts]"]
  node_quizapi["Quiz API<br/>[route.ts]"]
  node_memoryapi["Memory API<br/>[route.ts]"]
  node_toolsapi["Tools API<br/>[route.ts]"]
  node_wechatapi["WeChat API<br/>[route.ts]"]
end

subgraph group_learning["Learning services"]
  node_agent["Conversation and quiz<br/>[quiz.ts]"]
  node_courses["Course generation<br/>[service.ts]"]
  node_skills["Course skill reuse<br/>[service.ts]"]
  node_verification["Misconception checks<br/>[service.ts]"]
end

subgraph group_personal["Personal data"]
  node_memory["Memory service<br/>[service.ts]"]
  node_auth["Account sessions<br/>[auth.ts]"]
  node_database[("SQLite data store<br/>[store.ts]")]
  node_actions["Confirmed operations<br/>[operations.ts]"]
end

subgraph group_integrations["Integrations"]
  node_wechat["WeChat adapter<br/>[adapter.ts]"]
  node_android["Android shell<br/>[MainActivity.java]"]
  node_trace["Request tracing<br/>[trace.ts]"]
end

node_learner(("Learner"))
node_model["LLM provider"]

node_learner -->|"records learning"| node_workspace
node_workspace -.->|"sends notes"| node_agentapi
node_agentapi -->|"handles conversation"| node_agent
node_agentapi -->|"traces requests"| node_trace
node_agent -.->|"requests feedback"| node_model
node_learner -->|"sets learning goals"| node_studio
node_studio -->|"requests courses"| node_courseapi
node_courseapi -->|"routes actions"| node_courses
node_courseapi -->|"traces requests"| node_trace
node_courses -->|"retrieves and records"| node_skills
node_courses -.->|"generates content"| node_model
node_learner -->|"submits understanding"| node_quizapi
node_quizapi -->|"generates and grades"| node_agent
node_agent -->|"adds trap checks"| node_verification
node_learner -->|"reviews records"| node_memoryui
node_memoryui -->|"manages memories"| node_memoryapi
node_memoryapi -->|"serves memory operations"| node_memory
node_memoryapi -->|"authenticates users"| node_auth
node_memory -->|"stores and retrieves"| node_database
node_learner -->|"proposes actions"| node_actionsui
node_actionsui -->|"requests operations"| node_toolsapi
node_toolsapi -->|"proposes and confirms"| node_actions
node_toolsapi -->|"authenticates users"| node_auth
node_actions -->|"reads and writes"| node_database
node_learner -->|"sends learning note"| node_wechatapi
node_wechatapi -->|"handles callback"| node_wechat
node_wechatapi -->|"uses conversation provider"| node_agent
node_android -->|"loads web experience"| node_workspace

click node_workspace "https://github.com/chagumu01/growth-loop-agent/blob/main/app/workspace.tsx"
click node_studio "https://github.com/chagumu01/growth-loop-agent/blob/main/app/learning-studio.tsx"
click node_memoryui "https://github.com/chagumu01/growth-loop-agent/blob/main/app/memory/memory-panel.tsx"
click node_actionsui "https://github.com/chagumu01/growth-loop-agent/blob/main/app/actions/actions-panel.tsx"
click node_agentapi "https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/agent/route.ts"
click node_courseapi "https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/learning-program/route.ts"
click node_quizapi "https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/quiz/route.ts"
click node_memoryapi "https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/memory/route.ts"
click node_toolsapi "https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/tools/route.ts"
click node_wechatapi "https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/wechat/route.ts"
click node_agent "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/agent/quiz.ts"
click node_courses "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/learning-program/service.ts"
click node_skills "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/skill/service.ts"
click node_verification "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/verification/service.ts"
click node_memory "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/memory/service.ts"
click node_auth "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/memory/auth.ts"
click node_database "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/memory/store.ts"
click node_actions "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/tools/operations.ts"
click node_wechat "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/wechat/adapter.ts"
click node_android "https://github.com/chagumu01/growth-loop-agent/blob/main/android/app/src/main/java/com/growthloop/agent/MainActivity.java"
click node_trace "https://github.com/chagumu01/growth-loop-agent/blob/main/lib/observability/trace.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_workspace,node_studio,node_memoryui,node_actionsui toneBlue
class node_agentapi,node_courseapi,node_quizapi,node_memoryapi,node_toolsapi,node_wechatapi toneAmber
class node_agent,node_courses,node_skills,node_verification toneMint
class node_memory,node_auth,node_database,node_actions toneRose
class node_wechat,node_android,node_trace,node_learner,node_model toneIndigo
```

## Components

### Learner experience

- [Learning workspace](https://github.com/chagumu01/growth-loop-agent/blob/main/app/workspace.tsx): `app/workspace.tsx`
- [Course studio](https://github.com/chagumu01/growth-loop-agent/blob/main/app/learning-studio.tsx): `app/learning-studio.tsx`
- [Memory panel](https://github.com/chagumu01/growth-loop-agent/blob/main/app/memory/memory-panel.tsx): `app/memory/memory-panel.tsx`
- [Actions panel](https://github.com/chagumu01/growth-loop-agent/blob/main/app/actions/actions-panel.tsx): `app/actions/actions-panel.tsx`

### API entry points

- [Agent API](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/agent/route.ts): `app/api/agent/route.ts`
- [Course API](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/learning-program/route.ts): `app/api/learning-program/route.ts`
- [Quiz API](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/quiz/route.ts): `app/api/quiz/route.ts`
- [Memory API](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/memory/route.ts): `app/api/memory/route.ts`
- [Tools API](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/tools/route.ts): `app/api/tools/route.ts`
- [WeChat API](https://github.com/chagumu01/growth-loop-agent/blob/main/app/api/wechat/route.ts): `app/api/wechat/route.ts`

### Learning services

- [Conversation and quiz](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/agent/quiz.ts): `lib/agent/quiz.ts`
- [Course generation](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/learning-program/service.ts): `lib/learning-program/service.ts`
- [Course skill reuse](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/skill/service.ts): `lib/skill/service.ts`
- [Misconception checks](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/verification/service.ts): `lib/verification/service.ts`

### Personal data

- [Memory service](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/memory/service.ts): `lib/memory/service.ts`
- [Account sessions](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/memory/auth.ts): `lib/memory/auth.ts`
- [SQLite data store](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/memory/store.ts): `lib/memory/store.ts`
- [Confirmed operations](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/tools/operations.ts): `lib/tools/operations.ts`

### Integrations

- [WeChat adapter](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/wechat/adapter.ts): `lib/wechat/adapter.ts`
- [Android shell](https://github.com/chagumu01/growth-loop-agent/blob/main/android/app/src/main/java/com/growthloop/agent/MainActivity.java): `android/app/src/main/java/com/growthloop/agent/MainActivity.java`
- [Request tracing](https://github.com/chagumu01/growth-loop-agent/blob/main/lib/observability/trace.ts): `lib/observability/trace.ts`

### Other components

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

## Connections

- Learner → Learning workspace: records learning (evidence: `README.md`)
- Learning workspace → Agent API: sends notes
- Agent API → Conversation and quiz: handles conversation (evidence: `app/api/agent/route.ts`)
- Agent API → Request tracing: traces requests (evidence: `app/api/agent/route.ts`)
- Conversation and quiz → LLM provider: requests feedback
- Learner → Course studio: sets learning goals (evidence: `README.md`)
- Course studio → Course API: requests courses (evidence: `README.md`)
- Course API → Course generation: routes actions (evidence: `app/api/learning-program/route.ts`)
- Course API → Request tracing: traces requests (evidence: `app/api/learning-program/route.ts`)
- Course generation → Course skill reuse: retrieves and records (evidence: `lib/learning-program/service.ts`)
- Course generation → LLM provider: generates content
- Learner → Quiz API: submits understanding (evidence: `README.md`)
- Quiz API → Conversation and quiz: generates and grades (evidence: `app/api/quiz/route.ts`)
- Conversation and quiz → Misconception checks: adds trap checks (evidence: `lib/agent/quiz.ts`)
- Learner → Memory panel: reviews records (evidence: `README.md`)
- Memory panel → Memory API: manages memories (evidence: `README.md`)
- Memory API → Memory service: serves memory operations (evidence: `app/api/memory/route.ts`)
- Memory API → Account sessions: authenticates users (evidence: `app/api/memory/route.ts`)
- Memory service → SQLite data store: stores and retrieves (evidence: `lib/memory/service.ts`)
- Learner → Actions panel: proposes actions (evidence: `README.md`)
- Actions panel → Tools API: requests operations (evidence: `README.md`)
- Tools API → Confirmed operations: proposes and confirms (evidence: `app/api/tools/route.ts`)
- Tools API → Account sessions: authenticates users (evidence: `app/api/tools/route.ts`)
- Confirmed operations → SQLite data store: reads and writes (evidence: `lib/tools/operations.ts`)
- Learner → WeChat API: sends learning note (evidence: `README.md`)
- WeChat API → WeChat adapter: handles callback (evidence: `app/api/wechat/route.ts`)
- WeChat API → Conversation and quiz: uses conversation provider (evidence: `app/api/wechat/route.ts`)
- Android shell → Learning workspace: loads web experience (evidence: `README.md`)
