Back to PHACT resourcesPrint or save as PDF with your browser

PHACT / Beginner guide

Build one useful tool.

Vibe coding means describing a digital tool in plain language and using an AI coding assistant to help create it. Start with a real teaching problem, make a small prototype, and use your judgment to test and improve it.

Choose a useful first project

Look for a recurring barrier: a representation students struggle to interpret, confusing instructions, or a way to organize evidence without supplying the reasoning. A first version should do one job and work without connecting to district systems.

For teacher-facing work, an evidence organizer or resource hub can also be a useful starting point. Avoid identifiable student information and leave interpretation and professional decisions with the educator.

Plan with PHACT

P / Purpose: What should students understand or be able to do? Name one barrier and the evidence that would show progress.

H / Human anchor: What does the teacher know about this class? What must students think through themselves? Make those responsibilities explicit.

A / Audience: Consider prior knowledge, language, reading, communication, access needs, and available devices. Build supports that everyone can use.

C / Components: Choose the smallest set of controls, representations, and interactions that supports the goal.

T / Tone & constraints: Specify clear language, accessible presentation, expected behavior, and limits on data and answers.

Build, test, and improve

  1. Write your brief and supply verified content and examples.
  2. Ask your school-approved AI coding tool for the smallest useful prototype.
  3. Test realistic scenarios using fictional or non-identifying information.
  4. Notice what is confusing, inaccurate, inaccessible, or unnecessary.
  5. Request one focused improvement, then check both the fix and the original behavior.
  6. Save versions so you can return to a working copy.

Follow-up prompts you can adapt

Keep the human responsibilities visible

The teacher selects content, checks accuracy, interprets evidence, and chooses next steps. Students predict, reason, and explain. An organizer may arrange ideas; it should not silently decide whether reasoning is adequate.

Separate building from classroom use

The teacher can build with AI and share a finished static resource. Students do not need to prompt AI. For a first build, use no student accounts, identifying information, stored responses, or live AI calls.

Inspect what the tool actually does, including any external requests. Check school technology, privacy, accessibility, and procurement requirements before broader use.

Try it in a lesson, then examine the learning

Ask students to explain or apply the idea in a new task. Use that evidence to decide what to keep, remove, or revise. More features are useful only when they support the learning.

Write your PHACT brief · Use the testing checklist

Adapted from the supplied Human-Oriented Vibe Coding Educator Guide. This web edition uses Purpose, Human anchor, Audience, Components, Tone & constraints consistently with the PHACT framework and grade-band idea bank.