# Claude Code Zero to Hero Workspace

This is the starter workspace for the class. Each workshop is self-contained — you can join, skip, or repeat any section without breaking the next.

## Start Here

1. Open this folder with Claude Code (see "How To Open This Folder With Claude Code" below if this is your first time).
2. Find the folder for the section you are in: `01-orientation/`, `04-plan-act-review/`, `05-context-memory/`, `07-skills/`, `08-subagents/`, or `10-capstone/`.
3. **`cd` into that section folder before launching Claude Code.** Sections 7, 8, and 10 each ship a pre-installed Skill / Subagent / Hook inside their own `.claude/` folder, and Claude Code only auto-discovers them when launched from that directory. Sections without `.claude/` can be launched from either the workspace root or the section folder — same result.
4. Open `INSTRUCTIONS.md` inside that section folder — it has every prompt for the section. Copy each prompt into Claude Code in order.
5. Do not worry if you do not know Terminal yet. Section 2 in class teaches only the folder-location commands needed for this course.

## How To Open This Folder With Claude Code

First time? Pick the steps for your operating system.

### macOS

1. After unzipping, locate the `claude-code-zero-to-hero-workspace` folder. It is usually inside your `Downloads` folder.
2. Open Terminal: press `⌘ + Space`, type `Terminal`, press Return.
3. In Terminal, type `cd ` (the word `cd` followed by one space), then drag the `claude-code-zero-to-hero-workspace` folder from Finder onto the Terminal window. Press Return.
4. Type `claude` and press Return. Claude Code starts inside this folder.

### Windows

1. After unzipping, locate the `claude-code-zero-to-hero-workspace` folder in File Explorer. It is usually inside your `Downloads` folder.
2. Open `claude-code-zero-to-hero-workspace` in File Explorer so you are looking at its contents.
3. Click the File Explorer address bar, type `wt` (Windows Terminal) or `powershell`, then press Enter. A terminal opens at this folder.
4. Type `claude` and press Enter. Claude Code starts inside this folder.

### Verify You Are In The Right Place

In the terminal you just opened, type one of the following and press Return / Enter:

- macOS: `pwd`
- Windows PowerShell: `pwd` (or `Get-Location`)

The line should end with `claude-code-zero-to-hero-workspace`. If it does not, tell the instructor before pasting any class prompt.

## Setup Requirement

Most sections do not require any install or network access — Plan/Act/Review, Context/Memory, Subagents, and Plugins all work with static local files and built-in operating-system commands. The Hooks section (6) and the MCP section (9) are prompt/demo-only — copy the prompt directly from the slide; there are no folders for them in this workspace.

**Section 7 (Skills)** ships the HyperFrames Skill pre-installed at `07-skills/.claude/skills/hyperframes/` (alongside the local `folder-graph` Skill), so Claude Code auto-discovers it as soon as you `cd 07-skills && claude` — no install step needed. The optional MP4 render at the end requires **Node.js ≥ 22**. If you cannot install Node.js, you can still read the Skill anatomy and have Claude write the `composition.html` — only the final render needs Node.js.

**Section 8 (Subagents)** ships the research-evidence-reviewer subagent pre-installed at `08-subagents/.claude/agents/research-evidence-reviewer.md`. Launch with `cd 08-subagents && claude` for Claude Code to auto-discover it.

**Section 10 (Capstone)** ships everything pre-wired inside `10-capstone/.claude/`: the `frontend-design` Skill, a copy of the `research-evidence-reviewer` subagent, and a PostToolUse hook that auto-stamps `outputs/run-log.md`. Launch with `cd 10-capstone && claude` before pasting the capstone prompt.

## Course Rule

Claude Code can help with local files, tools, context, and workflows, but you stay in control. Read what it asks to do before approving file edits, shell commands, network access, or external-system actions.

## Workshop Folders

Each workshop folder is independent. Open the one for the section you are in. Sections 4, 5, 7, 8, and 10 each ship with an `INSTRUCTIONS.md` containing the full prompts, plus an `inputs/` folder with the source files for the workshop. Everyone in the room works the same source material so the class can move at one pace.

- `01-orientation/` — Section 1 orientation files and a demo file to inspect.
- `04-plan-act-review/` — Plan, Act, Review. Work: finance/management note from public SET-listed company data (ADVANC 2022–2025).
- `05-context-memory/` — Context and Memory. Work: Thailand-market campaign brief from DataReportal Digital 2026 reach data. Includes `CLAUDE.template.md` and `CLAUDE.section-layer.template.md`.
- `07-skills/` — Skills. **Launch from inside this folder** (`cd 07-skills && claude`). Work: read the pre-installed HyperFrames Skill at `07-skills/.claude/skills/hyperframes/` and use it to render a ~12-second course trailer from 20 slide screenshots in `inputs/slide-screenshots/`. Optional MP4 render requires Node.js ≥ 22. Includes `installed-skill-reference.md`.
- `08-subagents/` — Subagents. **Launch from inside this folder** (`cd 08-subagents && claude`). Work: design a parameterized "research evidence reviewer" specialist using public World Bank physician-density data, and run the pre-installed version at `08-subagents/.claude/agents/research-evidence-reviewer.md`. Includes `subagent-brief.template.md`.
- `10-capstone/` — Capstone. **Launch from inside this folder** (`cd 10-capstone && claude`). Work: produce a one-page Thailand Digital 2026 briefing website (`outputs/briefing.html`) using the bundled `frontend-design` Skill, the `research-evidence-reviewer` subagent, and a PostToolUse hook that auto-stamps `outputs/run-log.md`. Sources reuse the DataReportal Thailand 2026 dataset from Section 5.
