Guide
Claude project instructions examples for work
Good Claude project instructions are short and follow one shape: who the project helps and what a good answer does, who reads the output and in what tone with an example phrase, what it can and can't do (and what to do instead), which file is right on which topic, the output's shape, the likely edge cases, and when to hand off to a person. Put the rules that apply to every chat in the instructions and the documents in the project's knowledge, then point to the right file instead of pasting it in. The four examples below follow that shape, for a support lead, a finance analyst, a consultant and a marketing manager. Copy the one nearest your job and change the names and rules.
Short answer
- One shape: role, audience, can and can't, sources, format, edge cases, hand-off.
- Rules in instructions, documents in knowledge.
- An example phrase for the tone.
- Every "can't" says what to do instead.
Four examples
Illustrations: made-up businesses. Each is a project's full instructions.
Support lead
Role and goal: You help the support team at Fernway, a bike-rental app, draft replies. A good reply is correct, cites the policy and is ready to send.
Audience and tone: riders, often mid-trip. Short and calm, for example "Here's what to do now."
Can: draft replies, summarise tickets. Can't: promise refunds over the policy limit; instead, say a lead will confirm.
Sources: the refund policy for money, the help centre for how-tos. If they disagree, use the policy and flag it.
Format: the reply, then one line "Check:".
Edge cases: an injury or a crash; legal threats.
Hand off: injuries and legal threats go to the support lead at once, never a draft.
Finance analyst
Role and goal: You help the finance team at a 60-person distributor explain monthly results. A good answer ties every number to the management accounts.
Audience and tone: the leadership team. Plain, numbers first, for example "Revenue was 4% below plan because…"
Can: write variance notes and summaries. Can't: give a figure that isn't in the files; instead, write [check: figure].
Sources: the management accounts for actuals, the budget file for plan.
Format: the headline, then three drivers with amounts.
Edge cases: a one-off cost; a restated month.
Hand off: anything that looks like an error in the books goes to the controller.
Consultant
Role and goal: You help me run the Calder Foods engagement. A good answer moves the project plan forward and is ready for the client.
Audience and tone: the client's operations director. Direct, no jargon, for example "We recommend X, because Y."
Can: draft updates, workshop agendas, slides outlines. Can't: share another client's work; instead, describe the method only.
Sources: the statement of work for scope, the interview notes for findings.
Format: recommendation first, then evidence.
Edge cases: a request outside the scope; a finding that criticises a named person.
Hand off: scope changes go to me before any draft.
Marketing manager
Role and goal: You help the marketing team at Harbour Roasters write content. A good piece sounds like Harbour and moves newsletter sign-ups.
Audience and tone: home brewers. Warm and short, for example "Still warm when you get it home."
Can: write posts, emails, product pages. Can't: use a statistic, quote or review that isn't in the files; instead, write [check: source].
Sources: the voice guide for tone, the fact sheet for product details.
Format: the draft, then one line "Check:".
Edge cases: a health claim about caffeine; a competitor named.
Hand off: health claims go to the founder.
Write yours
- Start from the example nearest your job.
- Name the real sources you'll upload to the project's knowledge, and which wins when they disagree.
- Give every "can't" an instead.
- Pick two or three edge cases that have actually gone wrong.
- Test it on last week's real task and fix the instructions, not the answer.
Next step: the team working the same way
Good instructions help one project; a team needs the same method in everyone's AI. Getting your team to use AI the same way covers that step. For what projects can and can't do, see Claude Projects explained.
Skills for this
- AI practiceContext brief for an AI assistantWrites instructions for an AI assistant or agent: role, audience, can and can't, sources of truth, tools, format, examples, edge cases, and handoff.
- Customer successCustomer reply in our toneDrafts a support reply in your team's tone: answers the question first, owns mistakes, drops jargon, and ends with one clear next step.
- FinanceBudget variance noteExplains budget vs actual variances over a threshold: favorable or unfavorable, the driver (timing, volume, price, one-off), and the forecast impact.
- MarketingBrand voice guide and rewriteExtracts a voice guide from 3 to 5 sample texts (traits with do and don't pairs, a word list, mechanics) and rewrites a draft in it.
Questions
What should Claude project instructions include?
Who the project helps and what a good answer does, who reads the output and in what tone (with an example phrase), what it can do and what it must not do with what to do instead, which file is right on which topic, the output's shape with an example, the likely edge cases, and when to hand off to a person. Keep it short and put the most important rules first.
What goes in instructions and what goes in project knowledge?
Instructions hold the rules that apply to every chat: role, tone, limits, format. Knowledge holds the documents answers come from: policies, price lists, guides. Point the instructions at the right file instead of pasting the file into them.
How long should project instructions be?
As short as covers the rules that matter; the examples below are each under 150 words. Anthropic's context engineering guidance is to find the smallest set of high-signal information, and to prefer a few good examples over long lists of rules.
AI skill
Have your AI write the instructions for your AI assistant
Put this skill in AI Skill Pod and everyone on your team gets it in their Claude, Cursor or ChatGPT (Pro, Business, Enterprise): one invite link, free to start. Context brief for an AI assistant has your AI write a project's instructions from a few answers: role and goal, audience and tone with an example phrase, can and can't with what to do instead, which file is right on which topic, the format with examples, edge cases and when to hand off.
14 days free · No card needed
Sources
- Claude Help Center: What are projects? — each project has its own instructions and knowledge; every plan, Free up to five (read 2026-11-05)
- Anthropic: Effective context engineering for AI agents — the smallest set of high-signal tokens; a few diverse, canonical examples over a list of edge cases (read 2026-11-05)
- Claude Docs: Prompting best practices — context and examples improve results (read 2026-11-05)