diff --git a/presentation/learning-journey/index.html b/presentation/learning-journey/index.html index 3f3379d..b2d6c5b 100644 --- a/presentation/learning-journey/index.html +++ b/presentation/learning-journey/index.html @@ -166,9 +166,39 @@ - +
+

What is Claude Code?

+

Claude Code isn't just Claude. It's Claude (the model) wrapped in a harness with a set of tools — and that wrapper is what turns a chatbot into an agent.

+
+
+
🧠
+

Model

+

The brain. Knows everything up to its training cutoff. Doesn’t know today’s date, can’t read your files, can’t search the web.

+
+
+
💪
+

Harness

+

The body around the brain. Manages memory, permissions, how long conversations run, and how the brain talks to tools.

+
+
+
🤜
+

Tools

+

The hands. Read files, edit code, search the web, run commands, spawn helper agents.

+
+
+

Claude Code = Model + Harness + Tools

+
+

Why This Matters

+

Ask a bare model “what’s the capital of Pakistan?” — it answers from training data. Ask it “what time is it in Karachi right now?” — it can’t know. That second question needs a tool, exposed through a harness. That’s the difference Claude Code makes — and the rest of this session teaches you how to configure it.

+
+
+ + + + +

Vibe Coding vs Agentic Engineering

@@ -235,9 +265,9 @@ todoapp/
- + -
+

What is Vibe Coding?

@@ -264,9 +294,9 @@ todoapp/
- + -
+

Good vs Bad Prompts

Even before you set up any structure, how you prompt matters. Specific beats vague. Context beats assumption.

@@ -300,41 +330,41 @@ todoapp/
- + -
+

Meet the Person

We're going to learn five concepts using one running example: a weather reporter agent that fetches Dubai's temperature and renders a weather card. Same person — five different angles.

-
+
1
👤 Agents — The Person
A specialist with a job title: the weather reporter
-
+
2
🎓 Skills — What the Person Knows
fetch temperature • render SVG card • write the script
-
+
3
🧠 Context — The Person's Brain
finite working memory — ~1M tokens, resets each session
-
+
4
📋 CLAUDE.md — The Pocket Rulebook
standing instructions read at the start of every shift
-
+
5
🎼 Workflow — The Trigger
@@ -345,18 +375,18 @@ todoapp/
- + - -
+ +
Topic 1

👤 Agents — The Weather Reporter

An agent is Claude playing a specific role. Meet the weather reporter — a specialist hired to fetch and report weather data for Dubai. Same Claude, different hat.

- -
+ +

The Restaurant Kitchen

Think of it like this

@@ -378,8 +408,8 @@ todoapp/
- -
+ +

Prompting vs. Agent — Side by Side

The difference in one picture: prompting is asking a stranger on the street; using an agent is asking your dedicated specialist.

@@ -419,8 +449,8 @@ todoapp/ - -
+ +

Agents Get Their Own Brain

Tip from Thariq (Anthropic) — Apr 16, 2026

@@ -452,8 +482,8 @@ todoapp/
- -
+ +

How to Create Your Own Agent

You don't write an agent from scratch — Claude helps you build one. Type /agents inside Claude Code and a guided menu opens.

@@ -495,8 +525,8 @@ todoapp/
- -
+ +

Agent Config Fields

The config block at the top of an agent file controls its identity and capabilities. Here's what the real weather-agent.md uses:

@@ -540,18 +570,18 @@ todoapp/
- + - -
+ +
Topic 2

🎓 Skills — What the Weather Reporter Knows

Skills are the specific things the reporter has been trained to do. Our reporter has two: fetch the data, and render it as a card.

- -
+ +

The Training Manual

Think of it like this

@@ -577,8 +607,8 @@ todoapp/

Each skill has its own knowledge and methods. The reporter uses the right skill for the right step. Claude works the same way.

- -
+ +

When to Turn Something Into a Skill

Tip from Boris Cherny (creator of Claude Code) — Feb 1, 2026

@@ -614,8 +644,8 @@ todoapp/
- -
+ +

Why Separate Agents and Skills?

@@ -640,8 +670,8 @@ todoapp/
- -
+ +

How to Create Your Own Skill

Skills are plain markdown files. If you can write a recipe, you can write a skill.

@@ -693,8 +723,8 @@ Fetch the current temperature for Dubai, UAE.
- -
+ +

Skill Config Fields

The small config block at the top of a SKILL.md (the "frontmatter") controls how the skill behaves:

@@ -730,18 +760,18 @@ Fetch the current temperature for Dubai, UAE.
- + - -
+ +
Topic 3

🧠 Context — The Reporter's Brain

Now that you've met the reporter and know their skills, let's understand what they can actually hold in mind at once. Every agent — including the weather reporter — gets its own fresh brain.

- -
+ +

Claude's Brain

Think of it like this

@@ -778,8 +808,8 @@ Fetch the current temperature for Dubai, UAE.
- -
+ +

What Loads at Session Start

The moment you open Claude Code, certain things land in Claude's brain before you've typed a word. The rest waits in the wings — only loaded when you actually need it. This is called progressive disclosure.

Diagram showing what loads into Claude's context window at session start @@ -812,8 +842,8 @@ Fetch the current temperature for Dubai, UAE.
- -
+ +

Keep the Brain Clear

The more stuff crammed into Claude's brain, the harder it is to focus on what matters. This is called context rot — performance drops as the brain gets crowded.

@@ -856,8 +886,8 @@ Fetch the current temperature for Dubai, UAE.
- -
+ +

How to Manage Your Context

You can't create the context — it's just there, the moment you open a chat. But you can see how full it is, trim it down, or wipe it clean. Three commands give you full control.

@@ -898,18 +928,18 @@ Fetch the current temperature for Dubai, UAE.
- + - -
+ +
Topic 4

📋 CLAUDE.md — The Reporter's Pocket Rulebook

The weather reporter consults this at the start of every shift — even though their brain resets overnight. It's the standing instructions pinned in that brain before you've said a word.

- -
+ +

The Employee Handbook

Think of it like this

@@ -936,8 +966,8 @@ This is the Q2 marketing campaign brief — targeting small business owners.
- -
+ +

How to Create Your CLAUDE.md

You don't need to write CLAUDE.md by hand. Claude can look at your project and draft one for you.

@@ -981,8 +1011,8 @@ open, edit, save # Tweak it like any doc<
- -
+ +

Grow CLAUDE.md With Every Mistake

Tip from Boris Cherny (creator of Claude Code) — Feb 1, 2026

@@ -1018,8 +1048,8 @@ open, edit, save # Tweak it like any doc<
- -
+ +

What Goes in CLAUDE.md

# CLAUDE.md @@ -1046,8 +1076,8 @@ This is a TodoApp with a FastAPI backend and React frontend.
- -
+ +

How CLAUDE.md Loads

Claude Code uses two mechanisms to find CLAUDE.md files:

@@ -1076,18 +1106,18 @@ This is a TodoApp with a FastAPI backend and React frontend.
- + - -
+ +
Topic 5

⚡ Commands — The Trigger

One word kicks off the whole chain. /weather-orchestrator → agent → skill → SVG card. Commands are the entry point into any workflow.

- -
+ +

Commands — The Entry Point

Think of it like this

@@ -1130,8 +1160,8 @@ This is a TodoApp with a FastAPI backend and React frontend.
- -
+ +

How to Create Your Own Command

Commands are markdown files too. If you can write a recipe, you can write a command.

@@ -1182,18 +1212,18 @@ This is a TodoApp with a FastAPI backend and React frontend.
- + - -
+ +
Putting It All Together

🎼 Workflow — All Five Pieces Together

Watch the weather reporter example run from one keystroke to SVG card output. Five concepts, one orchestrated flow.

- -
+ +

Command → Agent → Skill

This is the core architecture pattern of Claude Code workflows — demonstrated in this very repo by the weather example:

The Orchestration Flow @@ -1219,8 +1249,8 @@ This is a TodoApp with a FastAPI backend and React frontend. Creates: weather.svg + output.md
- -
+ +

Two Ways Skills Are Used

The weather workflow demonstrates both skill patterns in a single flow:

@@ -1242,8 +1272,8 @@ This is a TodoApp with a FastAPI backend and React frontend.
- -
+ +

How to Wire Your Own Workflow

A workflow isn't a separate file type. It emerges when one command calls agents and skills in sequence.

@@ -1292,9 +1322,9 @@ This is a TodoApp with a FastAPI backend and React frontend.
- + -
+

Journey So Far

Five concepts, one running example

From meeting the weather reporter to wiring the full Command → Agent → Skill chain. The same five pieces compose every workflow you'll ever build.