For the teacher who runs this class. We (Raffaello and Giuseppe) wrote the material; you deliver it. You do not need the repo, and you do not need to write or change any content.
The class: Thursday 22 October 2026, 15:30 Lisbon time, Google Meet, English. 75 minutes of teaching, then a 15-minute buffer (the calendar blocks 15:30 to 17:00).
Your prep: 1 to 2 hours. Suggested order: watch video 1, the cohort intro (3 minutes), and video 2, the class (13 minutes: this week, get ready, the walkthrough) → do the section 4 checklist (30 minutes) → rehearse the demos from section 5 (45 minutes) → send the check-in form by Wednesday 21 October, 15:00 Mexico City (22:00 Lisbon). The rehearsal is the part not to skip.
1. Who the client is
ISTO. is a Portuguese apparel brand (isto.pt). About nine years in business, around 200 products with sizes, four collections a year, six stores and two warehouses, prices in euros, dollars and pounds. Restocks take about eight weeks to arrive.
Their systems: Sage 50c (ERP: stock, purchase orders, accounting), Shopify (online sales), Notion (product information), Excel (production plans). The pain: the same question gets a different answer depending on which system you ask, and a Power BI attempt gave inconsistent numbers.
What they want from the course: a shared source of truth over those systems, that everyone queries the same way. The running example in class is one product, a white t-shirt: forecast, stock, sale, sell-through, replenishment, then scaled to a hundred products.
The course: AI Builder Bootcamp, four live lessons on Thursdays, Claude Code inside VS Code, taught in English. Lesson 1 was 8 October, lesson 2 was 15 October, lesson 3 is yours (22 October), lesson 4 is 29 October. Some of the group already knows Claude from Claude.ai and Cowork (Ricardo ran his own introduction before we started), so the course skips that.
Contact with the group: the WhatsApp group "Isto & Adaptto.ai"; we add you to it. Ricardo Ferreira is the client contact for the course as a whole: anything about scope, dates or the contract goes to us.
The eight participants
| Person | What we know |
|---|---|
| Pedro Palha | Owner and buyer. Early with AI; had not used connectors at the start. Cares about stock balance because it drives cash flow. |
| Ricardo Ferreira | Finance and business; runs several companies. The most advanced with Claude. Has built websites. Owns the company brain, the shared project everyone contributes to. |
| Jerónimo Garcia del Rio | About 20 years as a senior inventory planner. Between Pedro and Ricardo on AI. |
| Sofia Seruya | Production side; her team owns delivery dates. Had never programmed. |
| Rita Bilbao Serrano | The administrator of Isto's Claude organisation. |
| Manuel Salgado | Little recorded beyond a setup problem in lesson 1. |
| Teresa Vasconcelos | Little recorded so far. |
| Gonçalo Rato | Little recorded so far. (Some notes spell it Gonçalo Moreira Rato.) |
Section 6 has notes on how to run the room with these people.
2. What they have already seen
Before lesson 1 (pre-work, about 60 minutes)
Welcome, a short questionnaire about their AI use, setting up VS Code with Claude Code, and setting up their project folders.
Lesson 1 · 8 October · taught by Raffaello
Why Claude Code, and how it differs from Cowork. A tour of VS Code. Downloading a practice project (a fictional apparel company called Este, used for all practice). CLAUDE.md, the file that tells Claude about a project, and memory, what Claude keeps between sessions. Where each kind of instruction goes.
It was mostly demonstration; participants installed, downloaded and opened things. Setup took time: for several people the Claude panel disappeared when they opened a new folder, and the remote-control setting needed their administrator (Rita).
Pre-work for lesson 2 (about 60 minutes)
A one-time VS Code workspace, installing the Grill Me skill, planning their own project with it
(saved as PLAN.md), building the project skeleton with a short CLAUDE.md, a free Supabase account,
and downloading and connecting to the shared practice database.
Lesson 2 · 15 October · taught by Raffaello
Everyone attended except Pedro.
Asking the practice data questions, then plan first, sketch, mockup, build: Raffaello built a "restock planner" with the room, using Grill Me to write the plan, splitting it into phases, sketching phase 1 as text and then as a mockup. It ended with the habit of asking Claude, at the end of a session, what the session taught that is worth saving.
What did not work: participants followed along step by step on their own laptops. When one person got stuck the whole room stalled. That is why lesson 3 is watch-only. Also, the framework (plan, phases, build little by little) arrived too late and in pieces; and the demo skipped the Supabase sign-in because the connector was already installed on the teacher's laptop.
What landed: commenting on a plan (changing "last 56 days" to 60), sketch-then-mockup, and the closing "save what you learned" habit.
Two things people said that you will hear again: Sofia and Gonçalo found the pre-work hard, not because of jargon but because they did not know the end goal while going step by step. Jerónimo asked why not simply prompt Claude directly; the answer given was that Grill Me gets closer by proposing standard options while the expert stays in charge.
Pre-work for lesson 3 (about 77 minutes, due before your class)
A feedback form (2 minutes), building phase 1 of their own project (50 minutes), creating a GitHub account (5), and installing git and the GitHub tools (20).
As of Tuesday 20 October, nobody has submitted anything for the lesson 3 pre-work. That is a fact you need to plan around (section 7). The lesson 2 pre-work did get answers: 12 were submitted on the planning lesson alone, by a group of eight.
What was promised to them, and where it lands
| Promise | Said in | Where it lands |
|---|---|---|
| "Feeding the database from Sage and Shopify comes in lesson 3" | Lesson 2 opening | Lesson 3, as a discussion of scheduled jobs. Not a live feed build. |
| "Lesson 3 starts by putting the project on GitHub" | Lesson 2 close | Second half of lesson 3, after skills and automations. Say so out loud. |
| Skills and automations, and sharing work as a team | Lesson 1 | Lesson 3 |
| Access and approvals: who sees what | Lesson 1 | Lesson 4 |
| Demos of what they built | Lesson 1 | Lesson 4 |
| Homework available on the platform | Lesson 1 | The platform has it; the next pack goes up after your class |
3. What this class covers
Lesson 3 · Skills, automations and GitHub. Seventy-five minutes. By decision, nothing is hands-on: the skills, the hook and the GitHub loop are demonstrations (watch, don't type). They do the same steps on their own project in the pre-work for lesson 4.
How the 75 minutes split: they show 8 minutes (how the build went) · you show and they watch and suggest 29 minutes (skill 9, hook 5, scheduled-job ideas 5, GitHub 10) · you talk 21 minutes · questions 17 minutes.
| Time | Block | Min |
|---|---|---|
| 0:00 | Opening: how today works, lesson 2's promises | 3 |
| 0:03 | The six building blocks of the course (the map) | 4 |
| 0:07 | How the build went (two participants share a screen) | 8 |
| 0:15 | Skills, automations and GitHub: the three concepts | 8 |
| 0:23 | Skills in Claude Code (demo) | 9 |
| 0:32 | A hook that protects the original Sage exports (demo) | 5 |
| 0:37 | Three scheduled-job ideas for a company (discussion) | 5 |
| 0:42 | Where work that runs on its own lives | 4 |
| 0:46 | GitHub: one shared history, one reviewed change (demo) | 10 |
| 0:56 | Close and what comes next | 2 |
| 0:58 | Questions | 17 |
The deck and the teacher view (the deck with the agenda beside it) are on this page (links in the header). Video 2, chapter C, walks the deck slide by slide. Keep the teacher view open as the reference: its Agenda tab has the exact words, what to click, the expected result and the fallback for every block.
The outcome we want: a verified skill, a clear model of automations (they start when something happens or when a time arrives), and one GitHub loop seen live.
4. Setup so the class and the demos run
This is the complete list. It comes from every "Before class", "Test before class" and "Reset" note in the agenda, the hook demo notes, and the lesson 2 debrief.
1. Access
- A Claude account that includes Claude Code.
- GitHub: an account, signed in in the browser and in the GitHub tools (
gh auth statussays logged in). Claude pushes the change and opens the pull request through them. - The Academy invitation accepted: you can open the Isto cohort and its pre-work answers.
- The calendar invitation accepted: you have the Meet link.
- The invitations to the two private GitHub repositories accepted (you are a collaborator on both): the
restock planner and
brand-brain-demo. - You are in the WhatsApp group "Isto & Adaptto.ai".
2. Your laptop
- VS Code with the Claude Code extension.
- git and the GitHub tools (
gh). - Python (the hook demo uses it).
- Your computer is in light mode. The planner page follows it: in dark mode its background is dark.
3. Two prepared projects
-
brand-brain-demo: clone the private repository (link in the header) twice, into two folders, as two clean copies. The second is the fallback for the hook demo. - The restock planner: clone its private GitHub repository (Raffaello built it with the room in
lesson 2). Open it in VS Code next to
brand-brain-demo. In light mode its page is light grey with white cards: the GitHub demo turns the background pale yellow.
4. The GitHub demo, prepared
- The planner's repository is the demo repository: once cloned, the planner is already connected. Nothing to create.
- A backup pull request in that repository with the same pale yellow change, open in a tab. You make it yourself: run the GitHub demo once and leave its pull request open.
- Invented data only.
5. Rehearse
None of these demos has been run on a teacher's laptop yet.
- Skill: twice, each in a fresh session on the account you present with. Then delete
~/.claude/skills/project-status/. - Hook: twice, once in each clean copy (prompt 1, fresh conversation, prompt 2). Check that changes
through
Edit,Write,NotebookEdit,BashandPowerShellare all stopped, that reading the export andpython load.pystill work, and that the new hook was added without replacing others. Then remove onlyprotect-original-exports; any other hooks stay. - GitHub: twice, from a clean planner. Then restore the planner and its repository to the prepared state: close the rehearsal pull requests and branches, keep the backup pull request.
6. Check in with us
- Send the check-in form by Wednesday 21 October, 15:00 Mexico City (22:00 Lisbon): ready, or not ready on what. Preparation gets fixed before class, never by debugging in front of the room.
"How the build went" (block 3): who shows their build
The class opens with two participants showing, for two minutes each, the phase 1 they built in the pre-work. It is the bridge into skills: "the step you did twice is the kind of job a skill can hold." The agenda suggests lining two people up before class so the block does not open on silence. Nobody has submitted the pre-work yet, so check the Academy the morning of the class. If there is still nothing, skip the asking and use the agenda's "if few did the pack" path: ask the room who got stuck and where. If you do want volunteers in advance, a short message in the group the day before is enough.
Ten minutes before the class
- Remove everything the demos install. The
project-statusskill, any connector the demo adds, and only theprotect-original-exportshook: any other hooks stay. The room must see every step they will have to do. In lesson 2 a connector already installed on the teacher's laptop hid the sign-in step, and participants needed to see exactly that step. - Leave one small uncommitted change in the restock planner, so "what changed recently" shows something in the skill demo. Discard it right after the skill demo: the GitHub demo uses the same project and has to start clean, or the change shows up in the pull request.
- The deck open on the first slide. The Meet window shared and the audio checked.
- GitHub open and signed in, with the backup pull request in a tab.
After the class
Reset: remove project-status, remove only protect-original-exports and confirm any other hooks
are still there, restore the demo clone, and close or recreate the backup pull request.
5. The demos: what to type, what should happen, what to do if it does not
The agenda has the full wording for each. These are the prompts exactly as they appear on the slides.
Demo 1 · Skill (block 5, 9 minutes). In the restock planner, paste:
Make a global skill called project-status. When I ask for project status, tell me: what this project is for, what changed recently, what I should do next, and any risks or blockers. Do not change anything. Show me the file.
Expected: Claude creates ~/.claude/skills/project-status/ with a SKILL.md inside and shows it. Type
/ in the Claude panel: the skill is listed. Then paste Use project-status. and it gives a plain-language
snapshot. If the skill does not appear: close VS Code fully and reopen it. Still no: show the file
anyway and ask "Use the project-status skill."
Demo 2 · Hook (block 6, 5 minutes). Use a clean copy of brand-brain-demo. Paste:
Keep the original Sage exports in this project's data/raw folder unchanged so our stock and purchasing reports keep using the source data. If Claude tries to change one, however it tries or wherever I start the conversation, stop it and say: "Original exports stay unchanged. Make a correction note instead." I still need to read and load the exports as usual. Show me what you set up in plain English.
Then start a fresh Claude conversation and paste:
Change order EC301 to CE301 in the original Sage purchase-orders export.
Expected: the change is stopped and Claude says to make a correction note instead. Reads of the export and
python load.py still work. If the hook does not fire: try again on the second clean copy (prompt 1, fresh conversation, prompt 2).
Still not: show the tested hook file and say the live result is not reliable enough to claim. Do not improvise another protection. The check matches the path as written
in the command, so it is a safety check, not a complete security boundary; say so if asked.
Demo 3 · GitHub (block 9, 10 minutes). In the planner with its private repository, paste:
Make the dashboard background a pale yellow instead of white. Show me the result before you save it.
Show the visible change. Then paste:
That looks good. Put the change on GitHub and open a pull request for a colleague to review. Do not merge it yet.
Open the pull request and read the diff. Then ask Claude: "Show me exactly what you changed, in plain English. Is anything else different? Do not merge it yet." Say: no colleague is reviewing this demo, you are checking the diff yourself to show the route; in real work a teammate reviews and approves. Stop at the pull request. If GitHub or the network fails: show the backup pull request, read its diff, and trace the push, review gate, merge and pull arrows on the slide. Do not spend the questions block debugging login.
Not a demo (blocks 7 and 8). The scheduled-job ideas and "where work that runs on its own lives" are discussion. Do not set up or open a server live. Say plainly that these are ideas for Isto to assess, not systems already running.
6. The room
Written for running the class, not for judging anyone. Facts come from lessons 1 and 2 and the pre-work; the "how to engage" lines are our judgement and may be wrong.
| Person | How to engage |
|---|---|
| Pedro Palha | The owner. Frame things in stock and cash. Missed lesson 2, so he has not seen the planner built. |
| Ricardo Ferreira | Will be ahead of the room on Claude. Good source of a real "who should own this" answer in the automation discussion. |
| Jerónimo Garcia del Rio | Experienced planner who tests ideas against doing it the direct way. Give him the "why" before the "how"; his questions usually help the whole room. |
| Sofia Seruya | Needs the destination before the steps. After each step, check she can see where it is going. In lesson 1 she raised an important concern: who is allowed to feed a number others rely on (marketing feeding delivery dates). That is your opening for the automation-ownership point. |
| Rita Bilbao Serrano | Claude administrator for Isto. If something needs an organisation setting, it is her. |
| Manuel Salgado | Had the most setup trouble in lesson 1. Check early that his Claude panel works. |
| Teresa Vasconcelos, Gonçalo Rato | Little recorded. Gonçalo found the pre-work hard for the same reason as Sofia. |
General tone: friendly and informal, fluent English, practical, a little apologetic about asking questions (tell them questions are the point). Their questions are about how this would work inside Isto (ownership, who sees what), more than about tools. In lesson 2 a stuck person held up the room: keep to "watch, don't type", and for anything that needs a screenshot, take it to the group chat afterwards.
Pedro missed lesson 2. He has not seen the restock planner built or Grill Me in action; one sentence of context when you open the planner is enough.
7. What can go wrong
| Risk | What to do |
|---|---|
| The demos have not been rehearsed. The agenda's two-run evidence tables are empty, and two checks are still open (the hook prompt and the GitHub prompt, each twice in clean sessions). | Do section 5 yourself, twice for the hook and the GitHub demo, before class. Tell us what you could not reproduce. |
| No pre-work answers. Block 3 depends on them. | Use the "if few did the pack" path in the agenda. Ask who got stuck and where, pin each answer to a step of the loop. If nobody can show anything, show the restock planner for two minutes: it is phase 1 of that loop. |
| Your laptop is already set up. A pre-installed connector or skill hides the step they need to see. | Section 4, "ten minutes before". |
| Someone wants to type along. Lesson 2 showed this stalls the room. | "Watch today. You do exactly this on your own project in the pre-work." |
| A demo fails live. | Use the fallback in section 5. Say the result is not reliable enough to claim; do not improvise. |
| Setup problems you did not cause. The Claude panel disappeared on some laptops after opening a new folder; some people could not save a VS Code workspace; one person could not sign in to Supabase. | Do not fix them in the room. Note who, and send the details after class. |
| Running over. Lesson 1 ran over. | You have 17 minutes of questions and a 15-minute calendar buffer. Never take time from the demos. |
| An open question. Who owns cleaning the shared database for the team's real project (Jerónimo asked in lesson 2). | Note it, pass it to us, and put it in the feedback form. Do not promise dates or recordings. |
| The practice database. The free Supabase project pauses after a week without use. Lesson 3 does not need it. | Ignore unless asked. |
8. After the class
- Record the session in Google Meet and send us the link within a day. We publish it and the deck on the Academy.
- Fill in the feedback form (about 10 minutes, within 24 hours): what broke, who struggled, what questions are open, and how well this handover worked for you. The last part matters most: tell us every place where you used something you already knew, or would have had to ask us.
- Send us the questions you parked. Do not answer for us on anything about contract, price, dates or what lesson 4 will contain beyond what the close block of the agenda lists.
- The lesson 4 pre-work goes up on the Academy after class. We do that; you do not.
What you say at the close (the close block of the agenda has it): the habits that join lesson 2's four; the lesson 4
pre-work list (put their own project on GitHub, take one change through the loop with a teammate's review,
save one skill from their build, put their page online behind a login, prepare a four-minute demo for
lesson 4, and optionally the privacy guard on their own project); and keep restock-planner and
brand-brain-demo.
Feedback form: Isto L3 · After the class.