# songalobung/ai-student-tutor-skill architecture

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

- Interactive diagram: https://gitdiagram.com/songalobung/ai-student-tutor-skill
- Repository: https://github.com/songalobung/ai-student-tutor-skill

## Overview

This repository is an instructional framework and deployable knowledge system for LLM-based academic tutors, not a conventional application runtime. A student brings a learning need; the tutor profiles knowledge and confidence, diagnoses gaps, consults prerequisite and curriculum guidance, then supports instruction, practice, and assessment while respecting integrity and safeguarding rules. Major optional branches extend tutoring to subject-specific teaching, exam preparation, academic writing, multilingual support, and stakeholder reporting. Evidence is chiefly product documentation and generated tutor instructions; the graph does not imply software-level orchestration among these knowledge modules.

Main entry points: [`SKILL.md`](https://github.com/songalobung/ai-student-tutor-skill/blob/main/SKILL.md) (Tutor Instructions), [`dist/packs`](https://github.com/songalobung/ai-student-tutor-skill/tree/main/dist/packs) (Knowledge Packs), [`curricula`](https://github.com/songalobung/ai-student-tutor-skill/tree/main/curricula) (Curriculum Guides), [`subjects`](https://github.com/songalobung/ai-student-tutor-skill/tree/main/subjects) (Subject Engines)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tutoring["Tutor Foundations"]
  node_tutor["Tutor Instructions<br/>[SKILL.md]"]
  node_protocol["Teaching Protocol"]
  node_integrity["Academic Integrity"]
  node_safeguarding["Safeguarding<br/>[safeguarding.md]"]
  node_accuracy["Accuracy Standards"]
end

subgraph group_intelligence["Student Intelligence"]
  node_profile["Student State"]
  node_misconceptions["Misconception Profile"]
  node_prerequisites["Prerequisite Graph"]
  node_dashboard["Stakeholder Reports"]
end

subgraph group_learning["Learning Resources"]
  node_curriculum["Curriculum Guides"]
  node_subjects["Subject Engines"]
  node_pedagogy["Learning Methods"]
  node_assessment["Assessment Tools"]
  node_questionlab["Question Laboratory"]
end

subgraph group_extensions["Specialist Extensions"]
  node_exam["Exam Intelligence<br/>[exam-analytics.md]"]
  node_writing["Writing Engine"]
  node_multilingual["Language Support"]
  node_modes["Tutoring Modes"]
end

subgraph group_delivery["Tutor Delivery"]
  node_platforms["Platform Packages"]
  node_packs["Knowledge Packs"]
end

node_student(("Student"))

node_student -->|"asks for help"| node_tutor
node_tutor -->|"tracks learning state"| node_profile
node_tutor -->|"traces learning gaps"| node_prerequisites
node_tutor -->|"aligns instruction"| node_curriculum
node_tutor -->|"guides instruction"| node_protocol
node_tutor -->|"enforces boundaries"| node_integrity
node_tutor -->|"follows safety rules"| node_safeguarding
node_tutor -->|"grounds claims"| node_accuracy
node_tutor -->|"triages errors"| node_misconceptions
node_tutor -->|"adapts teaching"| node_subjects
node_tutor -->|"uses learning methods"| node_pedagogy
node_tutor -->|"supports assessment"| node_assessment
node_tutor -->|"generates questions"| node_questionlab
node_tutor -->|"supports exam preparation"| node_exam
node_tutor -->|"supports academic writing"| node_writing
node_tutor -->|"scaffolds language"| node_multilingual
node_tutor -->|"offers tutoring modes"| node_modes
node_tutor -->|"provides reporting"| node_dashboard
node_platforms -->|"packages tutor instructions"| node_tutor
node_packs -->|"extends subject knowledge"| node_subjects
node_packs -->|"extends curriculum knowledge"| node_curriculum

click node_tutor "https://github.com/songalobung/ai-student-tutor-skill/blob/main/SKILL.md"
click node_protocol "https://github.com/songalobung/ai-student-tutor-skill/blob/main/core/teaching-protocol.md"
click node_integrity "https://github.com/songalobung/ai-student-tutor-skill/blob/main/core/academic-integrity.md"
click node_safeguarding "https://github.com/songalobung/ai-student-tutor-skill/blob/main/core/safeguarding.md"
click node_accuracy "https://github.com/songalobung/ai-student-tutor-skill/blob/main/core/accuracy-standards.md"
click node_profile "https://github.com/songalobung/ai-student-tutor-skill/blob/main/intelligence/student-state-model.md"
click node_misconceptions "https://github.com/songalobung/ai-student-tutor-skill/blob/main/intelligence/misconception-profiling.md"
click node_prerequisites "https://github.com/songalobung/ai-student-tutor-skill/blob/main/prerequisites/dependency-graph.md"
click node_dashboard "https://github.com/songalobung/ai-student-tutor-skill/blob/main/dashboards/stakeholder-reporting.md"
click node_curriculum "https://github.com/songalobung/ai-student-tutor-skill/tree/main/curricula"
click node_subjects "https://github.com/songalobung/ai-student-tutor-skill/tree/main/subjects"
click node_pedagogy "https://github.com/songalobung/ai-student-tutor-skill/tree/main/pedagogy"
click node_assessment "https://github.com/songalobung/ai-student-tutor-skill/tree/main/assessments"
click node_questionlab "https://github.com/songalobung/ai-student-tutor-skill/blob/main/question-laboratory/generator-engine.md"
click node_exam "https://github.com/songalobung/ai-student-tutor-skill/blob/main/examination-intelligence/exam-analytics.md"
click node_writing "https://github.com/songalobung/ai-student-tutor-skill/blob/main/writing-engine/academic-writing.md"
click node_multilingual "https://github.com/songalobung/ai-student-tutor-skill/blob/main/multilingual/language-support.md"
click node_modes "https://github.com/songalobung/ai-student-tutor-skill/tree/main/modes"
click node_platforms "https://github.com/songalobung/ai-student-tutor-skill/tree/main/dist/platforms"
click node_packs "https://github.com/songalobung/ai-student-tutor-skill/tree/main/dist/packs"

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_tutor,node_protocol,node_integrity,node_safeguarding,node_accuracy toneBlue
class node_profile,node_misconceptions,node_prerequisites,node_dashboard toneAmber
class node_curriculum,node_subjects,node_pedagogy,node_assessment,node_questionlab toneMint
class node_exam,node_writing,node_multilingual,node_modes toneRose
class node_platforms,node_packs,node_student toneIndigo
```

## Components

### Tutor Foundations

- [Tutor Instructions](https://github.com/songalobung/ai-student-tutor-skill/blob/main/SKILL.md): `SKILL.md`
- [Teaching Protocol](https://github.com/songalobung/ai-student-tutor-skill/blob/main/core/teaching-protocol.md): `core/teaching-protocol.md`
- [Academic Integrity](https://github.com/songalobung/ai-student-tutor-skill/blob/main/core/academic-integrity.md): `core/academic-integrity.md`
- [Safeguarding](https://github.com/songalobung/ai-student-tutor-skill/blob/main/core/safeguarding.md): `core/safeguarding.md`
- [Accuracy Standards](https://github.com/songalobung/ai-student-tutor-skill/blob/main/core/accuracy-standards.md): `core/accuracy-standards.md`

### Student Intelligence

- [Student State](https://github.com/songalobung/ai-student-tutor-skill/blob/main/intelligence/student-state-model.md): `intelligence/student-state-model.md`
- [Misconception Profile](https://github.com/songalobung/ai-student-tutor-skill/blob/main/intelligence/misconception-profiling.md): `intelligence/misconception-profiling.md`
- [Prerequisite Graph](https://github.com/songalobung/ai-student-tutor-skill/blob/main/prerequisites/dependency-graph.md): `prerequisites/dependency-graph.md`
- [Stakeholder Reports](https://github.com/songalobung/ai-student-tutor-skill/blob/main/dashboards/stakeholder-reporting.md): `dashboards/stakeholder-reporting.md`

### Learning Resources

- [Curriculum Guides](https://github.com/songalobung/ai-student-tutor-skill/tree/main/curricula): `curricula`
- [Subject Engines](https://github.com/songalobung/ai-student-tutor-skill/tree/main/subjects): `subjects`
- [Learning Methods](https://github.com/songalobung/ai-student-tutor-skill/tree/main/pedagogy): `pedagogy`
- [Assessment Tools](https://github.com/songalobung/ai-student-tutor-skill/tree/main/assessments): `assessments`
- [Question Laboratory](https://github.com/songalobung/ai-student-tutor-skill/blob/main/question-laboratory/generator-engine.md): `question-laboratory/generator-engine.md`

### Specialist Extensions

- [Exam Intelligence](https://github.com/songalobung/ai-student-tutor-skill/blob/main/examination-intelligence/exam-analytics.md): `examination-intelligence/exam-analytics.md`
- [Writing Engine](https://github.com/songalobung/ai-student-tutor-skill/blob/main/writing-engine/academic-writing.md): `writing-engine/academic-writing.md`
- [Language Support](https://github.com/songalobung/ai-student-tutor-skill/blob/main/multilingual/language-support.md): `multilingual/language-support.md`
- [Tutoring Modes](https://github.com/songalobung/ai-student-tutor-skill/tree/main/modes): `modes`

### Tutor Delivery

- [Platform Packages](https://github.com/songalobung/ai-student-tutor-skill/tree/main/dist/platforms): `dist/platforms`
- [Knowledge Packs](https://github.com/songalobung/ai-student-tutor-skill/tree/main/dist/packs): `dist/packs`

### Other components

- **Student**

## Connections

- Student → Tutor Instructions: asks for help (evidence: `README.md`)
- Tutor Instructions → Student State: tracks learning state (evidence: `README.md`)
- Tutor Instructions → Prerequisite Graph: traces learning gaps (evidence: `README.md`)
- Tutor Instructions → Curriculum Guides: aligns instruction (evidence: `README.md`)
- Tutor Instructions → Teaching Protocol: guides instruction (evidence: `README.md`)
- Tutor Instructions → Academic Integrity: enforces boundaries (evidence: `README.md`)
- Tutor Instructions → Safeguarding: follows safety rules
- Tutor Instructions → Accuracy Standards: grounds claims
- Tutor Instructions → Misconception Profile: triages errors
- Tutor Instructions → Subject Engines: adapts teaching (evidence: `README.md`)
- Tutor Instructions → Learning Methods: uses learning methods (evidence: `README.md`)
- Tutor Instructions → Assessment Tools: supports assessment (evidence: `README.md`)
- Tutor Instructions → Question Laboratory: generates questions (evidence: `README.md`)
- Tutor Instructions → Exam Intelligence: supports exam preparation (evidence: `README.md`)
- Tutor Instructions → Writing Engine: supports academic writing (evidence: `README.md`)
- Tutor Instructions → Language Support: scaffolds language (evidence: `README.md`)
- Tutor Instructions → Tutoring Modes: offers tutoring modes (evidence: `README.md`)
- Tutor Instructions → Stakeholder Reports: provides reporting (evidence: `README.md`)
- Platform Packages → Tutor Instructions: packages tutor instructions (evidence: `README.md`)
- Knowledge Packs → Subject Engines: extends subject knowledge (evidence: `README.md`)
- Knowledge Packs → Curriculum Guides: extends curriculum knowledge (evidence: `README.md`)