# ismi9/learn architecture

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

- Interactive diagram: https://gitdiagram.com/ismi9/learn
- Repository: https://github.com/ismi9/learn

## Overview

This repository is a pi configuration for AI-assisted learning, not a standalone application. A learner session is guided by the teaching skill; optional research subagents verify material, while question and quiz extensions gather learner input and feedback. Visualization is another optional branch: maker agents use registered Mermaid or SVG tools to render diagrams, and md-log mirrors session content to a Markdown file. The README documents capability-level links; implementation excerpts show visual-tool registration, rendering and publishing. Other workflow connections are documented rather than verified in source excerpts.

Main entry points: [`extensions/visual-tools/tools/mermaid_tools.ts`](https://github.com/ismi9/learn/blob/main/extensions/visual-tools/tools/mermaid_tools.ts) (Mermaid authoring), [`extensions/visual-tools/tools/svg_tools.ts`](https://github.com/ismi9/learn/blob/main/extensions/visual-tools/tools/svg_tools.ts) (SVG authoring), [`extensions/md-log.ts`](https://github.com/ismi9/learn/blob/main/extensions/md-log.ts) (Markdown session log), [`extensions/visual-tools/index.ts`](https://github.com/ismi9/learn/blob/main/extensions/visual-tools/index.ts) (Tool registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning workflow"]
  node_teach["Teaching process<br/>[SKILL.md]"]
  node_visualize["Visualize skill<br/>[SKILL.md]"]
end

subgraph group_agents["Delegated agents"]
  node_researcher["Researcher<br/>[researcher.md]"]
  node_mermaidmaker["Mermaid maker<br/>[mermaid-maker.md]"]
  node_svgmaker["SVG maker<br/>[svg-maker.md]"]
end

subgraph group_extensions["Session extensions"]
  node_questions["Ask user"]
  node_quiz["Graded quiz<br/>[quiz.ts]"]
  node_mdlog["Markdown session log<br/>[md-log.ts]"]
end

subgraph group_visualization["Visualization tools"]
  node_visualreg["Tool registration<br/>[index.ts]"]
  node_mermaid["Mermaid authoring<br/>[mermaid_tools.ts]"]
  node_svg["SVG authoring<br/>[svg_tools.ts]"]
  node_common["Visual helpers<br/>[_common.ts]"]
end

node_learner(("Learner"))
node_pi["pi session"]
node_subagents["Subagent runtime"]
node_renderer["Render binaries"]
node_vizfiles[("Published diagrams")]
node_markdown[("Markdown note")]

node_learner -->|"uses"| node_pi
node_pi -->|"guides session"| node_teach
node_teach -.->|"delegates research"| node_researcher
node_pi -->|"asks questions"| node_questions
node_pi -->|"runs quizzes"| node_quiz
node_pi -->|"logs session"| node_mdlog
node_pi -->|"adds diagrams"| node_visualize
node_visualize -.->|"delegates Mermaid"| node_mermaidmaker
node_visualize -.->|"delegates SVG"| node_svgmaker
node_mermaidmaker -->|"runs in"| node_subagents
node_svgmaker -->|"runs in"| node_subagents
node_visualreg -->|"registers tools"| node_subagents
node_visualreg -->|"registers tools"| node_mermaid
node_visualreg -->|"registers tools"| node_svg
node_mermaidmaker -->|"uses tools"| node_mermaid
node_svgmaker -->|"uses tools"| node_svg
node_mermaid -->|"uses helpers"| node_common
node_svg -->|"uses helpers"| node_common
node_mermaid -->|"renders via CLI"| node_renderer
node_svg -->|"renders via binaries"| node_renderer
node_mermaid -->|"publishes PNG"| node_vizfiles
node_svg -->|"publishes PNG"| node_vizfiles
node_mdlog -->|"appends session"| node_markdown
node_questions -.->|"logs answers"| node_mdlog
node_quiz -.->|"logs results"| node_mdlog

click node_teach "https://github.com/ismi9/learn/blob/main/skills/teach/SKILL.md"
click node_researcher "https://github.com/ismi9/learn/blob/main/agents/researcher.md"
click node_visualize "https://github.com/ismi9/learn/blob/main/skills/visualize/SKILL.md"
click node_mermaidmaker "https://github.com/ismi9/learn/blob/main/agents/mermaid-maker.md"
click node_svgmaker "https://github.com/ismi9/learn/blob/main/agents/svg-maker.md"
click node_questions "https://github.com/ismi9/learn/blob/main/extensions/ask-user-question.ts"
click node_quiz "https://github.com/ismi9/learn/blob/main/extensions/quiz.ts"
click node_mdlog "https://github.com/ismi9/learn/blob/main/extensions/md-log.ts"
click node_visualreg "https://github.com/ismi9/learn/blob/main/extensions/visual-tools/index.ts"
click node_mermaid "https://github.com/ismi9/learn/blob/main/extensions/visual-tools/tools/mermaid_tools.ts"
click node_svg "https://github.com/ismi9/learn/blob/main/extensions/visual-tools/tools/svg_tools.ts"
click node_common "https://github.com/ismi9/learn/blob/main/extensions/visual-tools/tools/_common.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_teach,node_visualize toneBlue
class node_researcher,node_mermaidmaker,node_svgmaker,node_vizfiles,node_markdown toneAmber
class node_questions,node_quiz,node_mdlog toneMint
class node_visualreg,node_mermaid,node_svg,node_common toneRose
class node_learner,node_pi,node_subagents,node_renderer toneIndigo
```

## Components

### Learning workflow

- [Teaching process](https://github.com/ismi9/learn/blob/main/skills/teach/SKILL.md): `skills/teach/SKILL.md`
- [Visualize skill](https://github.com/ismi9/learn/blob/main/skills/visualize/SKILL.md): `skills/visualize/SKILL.md`

### Delegated agents

- [Researcher](https://github.com/ismi9/learn/blob/main/agents/researcher.md): `agents/researcher.md`
- [Mermaid maker](https://github.com/ismi9/learn/blob/main/agents/mermaid-maker.md): `agents/mermaid-maker.md`
- [SVG maker](https://github.com/ismi9/learn/blob/main/agents/svg-maker.md): `agents/svg-maker.md`

### Session extensions

- [Ask user](https://github.com/ismi9/learn/blob/main/extensions/ask-user-question.ts): `extensions/ask-user-question.ts`
- [Graded quiz](https://github.com/ismi9/learn/blob/main/extensions/quiz.ts): `extensions/quiz.ts`
- [Markdown session log](https://github.com/ismi9/learn/blob/main/extensions/md-log.ts): `extensions/md-log.ts`

### Visualization tools

- [Tool registration](https://github.com/ismi9/learn/blob/main/extensions/visual-tools/index.ts): `extensions/visual-tools/index.ts`
- [Mermaid authoring](https://github.com/ismi9/learn/blob/main/extensions/visual-tools/tools/mermaid_tools.ts): `extensions/visual-tools/tools/mermaid_tools.ts`
- [SVG authoring](https://github.com/ismi9/learn/blob/main/extensions/visual-tools/tools/svg_tools.ts): `extensions/visual-tools/tools/svg_tools.ts`
- [Visual helpers](https://github.com/ismi9/learn/blob/main/extensions/visual-tools/tools/_common.ts): `extensions/visual-tools/tools/_common.ts`

### Other components

- **Learner**
- **pi session**
- **Subagent runtime**
- **Render binaries**
- **Published diagrams**
- **Markdown note**

## Connections

- Learner → pi session: uses (evidence: `README.md`)
- pi session → Teaching process: guides session (evidence: `README.md`)
- Teaching process → Researcher: delegates research (evidence: `README.md`)
- pi session → Ask user: asks questions (evidence: `README.md`)
- pi session → Graded quiz: runs quizzes (evidence: `README.md`)
- pi session → Markdown session log: logs session (evidence: `README.md`)
- pi session → Visualize skill: adds diagrams (evidence: `README.md`)
- Visualize skill → Mermaid maker: delegates Mermaid (evidence: `README.md`)
- Visualize skill → SVG maker: delegates SVG (evidence: `README.md`)
- Mermaid maker → Subagent runtime: runs in (evidence: `README.md`)
- SVG maker → Subagent runtime: runs in (evidence: `README.md`)
- Tool registration → Subagent runtime: registers tools (evidence: `extensions/visual-tools/index.ts`)
- Tool registration → Mermaid authoring: registers tools (evidence: `extensions/visual-tools/index.ts`)
- Tool registration → SVG authoring: registers tools (evidence: `extensions/visual-tools/index.ts`)
- Mermaid maker → Mermaid authoring: uses tools (evidence: `extensions/visual-tools/tools/mermaid_tools.ts`)
- SVG maker → SVG authoring: uses tools (evidence: `extensions/visual-tools/tools/svg_tools.ts`)
- Mermaid authoring → Visual helpers: uses helpers (evidence: `extensions/visual-tools/tools/mermaid_tools.ts`)
- SVG authoring → Visual helpers: uses helpers (evidence: `extensions/visual-tools/tools/svg_tools.ts`)
- Mermaid authoring → Render binaries: renders via CLI (evidence: `extensions/visual-tools/tools/mermaid_tools.ts`)
- SVG authoring → Render binaries: renders via binaries (evidence: `extensions/visual-tools/tools/svg_tools.ts`)
- Mermaid authoring → Published diagrams: publishes PNG (evidence: `extensions/visual-tools/tools/mermaid_tools.ts`)
- SVG authoring → Published diagrams: publishes PNG (evidence: `extensions/visual-tools/tools/svg_tools.ts`)
- Markdown session log → Markdown note: appends session (evidence: `extensions/md-log.ts`)
- Ask user → Markdown session log: logs answers (evidence: `extensions/md-log.ts`)
- Graded quiz → Markdown session log: logs results (evidence: `extensions/md-log.ts`)
