From ecdc48dbf764a7ceb7cf0217860bdf0f22fe939c Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Wed, 22 Apr 2026 20:00:21 +0500 Subject: [PATCH] updated 10 harness --- .../index.html | 131 +++++++++++------- 1 file changed, 80 insertions(+), 51 deletions(-) diff --git a/presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini/index.html b/presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini/index.html index 7e05fed..f67b2c3 100644 --- a/presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini/index.html +++ b/presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini/index.html @@ -516,37 +516,66 @@ - +

💪 Harness — the body around the brain

-
-
+
+
+
🧑‍💼
+

Agents — the specialists

+

A dedicated Claude worker — own context, tools, focus.

+
+
+
🎯
+

Skills — the know-how

+

What the specialist (or Claude) can actually do.

+
+
+
💭
+

Context — the working memory

+

What Claude holds in its head now — 200K–1M tokens.

+
+
+
📘
+

Workflows — the instruction manual

+

Repeatable step-by-step recipes — like an AC install guide.

+
+
+
📝
+

CLAUDE.md — your memory

+

Persistent instructions you write.

+
+
+
+ + + + +
+

💪 Harness — the body around the brain

+
+
✋

Tools — the hands

Read, Edit, Bash, WebSearch.

-
+
👁️

MCP — the eyes

Claude in Chrome actually sees browser pages.

-
-
📝
-

CLAUDE.md — your memory

-

Instructions you write.

-
-
+
⚙️

System Prompt — Claude’s memory

Instructions Anthropic bakes in.

-
+
🛡️

Permissions — the guardrails

Allow / ask / deny for tool use.

-
+
🪝

Hooks — the reflexes

Deterministic scripts that fire on events.

@@ -557,7 +586,7 @@ -
+

💪 Limitation — Doesn’t always use its tools

Same question, different prompt — sometimes the harness asks first instead of acting.

@@ -568,7 +597,7 @@ -
+

💪 Limitation — Different sources, different answers

Same question across runs can route through different tools and sources.

@@ -579,7 +608,7 @@ -
+

💪 Limitation — Tools can fail

External tools can time out, return errors, or fetch stale data.

@@ -590,7 +619,7 @@ -
+

💪 Same question. Different path each time.

A harness gives the brain hands — but not a fixed routine.

@@ -600,7 +629,7 @@ -
+

Vibe Coding vs Agentic Engineering

@@ -669,7 +698,7 @@ todoapp/ -
+

What is Vibe Coding?

@@ -698,7 +727,7 @@ todoapp/ -
+

Good vs Bad Prompts

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

@@ -734,7 +763,7 @@ 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.

@@ -781,14 +810,14 @@ 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

@@ -811,7 +840,7 @@ 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.

@@ -852,7 +881,7 @@ todoapp/ -
+

Agents Get Their Own Brain

Tip from Thariq (Anthropic) — Apr 16, 2026

@@ -885,7 +914,7 @@ 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.

@@ -928,7 +957,7 @@ 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:

@@ -976,14 +1005,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

@@ -1010,7 +1039,7 @@ todoapp/
-
+

When to Turn Something Into a Skill

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

@@ -1047,7 +1076,7 @@ todoapp/
-
+

Why Separate Agents and Skills?

@@ -1073,7 +1102,7 @@ todoapp/
-
+

How to Create Your Own Skill

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

@@ -1126,7 +1155,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:

@@ -1166,14 +1195,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

@@ -1211,7 +1240,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.

Diagram showing what loads into Claude's context window at session start @@ -1245,7 +1274,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.

@@ -1289,7 +1318,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.

@@ -1334,14 +1363,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

@@ -1369,7 +1398,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.

@@ -1414,7 +1443,7 @@ 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

@@ -1451,7 +1480,7 @@ open, edit, save # Tweak it like any doc<
-
+

What Goes in CLAUDE.md

# CLAUDE.md @@ -1479,7 +1508,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:

@@ -1512,14 +1541,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

@@ -1563,7 +1592,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.

@@ -1618,14 +1647,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:

The Orchestration Flow @@ -1652,7 +1681,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:

@@ -1675,7 +1704,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.

@@ -1726,7 +1755,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.