🧠 Context
@@ -1517,14 +1570,14 @@ 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
@@ -1551,7 +1604,7 @@ todoapp/
-
+
When to Turn Something Into a Skill
Tip from Boris Cherny (creator of Claude Code) — Feb 1, 2026
@@ -1588,7 +1641,7 @@ todoapp/
-
+
Why Separate Agents and Skills?
@@ -1614,7 +1667,7 @@ todoapp/
-
+
How to Create Your Own Skill
Skills are plain markdown files. If you can write a recipe, you can write a skill.
@@ -1667,7 +1720,7 @@ 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:
@@ -1707,14 +1760,14 @@ 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
@@ -1752,7 +1805,7 @@ 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.
@@ -1786,7 +1839,7 @@ 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.
@@ -1830,7 +1883,7 @@ 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.
@@ -1875,14 +1928,14 @@ 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
@@ -1910,7 +1963,7 @@ 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.
@@ -1955,7 +2008,7 @@ open, edit, save <
-
+
Grow CLAUDE.md With Every Mistake
Tip from Boris Cherny (creator of Claude Code) — Feb 1, 2026
@@ -1992,7 +2045,7 @@ open, edit, save <
-
+
What Goes in CLAUDE.md
@@ -2020,7 +2073,7 @@ 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:
@@ -2053,14 +2106,14 @@ 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
@@ -2104,7 +2157,7 @@ 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.
@@ -2159,14 +2212,14 @@ 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:
@@ -2193,7 +2246,7 @@ This is a TodoApp with a FastAPI backend and React frontend.
-
+
Two Ways Skills Are Used
The weather workflow demonstrates both skill patterns in a single flow:
@@ -2216,7 +2269,7 @@ 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.
@@ -2267,7 +2320,7 @@ 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.