Clinical Education

Vibe Coding
for Clinicians

Build your own clinical tools by directing the machine — no coding required. Evidence-based. Clinician-designed.

0 of 10 modules complete
Hands-on Course

Build your own clinical tools —
by directing the machine.

Vibe coding means building software by describing what you want in plain language and letting an AI write the code. You bring the clinical intent; the machine handles the syntax. This course takes you from the why, through the rules that keep it safe, to a real tool you build and publish yourself.

What it is, and why it matters to you

Because the name sounds casual, some prefer to call the disciplined, professional version “agentic engineering” — you set the goal and the guardrails, an AI agent does the building — but the idea is the same: you direct, the machine executes, and you stay responsible for the result.

The hard part of a clinical tool was never the insight. It was the cost of turning insight into working software, and that cost has collapsed. You see a patient perhaps an hour across an entire year; for the thousands of hours in between, they manage alone, often asking a general chatbot with no clinical framing and no one checking the answer. A tool you build puts your judgment, your thresholds, and your cautions into that gap. You already supply intent and parameters every time you write an order. This is the same skill, pointed at software.

Curious how complicated it is under the hood?

This entire course was built by “vibe coding” it — no code typed by hand. Open the Code tab to see the actual source behind this page: hundreds of lines the machine wrote.

About This Course

Ten short modules take you from the mindset, through the toolbox and the privacy and regulatory lines, to a hands-on build: you set up a builder, make and publish a real tool, and learn to keep it safe over time. The course is designed for physicians, residents, nurses, certified nurse-midwives, and advanced practice providers. No prior technical background is assumed. It concludes with a 10-question assessment; a score of 70% or above earns a certificate of completion.

10
Modules
70%
Passing Score
🎉
Certificate
~60
Minutes
Ready to begin?
Start with Module 1: Why This Matters
1

Why This Matters

The shift, and why it lands on you
Clinical judgmentWhy this lands nowYou already do this

“Tools will come and tools will go. Only the vibe coder remains.” Rick Rubin said it about software. The producer’s value was never the instrument. It was knowing what good sounds like and steering toward it. For a clinician, that ear is clinical judgment, and judgment is the one thing the machine cannot supply.

Rubin made that line go viral, then turned it into a short book that reimagined the three-thousand-year-old Tao Te Ching for the age of code.1 Underneath the joke is a serious claim. The tool in front of you keeps changing. The taste that directs it does not. That is the part that lasts, and it is the part you already own.

What vibe coding actually is

Vibe coding means building software by describing what you want in plain language and letting an AI write the code. Andrej Karpathy named it in February 2025, describing a way of working where you stay focused on the outcome and let the model handle the code itself.2 You do not memorize syntax. You see something, say something, run it, fix it. Within a single year the practice spread far enough that Collins Dictionary made it the Word of the Year for 20253, and technology leaders started saying the new programming language is human.5 The name itself is still being argued over. Because “vibe coding” sounds casual, some practitioners prefer “agentic engineering” for the disciplined, professional version, where you set the goal and the guardrails and an AI agent does the building. Whatever you call it, the habit underneath is the same: you direct, the machine executes, and you stay responsible for the result.

A generation ago, a single misplaced character could halt an entire program and take an experienced engineer to find. That barrier is gone. The skill that matters now is not typing code. It is knowing what the tool should do and judging whether it does it.

Why this lands on clinicians now

For decades the software clinicians use was built by a small number of large vendors. Two of them account for roughly two-thirds of the acute care hospital electronic record market.11 Custom tools were out of reach for most clinicians, who fell back on paper handouts to guide patients between visits.9 The limiting factor was never clinical insight. It was the cost of turning insight into working software, and that cost has collapsed. What remains is the ability to define a problem, identify the relevant data, and decide what action should follow. That is what clinicians do every day.

Look at the arithmetic of a chronic condition. You see a patient four times a year for fifteen minutes. That is about one hour of clinical contact across an entire year. For the other thousands of hours, the patient manages the condition alone, with paper and memory. Patients are already filling that gap with whatever is nearest. More than 230 million people ask health and wellness questions on one AI platform every week, usually with no clinical framing and no one checking the answer.6 A tool you build puts your judgment into that gap, with your thresholds and your cautions, instead of leaving it to a general chatbot.

You are already a vibe coder

You write an order: ceftriaxone one gram intravenously, once daily. You do not synthesize the drug or place the line. You supply the intent and the parameters, and the nurse and the pharmacist carry it out. AI coding tools are the same kind of help. You bring the clinical intent. They handle the execution. The better you state the intent, the better the result, which is the whole subject of the next module.

I have built more than 100 clinical tools this way, all by directing AI rather than writing code by hand. None of it required learning a programming language. If I can do it, the resident who grew up with a phone in her hand certainly can.

2

The Mindset Comes Before the Tools

You are the product lead, not the coder
Product-lead mindsetThe five-step loopBuild in slices

Software used to move through a team. Someone defined what to build and why. Someone designed how it should feel. Developers wrote it. Testers decided whether it worked. Each role brought a different kind of judgment, which is powerful, but every change waited on a handoff, which is slow.10 Vibe coding compresses that loop. You move through more of it yourself: define the goal, generate a first version, test it, give feedback, improve it.

Your role is closest to the product lead. You bring the goal, the audience, the taste, the constraints, the feedback, and the decision about what ships. The machine turns ideas into working software, makes changes, explains its behavior, and debugs. The better you lead, the better it builds.10

The five-step loop

One principle sets direction. The next four repeat as a loop until the tool is good enough.

  1. Start with the goal. Describe the outcome before the task. Who is this for, what should they be able to do, what would make it useful. Not “build a calculator,” but “help a patient with high blood pressure know when a home reading should prompt a call to the office.” You do not need to know the technical steps. Start with what should be true when it works.
  2. Build in small slices. A slice is a piece small enough to try. Ask for the whole product at once and you cannot review it. Ask for one screen and you can open it, click through it, and decide what to add next.
  3. Manage context. Context is the information the model uses to understand you: who it is for, what to include now, what to leave alone. Stay in one conversation while you build one feature. When the conversation gets noisy or you switch features, start fresh with a short summary of what matters.10
  4. Review and test. The machine can build, but you decide whether it works. Open the tool and use it as the patient would. Did anything that should have stayed the same break.
  5. Improve with feedback. The first version is a draft. Tell the machine what to keep, what to change, and what to leave untouched. When a change goes too far, narrow the scope and restore what worked.
Three habits that make the loop work

Communicate clearly. Clinicians are trained to be brief. We compress thousands of data points into a one-line note. The machine cannot read that compression, and it cannot read your intuition. State plainly what you want and why. “Make it better” tells the machine nothing. Compare a real instruction:

VagueFix the form.
ClearImprove the spacing and labels on the readings form so an older patient can scan it quickly. Keep the same input fields. Do not change the results section above it.

Think in systems. Ask how each part connects, the way you map a disease from cause to presentation to plan. Systems thinking keeps a tool lean. It tells you when a simple dropdown menu beats a language model. If a field has five fixed options, a dropdown is faster, cheaper, and more reliable than asking a model to interpret free text every time. The goal is utility, not cleverness.

Iterate. The first answer is rarely the final one. When the machine gets it wrong, push back. Ask the second and the third question. Refining the prompt is also how you learn to speak the language of the machine, and that skill compounds across every later tool.

Note

What good vibe coding feels like. You can explain the goal in plain language. Each change is small enough to review. You know what to test after the machine builds. You give context instead of assuming the model knows. You tell it what to preserve, not only what to change. The tool becomes more useful after each round.10

3

Your Toolbox, Organized by the Job

Pick the tool by the task, not by habit
Match tool to jobBrowser-only by defaultWhen not to use AI

The product names will change. The categories are stable, so learn the categories. The art is choosing the simplest tool that does the job.

JobToolsUse it for
Thinking and sketchingChatGPT, Claude, GeminiBrainstorming, drafting the spec, testing the logic
BuildingClaude Code, Replit, Google AI StudioTurning the idea into a working app
Grounding and researchDeep research tools, NotebookLMPulling exact formulas, guidelines, and citations
Reasoning and reviewA strong reasoning modelChecking complex clinical logic before you build
Design and mediaFigma, Framer, image and video generatorsLook and feel, diagrams, patient education assets
Thinking and sketching

The chat models are your scratch pad. Low stakes. Open one, describe an idea, see if the logic holds, start fresh if it does not. ChatGPT is a reliable generalist. Claude tends to reason through a clinical pathway carefully before it writes anything. Gemini handles very large inputs well, which helps when you paste an entire guideline. Use them to brainstorm and to draft the specification you will hand to a builder.

Building

Claude Code lets you describe what you want in plain English and writes the code for you. You set it up once and then talk to it. Replit is a browser alternative that handles hosting and the database in the background. Google AI Studio offers scale and control, though you host the result elsewhere. The next two modules use Claude Code for a hands-on build; the steps are the same in any of them.

Grounding and research

Before you trust a tool’s medical logic, ground it in real evidence. Deep research tools read across many sources, aggregate them, and check facts. NotebookLM answers only from the documents you give it: your protocols, your guidelines, your notes. It stays anchored to your library instead of inventing facts. For a clinical number, grounding is how you keep a fabricated figure out of the tool.

Reasoning and review

Before you build anything with branching logic, have a strong reasoning model check the plan. Hand it the if-then rules and the thresholds and ask where the logic breaks, what edge cases are missing, and where a value could produce an unsafe output. It is cheaper to fix a flaw in the plan than in the built tool.

Design and media

Figma and Framer let you sketch the look and feel before you build. Image generators produce diagrams and patient education art, and the better ones place text inside an image correctly, so a labeled diagram comes out labeled. Video tools generate short clips for patient education. All of these connect to the builders.

Note

Choose the simplest tool that works. Reach for a language model when judgment or open text is genuinely needed. Reach for a dropdown, a checkbox, or a fixed calculation when the answer is bounded. More AI is not more value. The right tool for the task is the value.

4

The Line You Do Not Cross: Patient Data and the Law

Two lines: privacy, and the device line
PHI & HIPAAThe FDA device linePrivacy by design

Learn the rules before you build. Most consumer AI tools are not compliant for protected health information.

ZoneToolsThe rule
Red (not compliant)Standard ChatGPT, Claude, Gemini, and personal builder plansNever enter a real name, date of birth, or medical record number. Use a fictional patient and synthetic data only.
Green (can be compliant)A model running entirely on your own machine; enterprise cloud under a signed Business Associate AgreementData stays on your hardware, or is covered by a signed agreement. Confirm before you deploy.
Note

A signed agreement is necessary, not sufficient. A Business Associate Agreement, or running a model locally, is one piece of HIPAA, not all of it. The privacy rule governs what you may use and disclose. The security rule requires administrative, physical, and technical safeguards, including encryption and access controls. Breach notification rules apply when something goes wrong. Data on your own device still needs encryption and access control. Confirm with your compliance office before any tool touches protected health information.

The second line: when a tool becomes a regulated device

A tool that gives a clinical recommendation can be a regulated medical device. The 21st Century Cures Act, as the FDA explains in its 2026 guidance, excludes certain clinical decision support software from the device definition only when it meets four criteria.8 In plain terms:

  1. It does not analyze a medical image or a signal from a monitor or device.
  2. It displays or analyzes medical information about a patient.
  3. It supports or offers recommendations to a clinician about prevention, diagnosis, or treatment.
  4. It lets the clinician independently review the basis for the recommendation, so the clinician does not rely primarily on the software.

The fourth criterion does the work. A tool that is clinician-facing, transparent, and advisory, where you remain the decision-maker and can see why it said what it said, sits in the safer non-device lane. A tool that is opaque, directive, or built for a patient to rely on without a clinician is far more likely to be regulated as a device. To support independent review, the guidance suggests the tool state its intended use, the patient population, the required inputs, and a plain-language description of how it was developed and validated.8

So building a tool is not the same as being allowed to deploy it on patients. The cleanest path is to design the privacy question away. A tool that runs entirely in the browser and stores nothing enters no name, transmits no data, and keeps nothing. Privacy is not a setting you switch on. It is the design.

5

The Build Loop: Worked Examples

From idea to working tool, three ways
The build loopWorked examplesIf-then logic

Take a common problem. A patient with high blood pressure sees you every three or four months. You adjust treatment from a snapshot taken in the office. What happens in between is invisible.9 A simple tool can extend your judgment into that gap. Here is the loop on it, with a fictional patient throughout.

Worked example one: a between-visits blood pressure check-in
  1. Define it. The patient enters two home readings a day from an automated monitor. The tool is educational and routes to you. It does not diagnose and it does not change medications.
  2. Ground it. Pull the thresholds from the source and confirm them. The 2017 ACC/AHA guideline, reaffirmed in 2025, sets a target under 130/80, and flags a reading at or above 180/120 as markedly elevated.7 Every number traces to that guideline.
  3. Build it. Hand the builder your specification and your verified numbers, with clear if-then logic. If the seven-day average sits under 130/80, reassure and reinforce diet, activity, and adherence; if readings trend upward over several days, prompt a review and a message to the office; if any single reading reaches 180/120, advise contacting the office or urgent care now.
  4. Verify it. Enter test values you already know: a normal week, a creeping trend, a single severe reading. Confirm the tool shows its reasoning, cites the source, and never diagnoses or adjusts a dose.
  5. Refine it. Raise the contrast and the button size for older eyes. Translate the output into language a patient can read.
  6. Ship it. Publish it, or run it locally when privacy demands.
Note

Why this works, and where the value sits. Self-measured monitoring on its own barely moves blood pressure. Paired with structured support and follow-up, it lowers systolic pressure by up to about 6 mmHg at a year.12 The readings are not the product. The structure and judgment you wrap around them are. That is the whole argument of this course in one number.

Two more the same way

Pre-procedure preparation. Procedures get delayed when patients misunderstand instructions about fasting, which medications to hold, and which labs to complete.9 Build an interactive guide that walks a patient through the steps for their specific procedure and lets them ask clarifying questions.

Post-operative check-in. After surgery, patients get a printout of warning signs and often hesitate to call.9 Build a tool where the patient answers a few standardized questions each day, and the tool routes a normal pattern to reassurance and a concerning pattern to a prompt to contact the surgical team, on criteria you set.

Note

Four rules for the clinical logic. Focus on one problem. Decide exactly what data to collect and how often. Define the interpretation as clear if-then rules, the way you would train a medical assistant. Refine over time, which is fast and cheap with vibe coding.9

That is the loop. The next two modules put it into your hands: you set up the workshop, then build and publish a real tool.

6

The Rules That Keep It Safe

Discipline is the difference between a tool and a hazard
Source every numberVerify by handNo black box

The thing that makes a clinician safe at this is the same thing that makes it dangerous in untrained hands: judgment about what the numbers mean. A layperson who builds a risk tool does not know the threshold is wrong. You do. Lowering the barrier to building also lowers the barrier to deploying unsafe logic without oversight, so the discipline matters more, not less. Hold yourself to four rules.

  1. Every number traces to a published source. No invented thresholds, no remembered figures. The failure mode is a model that confidently supplies a plausible but wrong cutoff, which is why you ground the numbers before you build.
  2. You check the math by hand before anything goes live. Build a small set of test cases with known answers and run the tool against every one. A normal result, a borderline result, a severe result, a missing value. If any case comes back wrong, the tool is not ready.
  3. The tool shows its reasoning. No black box. It displays how it reached its result and cites the evidence on screen. The failure mode is a number with no visible source, which a frightened patient cannot question and you cannot defend.
  4. It stores no patient data. A tool that runs in the browser and saves nothing cannot leak what it never held.
Note

Rule three is also the law. The FDA dividing line for non-device clinical decision support is whether the clinician can independently review the basis for a recommendation rather than relying on the software primarily.8 The guidance suggests stating the intended use, the patient population, the required inputs, and how the tool was developed and validated. A transparent tool can sit in the non-device lane. An opaque one is more likely to be a regulated device.

A pre-flight checklist

Before any tool reaches a patient, confirm: every number traces to a cited source; the test cases pass; the reasoning is visible on screen; nothing is stored; the tool refuses to act outside its scope; and your compliance office has signed off if it will touch protected health information.

None of these are coding decisions. They are medical ones, and only you can make them. The answer to the real risk of unsafe tools is not to avoid building. It is to build with the same evidentiary discipline you bring to everything else in medicine.

7

From Skill to Practice

Build, or be built for
The durable skillLead, don't sit outJudgment over syntax

The tool you learn today will be replaced within a year or two. Karpathy, who coined the term, already calls vibe coding passe and renames the professional version agentic engineering.4 The label keeps changing. The brand of AI keeps changing. The durable skill does not. It is knowing what good looks like and directing the machine toward it. For a clinician, that is simply clinical judgment pointed at a new instrument.

There is a professional stake here too. If clinicians build these tools, the tools carry clinical judgment and answer to the patient. If clinicians sit it out, the future is shaped by vendors and insurers whose incentives are not always the patient’s.9 The same low barrier that lets you build also lets others build badly. Leading is the safer path, not the riskier one.

I am not telling you to become a programmer. The opposite. The era of the clinician as the person who memorizes ten thousand facts is ending, because the machine remembers better than any of us. What it cannot do is care for the patient in front of you, or decide what a number should mean for her. That is yours.

Rubin reimagined the Tao for the age of code. I will borrow from a source he would appreciate, Marcus Aurelius: the impediment to action advances action; what stands in the way becomes the way. For clinicians, the tool was never the obstacle. The translation was, the long gap between knowing what a patient needed and getting software that delivered it. That gap is gone. The next three modules close the remaining one, from understanding to doing.

8

Set Up Your Workshop

Hands on, part one of three
Set up the workshopPermission modesThe starter prompt

The first seven modules built judgment. The next three put it to work. By the end you will have set up a builder, made a real tool, published it, and learned how to make the second one faster. Start here, with what vibe coding is honestly good for and how to get the tools ready.

What it is genuinely good for

Two uses earn their keep. The first is a clickable mockup you hand to a developer or designer so they stop guessing what you meant; they can feel the vision instead of reading a paragraph about it. The second is a small working tool that does one job better than a plain chatbot would, for you, your team, or a few patients, where rough edges are fine because the audience is small. Vibe coding is not a path to riches, and grand promises about it are usually fiction. It is a way to turn an idea into something real, fast.

Note

One rule that saves your time. Do not spend longer building a tool than you will ever save by using it. Building for hours something you will never open again is performative. Reach for a builder only when the tool earns the time.

Setting up Claude Code

Claude Code lets you describe what you want in plain English and writes the code for you, so you never touch a line of it. Setup is a one-time job. Check the current steps and pricing in the documentation, since both change.15

  1. Get the app. Install the Claude desktop app and open the Code tab. You will need a paid plan.
  2. Make a clean folder. Create one empty folder on your computer, just for this. No passwords, no private files, nothing you would hate to lose, and never any real patient data. Claude only touches this folder.
  3. Reduce interruptions, safely. By default Claude asks before each edit, which means many clicks per session. Use Auto mode, a safer middle ground that lets routine edits run while flagging risky actions, rather than turning every check off. Reserve full bypass for an isolated folder, and at a company, ask IT first.15
  4. Connect your plumbing. Add a hosting connector, such as Netlify, so a finished tool can go live with a link. Add a data connector, such as Supabase, only for the day you genuinely need accounts or saved data.
  5. Point Claude at your folder, pick the most capable model available (currently Claude Opus 4.8), and you are set.
Caution

The clinical caveat on stored data. Business builders store everything in a cloud database with logins by default. For clinical tools that is exactly where Module 4 bites. A third-party store that holds patient information needs a Business Associate Agreement and compliance sign-off. For most clinical calculators and patient-education tools, the safer default is the one this course keeps returning to: run in the browser, store nothing, no accounts. Reach for a database only when you truly need saved data and you have the compliance piece handled.

When not to open the full builder

A builder is the wrong tool for plenty of jobs. A small widget you will glance at once is faster as an Artifact inside a normal Claude chat. A document or a spreadsheet is a job for Claude Cowork. A single image is quicker in a general image tool. Match the tool to the task.

9

Build Your First Tool

Hands on, part two of three
Your first buildTest casesPublish a link

Stop reading and build one. You will make a real creatinine clearance calculator using the Cockcroft-Gault equation. It is the cleanest first build: four inputs, one verified formula, one citation, and it forces every safety habit at once.13 Use a fictional patient throughout. Never enter real patient data in a consumer builder.

Step 1. Set the working relationship

Open Claude Code and paste an opening prompt that puts you in charge and bakes the safety rules in from the first word.

Opening promptYou are my CTO. I am the clinician and I do not write code. Talk to me in plain English about what I can see, click, or decide. Before building, interview me one question at a time so I can choose my answers, then tell me the plan in a few plain sentences and build it. Build one piece at a time, test each on a phone, and fix what is off before showing me. This is a clinical tool, so without exception: it runs entirely in the browser and stores or sends nothing; every number traces to a source shown on screen; it shows its formula and reasoning; it does not diagnose or recommend a medication change; if an input is outside the validated range it returns nothing rather than a wrong value.
Step 2. Ask for the tool
Build promptBuild a creatinine clearance calculator with the Cockcroft-Gault equation. Inputs: age in years, weight in kilograms, sex, and serum creatinine in mg per dL. Compute CrCl in mL per min as (140 minus age) times weight, divided by (72 times serum creatinine), then multiply by 0.85 if female. Show the result, the formula, and this citation on screen: Cockcroft DW, Gault MH. Nephron. 1976;16:31-41. Add a one-line note that the equation came from a narrow population and current guidance favors race-agnostic eGFR for dosing decisions. Large fonts, clear units, a reset button.
Step 3. Verify it, the step you never skip

Enter a case you can check by hand. A 50-year-old man, 80 kg, serum creatinine 1.0 mg per dL. The formula gives 140 minus 50, which is 90, times 80, which is 7200, divided by 72, which is 100 mL per min. The tool should show 100. Switch sex to female and it should show 85. If the numbers do not match, the tool is wrong. Do not move on until they do.

Step 4. Lock in the guardrails

Confirm the formula, the citation, and the limitation note appear on screen, and that nothing is stored. If any is missing, ask for it by name.

Fix promptShow the Cockcroft-Gault formula and the Nephron 1976 citation on the results screen, add the limitation note, and confirm the tool stores and sends nothing.
Step 5. Refine, then publish

Ask for larger inputs, clear mg per dL labels, and a reset button if it lacks one. Then publish through your hosting connector, get a link, and open it on your phone. That link is a working tool you built.

Caution

Before any real use. This is a teaching build. Re-verify it, clear it with compliance, and remember that current guidance favors race-agnostic eGFR over Cockcroft-Gault for actual dosing decisions.14 The point of this build is the doing. The next module makes the second one faster and better.

10

Make It Yours, Keep It Working, Hand It Off

Hands on, part three of three
IterateMaintainHand it off

You can build one tool. Now build them well, keep them safe over time, and leave with a kit so the next one is faster.

Run the loop well
Make it not look like every other AI tool

The first build often looks generic, because everyone starts the same way. Taste fixes it without touching code. Bring references and be specific: name the font, give the exact colors, ask for more whitespace, and stop saying make it look good. You can also hand the model a design system file, an open format called DESIGN.md that spells out colors, fonts, and spacing. Free libraries such as getdesign.md and designmd.app provide these files for well-known brands; drop one in the folder and tell the model to use it for all styling. For form-heavy tools, asking for a real component library such as shadcn/ui makes buttons and menus look professional, though it uses more tokens.

Keep the cost sane

A builder re-sends the whole conversation and every file it has read, so long sessions add up. Start a fresh chat for each task, point the model at your files instead of pasting big blocks of text, and ask for a plan before any big change so you do not pay for a wrong turn. Watch your usage as you go.

Maintain it

A clinical tool is not done at launch. Date the evidence on screen. When the guideline changes, update the number and the citation, then re-run your test cases. Retire a stale tool rather than leaving a wrong one live.

Hand it off when it gets real

When a tool will serve many people or hold private data, bring in a real developer. Because everything lives in one folder, the handoff is easy. Ask the model to write a HANDOFF.md that states what the tool does and who for, what works and what is rough, the stack and where the pieces live, what a developer needs to know to take over, and the honest note that this is a prototype built by description, not production code. Then send the folder.

Prompt starters you can adapt

Each is one line. Fill the brackets, paste it after the opening prompt from the last module, and react to what it builds. All assume the clinical defaults: clinician-facing, browser-only, cite sources on screen, store nothing.

Tools that need accounts or saved patient data are the exception, not the default. They trigger the privacy rules from Module 4, so reach for them only with compliance handled. Otherwise, no accounts and no storage.

Your takeaway kit

This starter prompt carries the safety rules with it. Copy it, fill the brackets, and your next build begins safe by default.

Starter prompt templateYou are my CTO. I am the clinician, I do not write code and I do not want to read it. Talk to me in plain English about what I can see, click, or decide. Build a single-page web tool that runs entirely in the browser and stores or sends nothing. Purpose: [one clinical task] for [one patient population]. Inputs: [exact inputs with units]. Output: [what it shows], computed only from [name the formula or rule]. Show on screen: the formula or rule, the source citation in Vancouver format, and a one-line note of the main limitation. Rules: do not diagnose or recommend a medication change; if an input is outside the validated range, return nothing rather than a wrong value; cite every number to its source on screen; store, log, and send nothing. Before building, interview me one question at a time so I can choose my answers. Then tell me the plan in a few plain sentences and build it. Build one piece at a time; after each piece, open it yourself, test it on a phone, and fix what is off before showing me. Then publish it and give me a link.

Quick reference card

The five-step loop
  • Start with the goal
  • Build in small slices
  • Manage context
  • Review and test
  • Improve with feedback
The four rules
  • Every number traces to a source
  • Check the math by hand before it goes live
  • Show the reasoning, no black box
  • Store no patient data
The two lines
  • Privacy: red zone tools never see real data; a signed agreement is necessary, not sufficient
  • Device: stay clinician-facing, transparent, and advisory

The second build is faster than the first, because the judgment transfers and the kit comes with you. Pick the next problem you already wish you had a tool for, and build it.

</>

The Code Behind This Page

I described what I wanted in plain English. This is what the machine wrote.

Every screen of this course, the quizzes, the scoring, and the styling were built by “vibe coding.” I never typed this code by hand. I told an AI what I wanted, looked at what it built, and corrected it in plain language until it was right. The point of showing it to you is not that you read it. It is to see how much of it there is, and to realize you did not have to write a single line.

Loading the source…

📚

References & Sources

The published sources this course is built on.
  1. Rubin R, Andreessen M, Horowitz B, Midha A, Torenberg E. Rick Rubin: Vibe Coding is the Punk Rock of Software. a16z Podcast. 2025.
    Origin of the line that anchors the course: the tool is temporary, the judgment endures.
  2. Karpathy A. Post on X introducing the term “vibe coding.” February 2, 2025.
    First naming of building software by describing intent in plain language.
  3. Collins Dictionary. Word of the Year 2025: vibe coding. 2025.
    Marks how widely the practice spread in a single year.
  4. Taft DK. Vibe coding is passe. Karpathy has a new name for the future of software. The New Stack. 2026.
    Evidence that the tools and the labels change fast, which is the point.
  5. Huang J. Remarks on natural-language programming, London Tech Week. 2025.
    The new programming language is human; coding by plain language is now broadly accessible.
  6. OpenAI. Improving health intelligence in ChatGPT. 2026.
    More than 230 million people ask health and wellness questions each week.
  7. Whelton PK, Carey RM, Aronow WS, et al. 2017 ACC/AHA Guideline for the Prevention, Detection, Evaluation, and Management of High Blood Pressure in Adults. Hypertension. 2018;71(6):e13-e115. Target under 130/80; markedly elevated at or above 180/120. Reaffirmed in the 2025 ACC/AHA update.
    Source of the blood pressure thresholds used in the worked example.
  8. US Food and Drug Administration. Clinical Decision Support Software. Guidance for Industry and FDA Staff. January 2026. 21st Century Cures Act, section 520(o).
    The four criteria for non-device clinical decision support, including independent review of the basis for a recommendation.
  9. Pearl R. How vibe coding will reshape medical practice. 2026.
    Perspective on clinician-built tools and the chronic-disease, pre-procedure, and post-operative use cases.
  10. Replit. Vibe coding 101. Replit Documentation.
    The five-step loop and the shift from a team build to a single product lead.
  11. KLAS Research. US Acute Care EHR Market Share 2026.
    Two vendors hold roughly two-thirds of the acute care hospital electronic record market.
  12. McManus RJ, Little P, Stevens R, et al. Self-monitoring of blood pressure in hypertension: a systematic review and individual patient data meta-analysis. PLOS Med. 2017;14(9):e1002389. Up to 6.1 mmHg systolic reduction at 12 months when monitoring is combined with intensive support.
    Why the value of a check-in tool is the support around the readings, not the readings alone.
  13. Cockcroft DW, Gault MH. Prediction of creatinine clearance from serum creatinine. Nephron. 1976;16(1):31-41. doi:10.1159/000180580.
    The formula and worked example built in the hands-on module.
  14. National Kidney Foundation. Cockcroft-Gault equation and the transition to race-agnostic eGFR for medication dosing.
    Why the calculator carries an on-screen limitation note.
  15. Anthropic. Claude Code documentation: setup, permission modes, and usage. docs.claude.com.
    Source for the setup steps, Auto mode, and current models.

Vibe Coding Assessment

10 multiple-choice questions covering the full course. Score ≥70% (7/10) to earn your certificate of completion.

Estimated time: 8–10 minutes

MedicalAICompetence.com
Certificate of Completion
is awarded to
Clinician
Vibe Coding for Clinicians
Build Your Own Clinical Tools with AI
Score: — · Completed —
Amos Grünebaum, MD
Professor of Obstetrics & Gynecology and Maternal-Fetal Medicine
MedicalAICompetence.com · obmd.com