00 — Orientation
A literal collaborator
Claude is a capable, literal collaborator with real breadth and no ability to read your mind. Like any large language model, it knows only what you put in front of it, holds no memory of what you didn’t say, and will attempt almost anything you ask. Working with it well is mostly managing those facts: giving it context, being specific, and checking what comes back. The rest of this guide is how.
It has no context you don't give it
It's a collaborator, not an oracle
Specific in, useful out
01 — What it's good and bad at
The shape of the tool
Every tool has a shape: things it does easily and things it does badly. Knowing the shape of a language model keeps you from asking for what it can’t reliably give, and frees you to lean on what it does well.
1.1
Strong: drafting & transforming
First drafts, rewrites, summaries, changes of tone or format. It turns a blank page into something to react to.
1.2
Strong: explaining & structuring
Breaking down ideas, outlining, teaching a topic, and organising messy thoughts into order.
1.3
Strong: language & code
Translation, editing, and writing or explaining code, within your ability to check it.
1.4
Weak: anything current or exact
It doesn’t reliably know today’s facts or events, and exact arithmetic and counting need checking or a tool.
1.5
Weak: your unstated context, and being sure
It can’t guess your constraints or intent, and it can be fluent, confident and wrong at once.
Figure 01 — illustrating section 01
Lean on, or verify
Lean on it for
- Drafting & transforming
- Explaining & structuring
- Language & code
- Broad, fast orientation
Supply or verify
- Anything current or live
- Exact numbers & counting
- Your unstated context
- Whether it is correct
Fluent is not the same as correct
Two lists worth keeping in mind. Lean on the model for language, structure and first drafts; supply or check anything that is current, exact, private to your situation, or simply has to be right. The dot on the left is a filled decision; the ring on the right is one you still have to close yourself.
02 — Give it context
The biggest lever
Context is the single biggest lever you have. The model works only with what’s in front of it, so the quality of the output tracks the quality of what you put in. Before refining how you ask, make sure you’ve supplied what it needs to answer well.
2.1
Role & goal
Who it should act as, and what a good result looks like. “Help” is vague; “help me write a concise rejection that keeps the door open” is a brief.
2.2
Audience
Who the output is for changes everything about it. Name them.
2.3
Constraints
Length, tone, format, what to avoid and what must be included. State the boundaries rather than hoping for them.
2.4
Source material
Paste the actual document, data or examples. Don’t make it guess at what you already have in hand.
2.5
Examples
A sample of what “good” looks like teaches faster than a paragraph describing it.
Figure 02 — illustrating section 02
What it can see
What Claude can see
Everything outside is invisible until you bring it in
The model sees only the window, not the world. Your message, the material you paste, and the conversation so far are all it has. Your intent, your files, current events and past chats are invisible until you put them inside. Missing context, not a weak model, explains most weak answers.
03 — The anatomy of a good prompt
Clarity, not magic words
Once the context is there, how you ask still matters. A good prompt is specific about the goal, the shape of the answer and the standard to hit. You don’t need secret phrasing; you need clarity a person could also follow.
3.1
State the goal plainly
Lead with what you want and why. The model orients around the objective, so put it first.
3.2
Specify format and length
A list, a table, three options, two hundred words. Say it, or you’ll get its default.
3.3
Give examples
Show one or two instances of what you want, and what you don’t. Examples are the strongest instruction there is.
3.4
Ask for reasoning when it helps
For anything with steps or judgement, ask it to work through the problem before answering. For simple recall, that only adds noise.
3.5
Use structure
Headings, numbered points or tags make a complex request legible to the model, exactly as they would to a colleague.
Figure 03 — illustrating section 03
The parts of a prompt
A prompt has parts, like a brief. Say who to be and what a good result is, give the context and material, set the constraints, name the format, and show an example. Not every request needs all five, but the more of them you supply, the less the model has to guess.
04 — Decompose big tasks
One job at a time
The biggest cause of disappointing output is asking for too much at once. A language model does its best work on one clear job at a time. Break a large task into steps, run them in sequence, and check each before moving on.
4.1
One job per message
A single, well-defined task beats a paragraph containing five. Ask for less, and get more.
4.2
Sequence the steps
Outline first, then draft a section, then refine. Build the result up rather than demanding it whole.
4.3
Carry the good parts forward
Feed what worked back in as context for the next step, so each stage stands on the last.
4.4
Let it help you plan
If you’re unsure how to break a task down, ask it to propose the steps first, then run them one by one.
Figure 04 — illustrating section 04
Split, sequence, assemble
Split · run in sequence · check each · assemble
Split, sequence, assemble. Break a large task into ordered steps, run them one at a time, check each as you go, and build the result up from parts. One clear job per step beats one overloaded request, every time.
05 — Iterate, don't one-shot
Steer the conversation
The first answer is a starting point, not the finish. The real power of working with a model is the conversation: you react, it adjusts, and a few rounds reach somewhere neither the first prompt nor you alone would have found. Expecting perfection first try wastes the best feature it has.
5.1
Treat it as a draft
Respond to what’s wrong with the first version rather than rewriting your whole prompt from scratch.
5.2
Steer with specifics
“Shorter”, “more formal”, “lead with the cost”, “drop the third point”. Precise feedback moves it precisely.
5.3
Keep what works, replace what doesn't
Lock the good parts and redirect only the weak ones, so you’re not starting over each round.
5.4
Know when to restart
If a thread has drifted, a clean, well-briefed start often beats ten more corrections.
Figure 05 — illustrating section 05
The iteration loop
Draft, review, steer, repeat. The first output is the start of a loop, not the end of the job. Each pass, you react to what’s wrong and steer with specifics, and the result closes in on what you wanted. The conversation is the tool.
06 — Verify the output
You own the result
Whatever comes back, you own it. A language model can be fluent, confident and wrong in the same sentence, so the last step is always yours: read it critically, check anything that matters, and don’t ship what you haven’t verified.
6.1
Check the facts
Treat names, numbers, dates and quotes as unverified until you’ve confirmed them. Confidence is not a source.
6.2
Test the code
Run it, don’t trust it. Code that looks like it works can still hide real faults.
6.3
Read for sense, not just fluency
Smooth prose can carry a wrong claim or a missing step. Read for what it says, not how it reads.
6.4
Keep judgement human
The model can inform a decision; it shouldn’t make the ones that carry real consequences for you.
07 — The right tool for the job
Match task to instrument
A language model is not the only tool, and not always the best one. Part of working well is knowing when to reach for something else, particularly for visual work, where a model built for words is the wrong instrument.
7.1
Language model for words
Writing, structure, logic, code, explanation and planning. Anything made of language or reasoning.
7.2
Visual tool for images
Generating and exploring images, moodboards and visual concepts. A different class of tool, built to see rather than to write, which is where image tools such as those in ChatGPT and dedicated image models come in.
7.3
Each for what it's built for
Don’t ask a word model to draw, or an image model to reason. The skill is matching the task to the instrument.
7.4
Combine them
A common flow is to think and plan in a language model, explore the look in a visual tool, then bring the results back to refine.
Figure 06 — illustrating section 07
Which tool for which task
Reach for a language model
- Writing & editing
- Structure & logic
- Code
- Planning & explanation
Reach for a visual tool
- Image generation
- Moodboards
- Visual concepts
- Look & feel exploration
Plan in words · explore the look in visuals · bring it back
Two instruments, two jobs. A language model handles anything made of words or reasoning; a visual tool handles anything made of images. The strongest workflow uses both in turn: plan and think in one, explore the look in the other, then return to refine.
08 — Working sessions
Run a session, not a prompt
For anything bigger than a single answer, you’re not prompting; you’re running a session. The model holds the thread of a conversation, so you can build up context, establish a way of working, and tackle a large piece over many steps, much as this series was made.
8.1
Set a standing brief
Open with the goal, the constraints and the standard once, and it carries through the work that follows.
8.2
Build context as you go
Each step’s output becomes context for the next, so the session gets more capable, not less.
8.3
Establish conventions
Agree the format, voice and rules early, and refer back to them rather than restating each time.
8.4
Mind the thread
A session can drift or fill up. Start a fresh one, re-briefed, when it does.
Figure 07 — illustrating section 08
Context carried forward
Context carried forward, growing each step
A session accumulates. One standing brief informs every step, and each step’s result is carried into the next, so the context grows and the model gets more capable as you go. This is how a large piece of work gets built, one briefed step at a time.
09 — Judgement & what to withhold
What stays with you
Two things stay with you no matter how good the tool gets: judgement, and discretion about what you feed it. Working well means keeping both, and being clear about which parts of the work should never leave your hands.
9.1
Keep a human in the loop
For anything consequential, legal, financial, medical, or about people, the model informs and you decide. It has no stake in being right and no accountability if it isn’t.
9.2
Don't paste secrets
Treat anything you send as leaving your hands. Keep out passwords, keys, and genuinely confidential or personal data unless you know how it’s handled.
9.3
Own the result
The output carries your name once you use it. Verification and judgement are the price of that, and they’re worth paying.
9.4
Stay the expert
The model is a fast draft and a wide reference, not a replacement for your own understanding of your work.
10 — The A–Z
First actions
If this is a lot, start here, in order. Most of getting good at this is a few habits, repeated until they’re automatic.
01
Say the goal plainly
Lead with what you want and why.
02
Give it the context
Role, audience, constraints, and the actual material.
03
Show an example
One instance of “good” beats a paragraph describing it.
04
Ask for one thing
A single clear job per message.
05
Break big tasks down
Outline first, then build up in steps.
06
Iterate
Respond to the draft and steer with specifics.
07
Ask for reasoning on hard things
Let it work through the steps before it answers.
08
Verify what matters
Facts, numbers, code. Confidence isn’t proof.
09
Use the right tool
Words to a word model, images to a visual one.
10
Keep judgement yours
Inform decisions with it; don’t hand them over.
Part II — In practice
Putting it to work
Part one is the durable method. This part is the opposite on purpose: it’s how I actually put Claude to work, opinions included, and it names specifics, tiers, tools and costs, that will date. Treat the practices as sound and the numbers as a snapshot: everything here is accurate as of 2026-08-17, and worth checking before you lean on it.
Artifacts over memory
Opinions, clearly marked
The numbers will move
11 — Planning vs doing
Decide, then build
The most useful habit in longer work is to separate planning from doing. Use one pass to decide what to build and in what order, and a different pass to actually build it. Blur the two and you get confident execution of a half-formed plan, which is the expensive kind of mistake.
11.1
A planning pass thinks
It questions the goal, weighs options, and produces a plan or a brief. Nothing is built yet, and that’s the point.
11.2
A doing pass executes
It takes the agreed plan and works through it, one step at a time, without re-litigating the strategy mid-build.
11.3
Keep them apart
Decide first, build second. When execution turns up a real strategic question, stop and go back to planning rather than improvising through it.
11.4
Write the plan down
A plan that lives only in the chat is lost the moment the thread moves on. The next two sections are the two artifacts worth keeping.
Figure 08 — illustrating section 11
Two passes, one gate
Plan
Do
↑ question? go back
Two passes with a gate between them. The planning pass questions, weighs and decides, ending in a written plan. The doing pass takes that plan and works it, step by step. When a real strategic question surfaces mid-build, you go back rather than improvising through it.
12 — The PRD
A written brief
A PRD, a product requirements document, is just a written brief for something you’re going to build. It’s the planning artifact: it states the problem, who it’s for, what a good result does, and what’s out of scope, so that both you and Claude are building the same thing. It doesn’t need to be long; it needs to be clear.
12.1
The problem
What’s wrong or missing, in plain terms. If you can’t state the problem, you aren’t ready to build yet.
12.2
The users & the goal
Who it’s for and what success looks like for them. This anchors every decision that follows.
12.3
Requirements
What it must actually do: the specific, checkable behaviours, not vague wishes.
12.4
Scope & non-goals
What’s in, and just as importantly what’s deliberately out, so the build doesn’t sprawl.
12.5
Acceptance
How you’ll know it’s done and working. Write this before you start, not after.
Figure 09 — illustrating section 12
The parts of a PRD
A brief, not a novel. State the problem, name the users and the goal, list the requirements, draw the scope and its non-goals, and set the acceptance test. A single clear page keeps you and Claude building the same thing.
13 — todo.md
A file to work through
The todo.md is the doing artifact: a single file that holds the whole task list in a structure Claude can read and work through. Sections group the work, tasks sit under them, and child tasks break the hard ones down. Because it’s one file, it’s the source of truth that keeps a long build on track across many sessions.
13.1
Three levels
Sections for the big areas, tasks beneath them, and child tasks for anything that needs breaking down. The shape mirrors the work.
13.2
Checkboxes and status
An open box, a done box, a note for blocked or in progress. Claude updates them as it goes, and you see the state at a glance.
13.3
Keep it in both phases
Write it during planning to lay out the work, and work through it during development so nothing is lost between sessions.
13.4
Point Claude at it
Open a session by telling it to read the todo.md and continue from the first unchecked task. The file becomes the standing brief.
Figure 10 — illustrating section 13
Sections, tasks, child tasks
Section
§ big area
task
child task
One file, three levels. Sections group the work, tasks sit under them, and child tasks break down whatever needs it, each with a box Claude can tick as it goes. Told to read it and continue from the first unchecked task, Claude always knows where the build stands.
14 — A little technical vocabulary
Words that make you precise
You don’t need to be a developer to work with Claude on technical things, but a handful of words make your requests precise and your reading of its answers faster. These are the terms that come up constantly, in plain English.
14.1
Repository (repo)
The folder that holds a project’s code and its full history. “Push it to the repo” means save it there.
14.2
Commit
A saved snapshot of changes, with a note. Your work advances one commit at a time, so it can always be traced or undone.
14.3
Branch & pull request
A branch is a parallel copy where you can work without disturbing the main version. A pull request proposes merging it back, so changes get reviewed before they land.
14.4
API
A defined way for one piece of software to talk to another. “Call the API” means ask another service for something.
14.5
Dependency (package)
Outside code your project relies on. More dependencies means more to keep working over time.
14.6
Environment
Where code runs: local (your machine), staging (a test copy), production (the live one). “It works locally” is not “it works in production”.
14.7
Deploy
To publish your code so it actually runs somewhere people can reach.
15 — Projects & tiers
Where context lives
Two practical things shape how you work day to day: Projects, which decide where your context lives, and your plan tier, which decides what you can and can’t do. Both are worth setting up deliberately. The specifics below are a snapshot as of 2026-08-17 and change often, so confirm the current details before you rely on them.
15.1
Projects hold context
A Project keeps chats, documents and instructions together, so Claude starts every conversation already knowing the background. Put a long-running piece of work in its own Project and stop re-explaining it.
15.2
Free gets you started
The free tier includes Projects, memory and the core chat, but not the developer tools, and it has tighter usage limits. Enough to learn on.
15.3
Pro unlocks the toolset
The paid individual tier adds the coding and agent tools, unlimited Projects and more usage. For most serious solo work, this is the tier that matters.
15.4
Higher tiers buy usage, not features
The tiers above Pro mainly add capacity and priority, not new abilities. Move up when a limit interrupts you, not before.
15.5
Team and above add administration
Shared Projects, central billing and controls, for when more than one person needs the same context. Note that not every seat type includes the developer tools.
Figure 11 — illustrating section 15
The tiers, as a ladder
A ladder of usage and control, not just price. Free is enough to learn on; Pro unlocks the real toolset for solo work; Max mostly buys capacity; Team and Enterprise add administration and compliance for groups. Climb when a limit blocks you, not for a feature you imagine is higher up. Figures date fast, so confirm them.
16 — Choose your device
The mobile-to-desktop truth
Where you work changes what works. The honest position: it’s far easier to work off documents or a codebase that travel with the chat than to rely on the agent features to fetch and manage things for you. In my experience the autonomous pieces, Cowork and dispatched background work, are still quirky, and I wouldn’t trust them for travelling work you can’t supervise with a laptop open. So choose your device before you start, and set the work up to match.
16.1
Decide by where the work happens
A project you’ll do on the go should be set up for mobile from the start; one you sit down for can be structured and foldered properly on desktop.
16.2
On the go, keep it in the chat
Carry the documents or the repo in the conversation so everything you need travels with you, rather than depending on a background agent to go and get it.
16.3
Sitting down, use desktop properly
This is where the foldered, structured setup and the desktop agent tools earn their place, because you’re there to steer them.
16.4
Don't hand travelling work to unattended agents
If you can’t keep a laptop on and watch it, don’t give a long job to a background agent and walk away. That’s my honest read as of now, and it’s the kind of thing that improves quickly, so re-test it.
Figure 12 — illustrating section 16
Where will you work?
Reserve unattended agents for when you’re watching
Pick the device before you start. On the go, set up for mobile and carry your files in the chat. Sitting down, use the desktop’s foldered, agent-assisted setup while you can supervise it. Want both? The next section is the setup that bridges them.
17 — The middle ground
GitHub, and a site of your own
If you want the best of both, one setup beats the rest: use GitHub as your folder and connect Claude Code to it, so the same project is there whether you’re moving or sitting, and you can work on it in tandem from either. From there, if you want a real interface for tracking tasks, files and memory, you can build yourself a small private site.
17.1
GitHub as your folder
Keep the project in a GitHub repository and point Claude Code at it. Now the codebase travels, the history is kept, and you can pick it up from any device without moving files by hand.
17.2
Work in tandem
Because the repo is the shared source of truth, on-the-go changes and sit-down changes meet in the same place, rather than in two disconnected chats.
17.3
A private site, if you want one
For tracking tasks, files and a memory of your work, a small private web app is the natural home: a frontend host for the site, and a backend that handles sign-in and data.
Figure 13 — illustrating section 17
One repo, any device
A private tracker: tasks · files · memory
The bridge that works moving or sitting. GitHub holds the repo, Claude Code works it, and you reach the same project from any device. Add a small private site, a frontend on Vercel and a backend on Supabase for sign-in and data, and you have your own interface for tracking tasks, files and memory.
18 — Your setup
A practical checklist
To put this part to work, in order. Start light, and add the heavier setup only when the work justifies it.
01
Choose your device first
Decide on the go or sitting down before you begin, not halfway through.
02
Write a short PRD
Problem, users, requirements, scope, acceptance. A page is enough.
03
Make a todo.md
Sections, tasks, child tasks, with checkboxes Claude can tick.
04
Separate planning from doing
Decide the plan, then work the list.
05
Put each project in its own Project
So the context is always there waiting.
06
Learn a few technical words
Enough to ask precisely and read the answers.
07
On the go, carry files in the chat
Don’t rely on unattended agents you can’t watch.
08
Sitting down, use desktop tools
Foldered, structured, supervised.
09
For tandem work, use GitHub + Claude Code
One repo, any device.
10
Build the private site only when needed
Start on the free tiers; pay when it must be always-on.
— Appendix
Notes & standing note
Part one describes a durable way of working with language models, independent of any product or version. Part two adds a practical playbook that does name specifics, tools, tiers and costs, dated on purpose. The method lasts; the numbers will move.
The method, in brief
N.1
On practice
Context, specificity, decomposition, iteration and verification are the common ground of effective use across every tool.
N.2
On tools
Part two names specific tools, tiers and costs. Those are a 2026-08-17 snapshot and will change, so verify them before you rely on them.
N.3
On judgement
For consequential decisions, keep a qualified human in the loop. A model informs; it doesn’t decide.