How ismi9/learn works
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: mermaid_tools.ts Mermaid authoring · svg_tools.ts SVG authoring · md-log.ts Markdown session log · index.ts Tool registration
Components 18
Learning workflow
- Teaching process
skills/teach/SKILL.md - Visualize skill
skills/visualize/SKILL.md
Delegated agents
- Researcher
agents/researcher.md - Mermaid maker
agents/mermaid-maker.md - SVG maker
agents/svg-maker.md
Session extensions
- Ask user
extensions/ask-user-question.ts - Graded quiz
extensions/quiz.ts - Markdown session log
extensions/md-log.ts
Visualization tools
- Tool registration
extensions/visual-tools/index.ts - Mermaid authoring
extensions/visual-tools/tools/mermaid_tools.ts - SVG authoring
extensions/visual-tools/tools/svg_tools.ts - Visual helpers
extensions/visual-tools/tools/_common.ts
Other components
- Learner
- pi session
- Subagent runtime
- Render binaries
- Published diagrams
- Markdown note
Connections 25
- Learner → pi session: uses
README.md - pi session → Teaching process: guides session
README.md - Teaching process → Researcher: delegates research
README.md - pi session → Ask user: asks questions
README.md - pi session → Graded quiz: runs quizzes
README.md - pi session → Markdown session log: logs session
README.md - pi session → Visualize skill: adds diagrams
README.md - Visualize skill → Mermaid maker: delegates Mermaid
README.md - Visualize skill → SVG maker: delegates SVG
README.md - Mermaid maker → Subagent runtime: runs in
README.md - SVG maker → Subagent runtime: runs in
README.md - Tool registration → Subagent runtime: registers tools
extensions/visual-tools/index.ts - Tool registration → Mermaid authoring: registers tools
extensions/visual-tools/index.ts - Tool registration → SVG authoring: registers tools
extensions/visual-tools/index.ts - Mermaid maker → Mermaid authoring: uses tools
extensions/visual-tools/tools/mermaid_tools.ts - SVG maker → SVG authoring: uses tools
extensions/visual-tools/tools/svg_tools.ts - Mermaid authoring → Visual helpers: uses helpers
extensions/visual-tools/tools/mermaid_tools.ts - SVG authoring → Visual helpers: uses helpers
extensions/visual-tools/tools/svg_tools.ts - Mermaid authoring → Render binaries: renders via CLI
extensions/visual-tools/tools/mermaid_tools.ts - SVG authoring → Render binaries: renders via binaries
extensions/visual-tools/tools/svg_tools.ts - Mermaid authoring → Published diagrams: publishes PNG
extensions/visual-tools/tools/mermaid_tools.ts - SVG authoring → Published diagrams: publishes PNG
extensions/visual-tools/tools/svg_tools.ts - Markdown session log → Markdown note: appends session
extensions/md-log.ts - Ask user → Markdown session log: logs answers
extensions/md-log.ts - Graded quiz → Markdown session log: logs results
extensions/md-log.ts