lichtfuss.earth

Data on deck. Orders, Captain?

A bridge full of Datas, decisions that matter, and one chair that's yours: The Captain's. Oh, and — how do I put that in the official log?

Picture yourself in the captain's chair. You have a crew of officers who never tire, know a little, or a lot, about everything, and answer the instant you ask. Not one Data — several. They can do all the work for you. Splendid.

But they share one flaw. They'll answer with the same calm confidence whether they're right or wrong; they have no memory of what being wrong costs; they don't care about the consequence. "I calculate that you have a 67% chance of survival." (Note: there is no "we" on this ship!)

And sooner or later someone — an examination marker, a supervisor, a conference room — will ask how you got to the conclusions of your work. "The AI said so" is not a strong answer. In fact, it's a lot worse than "I have absolutely no clue." A captain who can't evaluate a response to an order should never have given the order.

The job was never to have the crew that can do all the work for you — everyone has a crew like this now. The job is to command it: to know what to ask, what to check, what to own, and what to do with the output. And to keep the log, so you can show your work when you're asked — what you requested, what you checked, what you decided.

This is what this guide is for. Starfleet officer training.

It's free, under CC-BY: read it, download it, mark it up, use it in your own work. It has already been run with students across three universities. The tool-specific parts date quickly, so treat it as a Version 1 — and tell me where it's wrong.

Below: the guide, to read or to download, and the story of why it exists — and why it's free.

How to Use AI in Your Project — Version 1.7, CC-BY. Read it online, or take the branded PDF to print, share, or mark up.

The guide

read or download — plus every section, in order

How to Use AI in Your Project

Ten sections, one appendix. The full guide, online.

Read the guide →
  1. 1

    Where we stand on AI

    The posture the whole guide takes: use AI, but with a method — because using it without one is worse than not using it at all. Sets the three rules — think before you prompt, record what you did, you decide — and the Plan–Do–Review cycle the rest runs on.

  2. 2

    The digital team model

    The organising idea, and not a metaphor. Treat your AI tools as a team of specialists you lead: you set the goal, assign the tasks, review the output, and stay accountable for all of it. Covers what makes the model work — goal before team, roles by stage, knowing when the human is a requirement.

  3. 3

    Individual project or team project — what changes?

    Read this early if you're in a group project. The team model assumes one lead; a group that hasn't agreed who leads has a coordination problem before it has an AI problem. Sets out what to settle between people first, so the virtual team can complement the human one.

  4. 4

    Four zones of AI use

    A plain map of where your use sits, from not using AI at all to designing a deliberate workflow. Names the line clearly: prompting and handing in the output is not acceptable — it isn't your work. Zone 4, intentional use, is the aim.

  5. 5

    Before you build your virtual team — map the landscape

    The planning most people skip — and the reason their output doesn't fit the question. You can't pick the team before you know the stage you're at. Works through five questions about your project's development pathway, the step that makes everything after it coherent.

  6. 6

    Working with your virtual team

    The day-to-day method: assign a role, give context, set a task, collect the output, review it hard, decide what to do with it — then repeat. Includes what these tools will and won't do — they follow instructions, they don't know what's right, they'll confirm a leading question — and the six-step task cycle.

  7. 7

    Record keeping

    No special system — just enough that someone else, or you three weeks later, can see exactly what you did and why. Lists the fields to capture for each substantive AI interaction: task, tool, prompt, what you used, what you discarded, how you verified, what you decided.

  8. 8

    Tools — a starting point

    What the current tools are good for, and where they fall short — with the honest note that the gaps between them have narrowed and keep shifting. The skill isn't knowing every tool; it's knowing what a given one is for, and being able to justify the choice.

  9. 9

    What to include in your deliverables

    How to make your method visible in the work itself — standard practice anywhere serious, not a rule invented for the project. A Methods section in two parts (the plan you made before any tool; the execution — what you asked, how you verified, what you decided), and how to carry the same into a presentation.

  10. 10

    Three principles to work by

    Three postures to keep in mind. DNA — don't trust anyone, never believe anything, always check everything — for high-stakes output. Trust, but validate, for everyday work. And the one beneath both: you are the captain. Your name is on it, not Data's.

Make it better

This is a Version 1. (Ok, Version 1.7) If you've used it and something is wrong, thin, or missing — or you've marked up a copy — send it back. The best version of this guide will be written by the people who use it.

Send a suggestion →

Marked-up PDFs or documents welcome as attachments.