# jushbjj/mr.-ranedeer-ai-tutor architecture

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

- Interactive diagram: https://gitdiagram.com/jushbjj/mr.-ranedeer-ai-tutor
- Repository: https://github.com/jushbjj/mr.-ranedeer-ai-tutor

## Overview

1. This repository is not an application with executable code; it is a prompt-product package for ChatGPT/GPT-4. The “architecture” is primarily a set of text artifacts that define a tutoring persona, its configuration surface, and the instructions users paste into an LLM chat session.

2. The core runtime boundary is external: OpenAI’s ChatGPT interface. The repo does not host a backend, model, or API service. Instead, the main prompt files are consumed manually by the user inside ChatGPT or through a custom GPT link referenced in the README.

3. The central asset is `Mr_Ranedeer.txt`. This is the primary tutor system prompt: it defines the AI tutor’s identity, behavior, lesson structure, command handling, and pedagogy. In architecture terms, this is the “engine” of the product.

4. `GPT_Prompt.txt` appears to be a more generic or alternate prompt entrypoint, likely used to feed the same tutoring behavior into different contexts. It functions as a sibling prompt artifact rather than a separate subsystem.

5. `My_Information.txt` is the user-specific configuration boundary. This is where learner preferences, background, or personalization inputs are stored so the tutor can adapt depth, tone, style, and language. It is effectively the data input layer for the prompt system.

6. `Extensions/Wizard.txt` represents a configuration assistant or prompt extension. Based on the README’s “Wizard” reference, this is the subsystem that helps users choose settings and personalize the tutor before learning begins.

7. The `Guides/` folder is the documentation and onboarding layer. `How to use Mr. Ranedeer.md` explains the usage flow, while `Config Guide.md` documents the configuration schema and available options. These files support the main prompt by defining how users should prepare and interact with it.

8. `Prompt Analysis.md` is likely an internal design note explaining how the prompt behaves or how its structure is intended to work. This is a meta-documentation boundary, useful for understanding prompt composition but not part of the user-facing tutoring flow.

9. The repository’s interaction model is command-driven. The README documents slash commands like `/test`, `/config`, `/plan`, `/start`, `/continue`, and `/language`. These commands are interpreted by the prompt instructions rather than by code, so the control plane is embedded in text and executed by the model’s response logic.

10. Content flow is: user selects or edits configuration, optionally uses the wizard, then pastes the main prompt into ChatGPT, after which the model generates lessons, tests, and plans according to the configured behavior. The learning session is stateful only within the chat context, not in repository code.

11. `.github/` contains issue and pull request templates. These support community feedback and contribution workflows, but they do not affect the tutoring architecture itself.

12. The README also serves as the public product front door. It establishes that the project is discontinued, points users to the main prompt and guides, and documents compatibility expectations such as GPT-4 with Code Interpreter. That makes the repository a distributed prompt system with documentation, not a deployed software stack.

Main entry points: [`README.md`](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/README.md) (README), [`Mr_Ranedeer.txt`](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Mr_Ranedeer.txt) (Mr. Ranedeer), [`GPT_Prompt.txt`](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/GPT_Prompt.txt) (GPT Prompt), [`Extensions/Wizard.txt`](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Extensions/Wizard.txt) (Wizard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_front_door["Front Door"]
  node_readme["README<br/>entry docs<br/>[README.md]"]
end

subgraph group_prompt_core["Prompt Core"]
  node_main_prompt["Mr. Ranedeer<br/>tutor prompt<br/>[Mr_Ranedeer.txt]"]
  node_alt_prompt["GPT Prompt<br/>alternate prompt<br/>[GPT_Prompt.txt]"]
end

subgraph group_personalization["Personalization"]
  node_user_profile["My Information<br/>profile data<br/>[My_Information.txt]"]
  node_wizard["Wizard<br/>config assistant<br/>[Wizard.txt]"]
end

subgraph group_docs_meta["Docs & Meta"]
  node_config_guide["Config Guide<br/>schema guide<br/>[Config Guide.md]"]
  node_usage_guide["How to Use<br/>usage guide"]
  node_prompt_analysis["Prompt Analysis<br/>design notes<br/>[Prompt Analysis.md]"]
  node_changes["CHANGES<br/>release notes<br/>[CHANGES.md]"]
end

subgraph group_community["Community"]
  node_issue_bug["Bug Report<br/>issue template<br/>[bug_report.md]"]
  node_issue_feature["Feature Request<br/>issue template<br/>[feature_request.md]"]
  node_pr_template["PR Template<br/>contribution template"]
end

node_readme -->|"points to"| node_main_prompt
node_readme -->|"introduces"| node_usage_guide
node_readme -->|"references"| node_config_guide
node_readme -->|"mentions"| node_wizard
node_readme -->|"offers"| node_alt_prompt
node_main_prompt -->|"consumes"| node_user_profile
node_main_prompt -->|"works with"| node_wizard
node_main_prompt -->|"explained by"| node_usage_guide
node_main_prompt -->|"configured by"| node_config_guide
node_alt_prompt -.->|"mirrors"| node_main_prompt
node_wizard -->|"writes"| node_user_profile
node_config_guide -->|"defines"| node_user_profile
node_usage_guide -->|"operates"| node_main_prompt
node_prompt_analysis -->|"analyzes"| node_main_prompt
node_prompt_analysis -->|"analyzes"| node_alt_prompt
node_changes -.->|"supports"| node_readme
node_issue_bug -.->|"supports"| node_readme
node_issue_feature -.->|"supports"| node_readme
node_pr_template -.->|"supports"| node_readme

click node_readme "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/README.md"
click node_main_prompt "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Mr_Ranedeer.txt"
click node_alt_prompt "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/GPT_Prompt.txt"
click node_user_profile "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/My_Information.txt"
click node_wizard "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Extensions/Wizard.txt"
click node_config_guide "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Guides/Config Guide.md"
click node_usage_guide "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Guides/How to use Mr. Ranedeer.md"
click node_prompt_analysis "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Prompt Analysis.md"
click node_changes "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/CHANGES.md"
click node_issue_bug "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/.github/ISSUE_TEMPLATE/bug_report.md"
click node_issue_feature "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/.github/ISSUE_TEMPLATE/feature_request.md"
click node_pr_template "https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/.github/PULL_REQUEST_TEMPLATE.md"

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_readme toneBlue
class node_main_prompt,node_alt_prompt toneAmber
class node_user_profile,node_wizard toneMint
class node_config_guide,node_usage_guide,node_prompt_analysis,node_changes toneRose
class node_issue_bug,node_issue_feature,node_pr_template toneIndigo
```

## Components

### Front Door

Public entrypoint and product overview.

- [README](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/README.md): entry docs · Public front door, status note, and links into the prompt system. · `README.md`

### Prompt Core

Primary tutoring prompts and control logic.

- [Mr. Ranedeer](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Mr_Ranedeer.txt): tutor prompt · Primary system prompt that defines the tutor persona, lesson flow, commands, and behavior. · `Mr_Ranedeer.txt`
- [GPT Prompt](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/GPT_Prompt.txt): alternate prompt · Secondary prompt entrypoint that carries similar tutoring behavior into other contexts. · `GPT_Prompt.txt`

### Personalization

User-specific inputs and configuration assistant.

- [My Information](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/My_Information.txt): profile data · User-specific configuration and learner preferences used to personalize tutoring. · `My_Information.txt`
- [Wizard](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/Extensions/Wizard.txt): config assistant · Extension that helps users choose settings and personalize the tutor before learning begins. · `Extensions/Wizard.txt`

### Docs & Meta

Usage guides and design notes.

- [Config Guide](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/HEAD/Guides/Config%20Guide.md): schema guide · Documents the configuration options and how to populate the user profile. · `Guides/Config Guide.md`
- [How to Use](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/HEAD/Guides/How%20to%20use%20Mr.%20Ranedeer.md): usage guide · Explains the manual workflow for loading and using the tutor prompt. · `Guides/How to use Mr. Ranedeer.md`
- [Prompt Analysis](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/HEAD/Prompt%20Analysis.md): design notes · Meta-analysis of the prompt structure and intended behavior. · `Prompt Analysis.md`
- [CHANGES](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/CHANGES.md): release notes · Project change log and historical updates. · `CHANGES.md`

### Community

Contribution workflow templates.

- [Bug Report](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/.github/ISSUE_TEMPLATE/bug_report.md): issue template · Template for reporting problems with the prompt package. · `.github/ISSUE_TEMPLATE/bug_report.md`
- [Feature Request](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/.github/ISSUE_TEMPLATE/feature_request.md): issue template · Template for suggesting enhancements or new prompt capabilities. · `.github/ISSUE_TEMPLATE/feature_request.md`
- [PR Template](https://github.com/jushbjj/mr.-ranedeer-ai-tutor/blob/main/.github/PULL_REQUEST_TEMPLATE.md): contribution template · Template for pull requests and contribution workflow. · `.github/PULL_REQUEST_TEMPLATE.md`

## Connections

- README → Mr. Ranedeer: points to · The README directs users to the core tutor prompt.
- README → How to Use: introduces · The README frames the expected manual usage flow.
- README → Config Guide: references · The README surfaces configuration guidance for users.
- README → Wizard: mentions · The README points to the Wizard as a setup aid.
- README → GPT Prompt: offers · A secondary prompt entrypoint is surfaced alongside the main prompt.
- Mr. Ranedeer → My Information: consumes · The tutor prompt reads personalization inputs from the user profile.
- Mr. Ranedeer → Wizard: works with · The Wizard helps prepare settings used by the main prompt.
- Mr. Ranedeer → How to Use: explained by · Usage instructions describe how to run the prompt in chat.
- Mr. Ranedeer → Config Guide: configured by · Configuration schema shapes the behavior of the prompt.
- GPT Prompt → Mr. Ranedeer: mirrors · The alternate prompt reuses the core tutoring behavior.
- Wizard → My Information: writes · The Wizard helps populate the personalization layer.
- Config Guide → My Information: defines · The guide documents the fields stored in the user profile.
- How to Use → Mr. Ranedeer: operates · The usage guide describes the main prompt workflow.
- Prompt Analysis → Mr. Ranedeer: analyzes · Design notes explain the structure of the primary prompt.
- Prompt Analysis → GPT Prompt: analyzes · Design notes also cover the alternate prompt entrypoint.
- CHANGES → README: supports · Release history complements the public product overview.
- Bug Report → README: supports · Issue workflow supports the documented project surface.
- Feature Request → README: supports · Feature requests feed improvements to the prompt package.
- PR Template → README: supports · Pull request template supports repository contributions.
