Your builder path
2 / 6 chaptersThis chapter
Step 1 of 7Your next action
Download the starter
Get your starter pack
Download the starter using the link beside this step. It saves to your Downloads folder.
Open for this step
Need a hand?
The starter holds prompts and templates, not a prebuilt app. There is nothing to run yet.
For this step
The starter is a folder of prompts and templates, not a prebuilt app. There is nothing to run yet.
Its files become the memory of your build. The coach writes your brief, architecture, design, blueprint and Work Cards into them, so a new chat session can pick up exactly where the last one stopped.
Do not start building yet
This chapter is setup. Building before the trainer clears you means building on a workspace nobody has checked.
For this step
Extract the ZIP, then rename the extracted folder to your project name in
lowercase with hyphens, such as campus-event-guide. Rename the outer folder
only. Keep START_HERE.md, prompts/, templates/ and work-cards/ exactly
as they are.
A short clear folder name matters because some editors and some Windows notifications shorten it, and you want to recognise your project at a glance.
For this step
Opening the folder, rather than a file, is what lets your AI helper see the
whole project. When it is open correctly the files panel shows START_HERE.md
at the top level, with prompts, templates and work-cards folders under it.
If you only see one file, you opened a file. Use File then Open Folder again. If the editor asks whether you trust the authors, choose yes: it is your folder.
For this step
Cockpit map
Where each part lives
Recognise each part before you download anything. Setup stops feeling like a black screen.
Project folder
Everything lives here
Files panel
Find and open files
Editor
Change one file
Terminal
Run project commands
Browser preview
localhost is private to you
AI helper
Explains and edits with permission
Rule for the whole session: never run a command you cannot explain.
Choose by job
Four kinds of AI helper
They are not competing brands. They see different amounts of your project, so pick by the job in front of you.
AI chat
Sees: Only what you paste
Best for: Planning and explaining
IDE extension
Sees: The open file
Best for: Quick edits in one file
Coding agent
Sees: Project files, with permission
Best for: Multi-file work and commands
Model + context
Sees: Whatever you gave it
Best for: Stronger for hard errors
| Part | Where it is | Shortcut |
|---|---|---|
| Files panel | Left bar, top icon | Ctrl+Shift+E (Mac Cmd+Shift+E) |
| Terminal | Bottom panel | Ctrl+J (Mac Cmd+J) |
| Extensions | Left bar, four squares | Ctrl+Shift+X (Mac Cmd+Shift+X) |
| Command palette | Anywhere | Ctrl+Shift+P (Mac Cmd+Shift+P) |
Your files panel should now show START_HERE.md with the prompts, templates
and work-cards folders under it. That is your whole project.
Now install the helper. Open the extensions panel, search Kilo Code, and
install it. Kilo Code is a coding agent: it can read your project files, write
to them when you allow it, and run commands you approve. That is why this path
uses it rather than a chat website, which only ever sees what you paste.
The terminal is a text box that runs commands on your machine. Because you
opened the folder rather than a file, it starts inside your project, which is
what makes the build commands in a later chapter work. Later, the browser
preview will open at a localhost address only your computer can see.
The one safety rule
Never run a command you cannot explain, and never paste a password, token, API key, or private personal data into an AI tool.
For this step
Run each line in the terminal and press Enter. A version number means the tool is installed. A "not recognised" or "command not found" error means it is not.
node --version
npm --version
git --versionSwipe sideways if a command is long.
Node runs the project, npm installs the packages it needs, Git saves versions of your work. Install only what errored, using the links beside this step, then open a new terminal and run the checks again.
Then tell Git who you are, once, using the name and email you want attached to your work:
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global --listSwipe sideways if a command is long.
If Node or Git will not install
Tell the trainer before the gate. You can stay in the planning chapters, or pair with someone whose machine is ready. A blocked install never costs you the session.
For this step
An editor agent cannot think on its own. It sends your request to a model, and the model needs a key that says who is paying. Registering for today's event is what put a key on your profile.
| Step | Where |
|---|---|
| Copy your key | KD profile, API Key tab |
| Add a custom provider | Kilo Code settings, in your editor |
| Confirm it works | Ask Kilo Code any short question |
The trainer runs this one
Provider fields differ by model. Wait for the walkthrough rather than guessing, and raise your hand if your key is missing.
Treat the key like a password
Never paste it into the chat, a screenshot, a slide, or a project file. If it ends up in a file you commit, it is public even after you delete it.
Not at a KD event? Use your own provider key here instead, or skip Kilo Code and use a coding helper you already pay for. Everything after this chapter works the same way as long as your helper can read your project folder and run commands.
For this step
Open your AI helper and paste this exactly:
Read START_HERE.md and prompts/00-run-kdbm-lite-coach.md.
Run the KDBM Lite Coach exactly as instructed.
Planning phase only:
- create or update markdown planning files only
- do not create app code yet
- do not install packages yet
- do not edit project source files yet
Start with the Setup Gate.
Ask me one question at a time.Trainer checkpoint: stop here
Raise your hand when the coach reports its Setup Gate result.
| Check | Pass looks like | If it fails |
|---|---|---|
| Folder open | Files panel shows START_HERE.md and prompts | Reopen the whole folder |
| File access | Coach can read START_HERE.md | Allow file access in the helper |
| Terminal | Coach can run a version command | Open a new terminal, recheck Node |
| Git identity | Your name and email are set | Set them again in the terminal |
Never share a password, token or key with the coach, even if a setup question seems to ask for one.
Before you move on
Common mistakes
- Opening a single file instead of the whole folder.
- Renaming files inside the starter instead of the outer folder.
- Installing Node or Git without checking whether they are already there.
- Running the version checks in an old terminal opened before you installed.
- Starting to build while waiting for the trainer.
- Pasting the boot prompt into a chat website that cannot see your folder.
- Sharing a password or key because a setup question seemed to ask for one.
Work through one step at a time. Ticking a step marks it for this page view only, so nothing is saved when you leave.