# adilshamim8/genai-roadmap-with-notes-and-projects architecture

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

- Interactive diagram: https://gitdiagram.com/adilshamim8/genai-roadmap-with-notes-and-projects
- Repository: https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects

## Overview

This repository is a production-focused GenAI learning roadmap, not a single application. A learner chooses a starting path, progresses through the 12 skill rungs, builds portfolio projects, and runs their evaluation harnesses. The README also documents career guidance, decision guides, and curated resources. The supplied tree exposes only project scaffolding; project internals and most documentation files were not sampled, so links to those capabilities reflect README statements rather than inspected implementation.

Main entry points: [`foundations`](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/foundations) (Foundations), [`llm-calling`](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/llm-calling) (LLM calling), [`context-engineering`](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/context-engineering) (Context engineering), [`rag`](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/rag) (Modern RAG)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Technical curriculum"]
  node_foundations["Foundations"]
  node_llm["LLM calling"]
  node_context["Context engineering"]
  node_rag["Modern RAG"]
  node_tools["Tools and MCP"]
  node_agents["Single agents"]
  node_multiagent["Multi-agent"]
  node_evals["Evals"]
  node_production["Production"]
  node_selfhosting["Fine-tuning and hosting"]
  node_safety["Safety and red-teaming"]
  node_voice["Real-time voice"]
end

subgraph group_practice["Portfolio practice"]
  node_projects["Portfolio projects"]
  node_projectevals["Project eval harnesses"]
end

subgraph group_guidance["Learning guidance"]
  node_paths["Learning paths"]
  node_decisions["Decision guides"]
end

subgraph group_resources["Career and resources"]
  node_fieldguide["GenAI field guide"]
  node_awesome["Curated resources"]
end

node_learner(("Learner"))

node_learner -->|"chooses path"| node_paths
node_learner -->|"starts at"| node_foundations
node_foundations -->|"next rung"| node_llm
node_llm -->|"next rung"| node_context
node_context -->|"next rung"| node_rag
node_rag -->|"next rung"| node_tools
node_tools -->|"next rung"| node_agents
node_agents -->|"next rung"| node_multiagent
node_multiagent -->|"next rung"| node_evals
node_evals -->|"next rung"| node_production
node_production -->|"next rung"| node_selfhosting
node_selfhosting -->|"next rung"| node_safety
node_safety -->|"next rung"| node_voice
node_learner -->|"builds projects"| node_projects
node_projects -->|"runs evals"| node_projectevals
node_learner -->|"consults"| node_decisions
node_learner -->|"explores"| node_fieldguide
node_learner -->|"explores"| node_awesome

click node_foundations "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/foundations"
click node_llm "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/llm-calling"
click node_context "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/context-engineering"
click node_rag "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/rag"
click node_tools "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/tools-and-mcp"
click node_agents "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/agents"
click node_multiagent "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/multi-agent"
click node_evals "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/evals"
click node_production "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/production"
click node_selfhosting "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/fine-tuning-and-self-hosting"
click node_safety "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/safety"
click node_voice "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/realtime-voice"
click node_projects "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/projects"
click node_projectevals "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/projects"
click node_paths "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/docs/learning-paths"
click node_decisions "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/docs/decision-guides"
click node_fieldguide "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/field-guide"
click node_awesome "https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/awesome"

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_foundations,node_llm,node_context,node_rag,node_tools,node_agents,node_multiagent,node_evals,node_production,node_selfhosting,node_safety,node_voice toneBlue
class node_projects,node_projectevals toneAmber
class node_paths,node_decisions toneMint
class node_fieldguide,node_awesome toneRose
class node_learner toneIndigo
```

## Components

### Technical curriculum

- [Foundations](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/foundations): `foundations`
- [LLM calling](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/llm-calling): `llm-calling`
- [Context engineering](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/context-engineering): `context-engineering`
- [Modern RAG](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/rag): `rag`
- [Tools and MCP](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/tools-and-mcp): `tools-and-mcp`
- [Single agents](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/agents): `agents`
- [Multi-agent](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/multi-agent): `multi-agent`
- [Evals](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/evals): `evals`
- [Production](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/production): `production`
- [Fine-tuning and hosting](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/fine-tuning-and-self-hosting): `fine-tuning-and-self-hosting`
- [Safety and red-teaming](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/safety): `safety`
- [Real-time voice](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/realtime-voice): `realtime-voice`

### Portfolio practice

- [Portfolio projects](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/projects): `projects`
- [Project eval harnesses](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/projects): `projects`

### Learning guidance

- [Learning paths](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/docs/learning-paths): `docs/learning-paths`
- [Decision guides](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/docs/decision-guides): `docs/decision-guides`

### Career and resources

- [GenAI field guide](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/field-guide): `field-guide`
- [Curated resources](https://github.com/adilshamim8/genai-roadmap-with-notes-and-projects/tree/main/awesome): `awesome`

### Other components

- **Learner**

## Connections

- Learner → Learning paths: chooses path (evidence: `README.md`)
- Learner → Foundations: starts at (evidence: `README.md`)
- Foundations → LLM calling: next rung (evidence: `README.md`)
- LLM calling → Context engineering: next rung (evidence: `README.md`)
- Context engineering → Modern RAG: next rung (evidence: `README.md`)
- Modern RAG → Tools and MCP: next rung (evidence: `README.md`)
- Tools and MCP → Single agents: next rung (evidence: `README.md`)
- Single agents → Multi-agent: next rung (evidence: `README.md`)
- Multi-agent → Evals: next rung (evidence: `README.md`)
- Evals → Production: next rung (evidence: `README.md`)
- Production → Fine-tuning and hosting: next rung (evidence: `README.md`)
- Fine-tuning and hosting → Safety and red-teaming: next rung (evidence: `README.md`)
- Safety and red-teaming → Real-time voice: next rung (evidence: `README.md`)
- Learner → Portfolio projects: builds projects (evidence: `README.md`)
- Portfolio projects → Project eval harnesses: runs evals (evidence: `README.md`)
- Learner → Decision guides: consults (evidence: `README.md`)
- Learner → GenAI field guide: explores (evidence: `README.md`)
- Learner → Curated resources: explores (evidence: `README.md`)
