# datatalksclub/ai-dev-tools-zoomcamp architecture

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

- Interactive diagram: https://gitdiagram.com/datatalksclub/ai-dev-tools-zoomcamp
- Repository: https://github.com/datatalksclub/ai-dev-tools-zoomcamp

## Overview

This repository is a hands-on course, not a deployed application. Its learner workflow is to develop an AI-assisted engineering practice, build and verify a full-stack app, deploy it, and learn to operate and extend it. The weekly-feedback CLI is a small practical tool within the first module. The graph follows the README’s documented capabilities; details of unsampled module materials are represented only at their documented module paths.

Main entry points: [`01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py`](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py) (Feedback CLI), [`README.md`](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/README.md) (AI Dev Tools course), [`01-ai-native-workflow/weekly-feedback/src/weekly_feedback/storage.py`](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/storage.py) (JSON store), [`01-ai-native-workflow/01-ai-native-developer-workflow.md`](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/01-ai-native-developer-workflow.md) (AI-native workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course Workflow"]
  node_course["AI Dev Tools course<br/>[README.md]"]
  node_workflow["AI-native workflow"]
  node_cohort["Cohort learning<br/>[README.md]"]
end

subgraph group_build["Application Development"]
  node_fullstack["Full-stack app"]
end

subgraph group_operate["Delivery and Operations"]
  node_deployment["Test and deploy"]
  node_devops["DevOps and observability"]
end

subgraph group_agents["Agent Extensions"]
  node_capabilities["Agent capabilities<br/>[README.md]"]
end

subgraph group_feedback["Weekly Feedback Tool"]
  node_weekly_cli["Feedback CLI<br/>[cli.py]"]
  node_git_activity["Git activity<br/>[gitlog.py]"]
  node_week_dates["Week parsing<br/>[weeks.py]"]
  node_feedback_model["Feedback models<br/>[models.py]"]
  node_feedback_store[("JSON store<br/>[storage.py]")]
  node_feedback_report["Digest rendering<br/>[report.py]"]
end

node_learner(("Developer learner"))

node_learner -->|"learns through"| node_course
node_course -->|"starts with"| node_workflow
node_workflow -->|"builds toward"| node_fullstack
node_fullstack -->|"then deploys"| node_deployment
node_deployment -->|"then operates"| node_devops
node_course -->|"also extends agents"| node_capabilities
node_course -->|"offers cohort study"| node_cohort
node_learner -->|"records feedback"| node_weekly_cli
node_weekly_cli -->|"parses weeks"| node_week_dates
node_weekly_cli -->|"creates entries"| node_feedback_model
node_weekly_cli -->|"loads and saves"| node_feedback_store
node_weekly_cli -->|"drafts from Git"| node_git_activity
node_git_activity -->|"gets week range"| node_week_dates
node_weekly_cli -->|"renders reports"| node_feedback_report
node_feedback_report -->|"reads entries"| node_feedback_store
node_feedback_store -->|"serializes records"| node_feedback_model

click node_course "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/README.md"
click node_workflow "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/01-ai-native-developer-workflow.md"
click node_weekly_cli "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py"
click node_git_activity "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/gitlog.py"
click node_week_dates "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/weeks.py"
click node_feedback_model "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/models.py"
click node_feedback_store "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/storage.py"
click node_feedback_report "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/report.py"
click node_fullstack "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/02-development/01-build-and-ship-an-ai-assisted-full-stack-app.md"
click node_deployment "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/03-deployment/01-test-containerize-and-deploy-an-ai-assisted-app.md"
click node_devops "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/04-devops/01-devops-and-observability-for-ai-built-apps.md"
click node_capabilities "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/05-agent-capabilities/README.md"
click node_cohort "https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/cohorts/2026/README.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_course,node_workflow,node_cohort toneBlue
class node_fullstack toneAmber
class node_deployment,node_devops toneMint
class node_capabilities toneRose
class node_weekly_cli,node_git_activity,node_week_dates,node_feedback_model,node_feedback_store,node_feedback_report,node_learner toneIndigo
```

## Components

### Course Workflow

- [AI Dev Tools course](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/README.md): `README.md`
- [AI-native workflow](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/01-ai-native-developer-workflow.md): `01-ai-native-workflow/01-ai-native-developer-workflow.md`
- [Cohort learning](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/cohorts/2026/README.md): `cohorts/2026/README.md`

### Application Development

- [Full-stack app](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/02-development/01-build-and-ship-an-ai-assisted-full-stack-app.md): `02-development/01-build-and-ship-an-ai-assisted-full-stack-app.md`

### Delivery and Operations

- [Test and deploy](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/03-deployment/01-test-containerize-and-deploy-an-ai-assisted-app.md): `03-deployment/01-test-containerize-and-deploy-an-ai-assisted-app.md`
- [DevOps and observability](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/04-devops/01-devops-and-observability-for-ai-built-apps.md): `04-devops/01-devops-and-observability-for-ai-built-apps.md`

### Agent Extensions

- [Agent capabilities](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/05-agent-capabilities/README.md): `05-agent-capabilities/README.md`

### Weekly Feedback Tool

- [Feedback CLI](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py): `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py`
- [Git activity](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/gitlog.py): `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/gitlog.py`
- [Week parsing](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/weeks.py): `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/weeks.py`
- [Feedback models](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/models.py): `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/models.py`
- [JSON store](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/storage.py): `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/storage.py`
- [Digest rendering](https://github.com/datatalksclub/ai-dev-tools-zoomcamp/blob/main/01-ai-native-workflow/weekly-feedback/src/weekly_feedback/report.py): `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/report.py`

### Other components

- **Developer learner**

## Connections

- Developer learner → AI Dev Tools course: learns through (evidence: `README.md`)
- AI Dev Tools course → AI-native workflow: starts with (evidence: `README.md`)
- AI-native workflow → Full-stack app: builds toward (evidence: `README.md`)
- Full-stack app → Test and deploy: then deploys (evidence: `README.md`)
- Test and deploy → DevOps and observability: then operates (evidence: `README.md`)
- AI Dev Tools course → Agent capabilities: also extends agents (evidence: `README.md`)
- AI Dev Tools course → Cohort learning: offers cohort study (evidence: `README.md`)
- Developer learner → Feedback CLI: records feedback (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py`)
- Feedback CLI → Week parsing: parses weeks (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py`)
- Feedback CLI → Feedback models: creates entries (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py`)
- Feedback CLI → JSON store: loads and saves (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py`)
- Feedback CLI → Git activity: drafts from Git (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py`)
- Git activity → Week parsing: gets week range (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/gitlog.py`)
- Feedback CLI → Digest rendering: renders reports (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/cli.py`)
- Digest rendering → JSON store: reads entries (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/report.py`)
- JSON store → Feedback models: serializes records (evidence: `01-ai-native-workflow/weekly-feedback/src/weekly_feedback/storage.py`)
