Claude Code Workshop

A monorepo of projects built during the Claude Code Workshop. Each project is self-contained under a week-*/ folder; shared Claude/agent tooling lives at the repo root so every project can reuse it.

This README is intentionally workshop-level only — it links out to each project rather than describing any one of them. For details on a specific app, open that project's own README.md and docs (linked below).

Projects

Week	Project	Description	Links
3	Nutrition app	Cross-platform calorie & macro tracker (Next.js web + Expo mobile) with Gemini AI.	README · docs

New projects are added as week-*/<project>/ and linked here (and in the workshop docs).

Repository layout

.
├── week-3/
│   └── nutrition-app/      # a fully self-contained project (own package.json, tests, docs, .env)
├── docs/                   # workshop-level site — links to each project's docs
├── prompts/ , README, etc. # live INSIDE each project (project-specific)
│
├── .claude/                # shared Claude Code settings (all projects)
├── .agents/                # shared agent skills (e.g. frontend-design)
├── skills-lock.json        # pinned skill versions (shared)
└── .github/workflows/      # CI + Pages (must live at the repo root per GitHub;
                            #   each workflow targets a project via working-directory)

Why some things stay at the root: Claude/agent artifacts (.claude/, .agents/, skills-lock.json) are shared across all projects. GitHub requires Actions workflows at <repo>/.github/workflows/, so CI/Pages live at the root but are scoped to a project's path. Everything else that belongs to a project (code, tests, docs, prompts, env, deploy config) lives under that project's folder.

Working on a single project

Each project is independent — you can develop it without the rest of the repo. To check out only one project (sparse checkout):

git clone --filter=blob:none --no-checkout <repo-url> claude-code-workshop
cd claude-code-workshop
git sparse-checkout init --cone
git sparse-checkout set week-3/nutrition-app
git checkout

cd week-3/nutrition-app
yarn install            # the project is its own yarn-workspaces root
yarn dev                # follow that project's README for the rest

(Or simply cd week-3/nutrition-app in a full clone — it builds, tests, and runs on its own.)

Shared Claude Code tooling

• .claude/ — workspace settings/permissions available to every project.
• .agents/skills/ + skills-lock.json — agent skills (pinned), reusable across projects.
• CLAUDE.md (this root) — conventions that apply to all projects; each project also has its own CLAUDE.md with project-specific guidance.

Docs

The workshop docs site lives in docs/ and links to each project's own docs (which link back). See CLAUDE.md for shared contributor conventions.