# udacity/cd14715-claude-code-classroom architecture

> Architecture diagram of the GitHub repository udacity/cd14715-claude-code-classroom, 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/udacity/cd14715-claude-code-classroom
- Repository: https://github.com/udacity/cd14715-claude-code-classroom

## Overview

This repository is a hands-on Claude/agent engineering classroom: learners work through independent lesson exercises and a starter code-review project. The lesson sequence demonstrates model selection, reasoning, SDK workflows, custom tools, structured output, skills, MCP, multi-agent coordination, evaluation, and computer use. Sample inputs and lesson entry points support several exercises; the project starter sketches PR review orchestration and report types but is incomplete. The graph emphasizes solution exercises rather than duplicating starter variants. Some lesson subsystems are represented by their exact source directories because their implementation was not sampled.

Main entry points: [`lesson-01-model-selection/exercise/solution/src/classifier.ts`](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/classifier.ts) (Ticket Classifier), [`lesson-12-evaluating-agents/exercise/solution/src/sentiment-agent.ts`](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/sentiment-agent.ts) (Sentiment Agent), [`lesson-09-mcp-integration/exercise/solution/src/code-reviewer.ts`](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-09-mcp-integration/exercise/solution/src/code-reviewer.ts) (MCP Code Reviewer), [`lesson-02-extended-thinking/exercise/solution/src/fraud-analyzer.ts`](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-02-extended-thinking/exercise/solution/src/fraud-analyzer.ts) (Fraud Analyzer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Agent Foundations"]
  node_warmup["Agent Warm-up<br/>[hello-agent.ts]"]
  node_ticket_classifier["Ticket Classifier<br/>[classifier.ts]"]
  node_model_options["Model Options<br/>[models.ts]"]
  node_classifier_helpers["Classifier Helpers<br/>[helpers.ts]"]
  node_sample_tickets["Sample Tickets<br/>[sample-tickets.ts]"]
  node_fraud_analyzer["Fraud Analyzer<br/>[fraud-analyzer.ts]"]
  node_fraud_inputs["Transaction Samples"]
  node_contract_standardizer["Contract Standardizer"]
  node_contract_samples["Contract Samples"]
end

subgraph group_tools["Tools and Integration"]
  node_api_validator["API Validator Tool<br/>[api-validator.ts]"]
  node_meeting_analyzer["Meeting Analyzer"]
  node_js_reviewer["Skill Code Reviewer<br/>[js-reviewer.ts]"]
  node_mcp_reviewer["MCP Code Reviewer<br/>[code-reviewer.ts]"]
  node_mcp_config["MCP Configuration<br/>[mcp.config.ts]"]
  node_eslint_mcp{{"ESLint MCP Server"}}
end

subgraph group_orchestration["Orchestration"]
  node_sales_qualifier["Sales Qualifier<br/>[sales-qualifier.ts]"]
  node_prospect_samples["Prospect Samples"]
  node_shopping_cart["Shopping Cart Example<br/>[shopping-cart.ts]"]
end

subgraph group_evaluation["Evaluation and Interaction"]
  node_sentiment_agent["Sentiment Agent<br/>[sentiment-agent.ts]"]
  node_sentiment_tool["Sentiment Tool<br/>[sentiment-tool.ts]"]
  node_sentiment_schema["Sentiment Types<br/>[types.ts]"]
  node_agent_evaluators["Agent Evaluators<br/>[index.ts]"]
  node_form_agent["Form Automation Agent<br/>[form-agent.ts]"]
  node_action_handlers["Computer Action Handlers<br/>[action-handlers.ts]"]
  node_computer_types["Computer Action Types<br/>[types.ts]"]
end

subgraph group_project["Review Project"]
  node_project_main["Project Entry Point<br/>[main.ts]"]
  node_pr_orchestrator["PR Review Orchestrator<br/>[orchestrator.ts]"]
  node_report_types["Review Report Types<br/>[report-types.ts]"]
end

node_ticket_classifier -->|"uses model definitions"| node_model_options
node_ticket_classifier -->|"uses helpers"| node_classifier_helpers
node_ticket_classifier -->|"loads sample tickets"| node_sample_tickets
node_fraud_analyzer -->|"uses transaction data"| node_fraud_inputs
node_contract_standardizer -->|"receives sample contracts"| node_contract_samples
node_mcp_reviewer -->|"configures servers"| node_mcp_config
node_mcp_reviewer -->|"dispatches lint tools"| node_eslint_mcp
node_sales_qualifier -->|"qualifies sample prospect"| node_prospect_samples
node_sentiment_agent -->|"uses tool"| node_sentiment_tool
node_sentiment_agent -->|"uses output types"| node_sentiment_schema
node_agent_evaluators -->|"evaluates agent traces"| node_sentiment_agent
node_action_handlers -->|"uses action types"| node_computer_types
node_pr_orchestrator -->|"returns review report"| node_report_types

click node_warmup "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-00-warm-up/exercise/starter/src/hello-agent.ts"
click node_ticket_classifier "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/classifier.ts"
click node_model_options "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/models.ts"
click node_classifier_helpers "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/helpers.ts"
click node_sample_tickets "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/sample-tickets.ts"
click node_fraud_analyzer "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-02-extended-thinking/exercise/solution/src/fraud-analyzer.ts"
click node_fraud_inputs "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-02-extended-thinking/exercise/solution/src/sample-transactions.ts"
click node_contract_standardizer "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-05-agent-sdk/exercise/solution/src/contract-standardizer.ts"
click node_contract_samples "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-05-agent-sdk/exercise/solution/src/sample-contracts.ts"
click node_api_validator "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-06-custom-tools/exercise/solution/src/api-validator.ts"
click node_meeting_analyzer "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-07-structured-outputs/exercise/solution/src/meeting-analyzer.ts"
click node_js_reviewer "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-08-claude-skills/exercise/solution/src/js-reviewer.ts"
click node_mcp_reviewer "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-09-mcp-integration/exercise/solution/src/code-reviewer.ts"
click node_mcp_config "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-09-mcp-integration/exercise/solution/src/config/mcp.config.ts"
click node_sales_qualifier "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-10-multi-agent-orchestration/exercise/solution/src/sales-qualifier.ts"
click node_prospect_samples "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-10-multi-agent-orchestration/exercise/solution/src/sample-prospects.ts"
click node_shopping_cart "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-11-tdd-with-ai/exercise/solution/src/shopping-cart.ts"
click node_sentiment_agent "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/sentiment-agent.ts"
click node_sentiment_tool "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/sentiment-tool.ts"
click node_sentiment_schema "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/types.ts"
click node_agent_evaluators "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/evaluators/index.ts"
click node_form_agent "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-13-computer-use/exercise/solution/src/form-agent.ts"
click node_action_handlers "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-13-computer-use/exercise/solution/src/action-handlers.ts"
click node_computer_types "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-13-computer-use/exercise/solution/src/types.ts"
click node_project_main "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/project/starter/src/main.ts"
click node_pr_orchestrator "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/project/starter/src/orchestrator.ts"
click node_report_types "https://github.com/udacity/cd14715-claude-code-classroom/blob/main/project/starter/src/types/report-types.ts"

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_warmup,node_ticket_classifier,node_model_options,node_classifier_helpers,node_sample_tickets,node_fraud_analyzer,node_fraud_inputs,node_contract_standardizer,node_contract_samples toneBlue
class node_api_validator,node_meeting_analyzer,node_js_reviewer,node_mcp_reviewer,node_mcp_config,node_eslint_mcp toneAmber
class node_sales_qualifier,node_prospect_samples,node_shopping_cart toneMint
class node_sentiment_agent,node_sentiment_tool,node_sentiment_schema,node_agent_evaluators,node_form_agent,node_action_handlers,node_computer_types toneRose
class node_project_main,node_pr_orchestrator,node_report_types toneIndigo
```

## Components

### Agent Foundations

- [Agent Warm-up](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-00-warm-up/exercise/starter/src/hello-agent.ts): `lesson-00-warm-up/exercise/starter/src/hello-agent.ts`
- [Ticket Classifier](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/classifier.ts): `lesson-01-model-selection/exercise/solution/src/classifier.ts`
- [Model Options](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/models.ts): `lesson-01-model-selection/exercise/solution/src/models.ts`
- [Classifier Helpers](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/helpers.ts): `lesson-01-model-selection/exercise/solution/src/helpers.ts`
- [Sample Tickets](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-01-model-selection/exercise/solution/src/sample-tickets.ts): `lesson-01-model-selection/exercise/solution/src/sample-tickets.ts`
- [Fraud Analyzer](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-02-extended-thinking/exercise/solution/src/fraud-analyzer.ts): `lesson-02-extended-thinking/exercise/solution/src/fraud-analyzer.ts`
- [Transaction Samples](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-02-extended-thinking/exercise/solution/src/sample-transactions.ts): `lesson-02-extended-thinking/exercise/solution/src/sample-transactions.ts`
- [Contract Standardizer](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-05-agent-sdk/exercise/solution/src/contract-standardizer.ts): `lesson-05-agent-sdk/exercise/solution/src/contract-standardizer.ts`
- [Contract Samples](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-05-agent-sdk/exercise/solution/src/sample-contracts.ts): `lesson-05-agent-sdk/exercise/solution/src/sample-contracts.ts`

### Tools and Integration

- [API Validator Tool](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-06-custom-tools/exercise/solution/src/api-validator.ts): `lesson-06-custom-tools/exercise/solution/src/api-validator.ts`
- [Meeting Analyzer](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-07-structured-outputs/exercise/solution/src/meeting-analyzer.ts): `lesson-07-structured-outputs/exercise/solution/src/meeting-analyzer.ts`
- [Skill Code Reviewer](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-08-claude-skills/exercise/solution/src/js-reviewer.ts): `lesson-08-claude-skills/exercise/solution/src/js-reviewer.ts`
- [MCP Code Reviewer](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-09-mcp-integration/exercise/solution/src/code-reviewer.ts): `lesson-09-mcp-integration/exercise/solution/src/code-reviewer.ts`
- [MCP Configuration](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-09-mcp-integration/exercise/solution/src/config/mcp.config.ts): `lesson-09-mcp-integration/exercise/solution/src/config/mcp.config.ts`
- **ESLint MCP Server**

### Orchestration

- [Sales Qualifier](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-10-multi-agent-orchestration/exercise/solution/src/sales-qualifier.ts): `lesson-10-multi-agent-orchestration/exercise/solution/src/sales-qualifier.ts`
- [Prospect Samples](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-10-multi-agent-orchestration/exercise/solution/src/sample-prospects.ts): `lesson-10-multi-agent-orchestration/exercise/solution/src/sample-prospects.ts`
- [Shopping Cart Example](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-11-tdd-with-ai/exercise/solution/src/shopping-cart.ts): `lesson-11-tdd-with-ai/exercise/solution/src/shopping-cart.ts`

### Evaluation and Interaction

- [Sentiment Agent](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/sentiment-agent.ts): `lesson-12-evaluating-agents/exercise/solution/src/sentiment-agent.ts`
- [Sentiment Tool](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/sentiment-tool.ts): `lesson-12-evaluating-agents/exercise/solution/src/sentiment-tool.ts`
- [Sentiment Types](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/types.ts): `lesson-12-evaluating-agents/exercise/solution/src/types.ts`
- [Agent Evaluators](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-12-evaluating-agents/exercise/solution/src/evaluators/index.ts): `lesson-12-evaluating-agents/exercise/solution/src/evaluators/index.ts`
- [Form Automation Agent](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-13-computer-use/exercise/solution/src/form-agent.ts): `lesson-13-computer-use/exercise/solution/src/form-agent.ts`
- [Computer Action Handlers](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-13-computer-use/exercise/solution/src/action-handlers.ts): `lesson-13-computer-use/exercise/solution/src/action-handlers.ts`
- [Computer Action Types](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/lesson-13-computer-use/exercise/solution/src/types.ts): `lesson-13-computer-use/exercise/solution/src/types.ts`

### Review Project

- [Project Entry Point](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/project/starter/src/main.ts): `project/starter/src/main.ts`
- [PR Review Orchestrator](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/project/starter/src/orchestrator.ts): `project/starter/src/orchestrator.ts`
- [Review Report Types](https://github.com/udacity/cd14715-claude-code-classroom/blob/main/project/starter/src/types/report-types.ts): `project/starter/src/types/report-types.ts`

## Connections

- Ticket Classifier → Model Options: uses model definitions (evidence: `lesson-01-model-selection/exercise/solution/src/classifier.ts`)
- Ticket Classifier → Classifier Helpers: uses helpers (evidence: `lesson-01-model-selection/exercise/solution/src/classifier.ts`)
- Ticket Classifier → Sample Tickets: loads sample tickets (evidence: `lesson-01-model-selection/exercise/solution/src/classifier.ts`)
- Fraud Analyzer → Transaction Samples: uses transaction data (evidence: `lesson-02-extended-thinking/exercise/solution/src/fraud-analyzer.ts`)
- Contract Standardizer → Contract Samples: receives sample contracts (evidence: `lesson-05-agent-sdk/exercise/solution/src/index.ts`)
- MCP Code Reviewer → MCP Configuration: configures servers (evidence: `lesson-09-mcp-integration/exercise/solution/src/code-reviewer.ts`)
- MCP Code Reviewer → ESLint MCP Server: dispatches lint tools (evidence: `lesson-09-mcp-integration/exercise/solution/src/code-reviewer.ts`)
- Sales Qualifier → Prospect Samples: qualifies sample prospect (evidence: `lesson-10-multi-agent-orchestration/exercise/solution/src/index.ts`)
- Sentiment Agent → Sentiment Tool: uses tool (evidence: `lesson-12-evaluating-agents/exercise/solution/src/sentiment-agent.ts`)
- Sentiment Agent → Sentiment Types: uses output types (evidence: `lesson-12-evaluating-agents/exercise/solution/src/sentiment-agent.ts`)
- Agent Evaluators → Sentiment Agent: evaluates agent traces (evidence: `lesson-12-evaluating-agents/exercise/solution/src/evaluators/index.ts`)
- Computer Action Handlers → Computer Action Types: uses action types (evidence: `lesson-13-computer-use/exercise/solution/src/action-handlers.ts`)
- PR Review Orchestrator → Review Report Types: returns review report (evidence: `project/starter/src/orchestrator.ts`)
