All notes

Prompt engineering is dead. Context engineering is the job

I spent 2024 collecting prompts. By mid-2026 I stopped. The better models didn't need my clever phrasing — they needed my brief, my constraints, and my definition of good.

That shift is everywhere for solo founders. I've written that your AI agent has no memory and context files are the fix — every session starts from zero unless you give it something to carry. The fix isn't a better prompt. It's a better context.

Context engineering beats prompt engineering because it sets the whole stage the agent acts in — files, memory, tools, and taste — so the prompt only has to describe the next step, not re-teach the world.

Why did prompt engineering stop being enough?

Prompt engineering assumes the model is the bottleneck. It isn't anymore.

Tweaking "act as a senior designer" to "act as a staff designer" doesn't change the output. What changes it is whether the agent knows your type scale, your empty states, and your auth rules.

McKinsey's 2025 State of AI report found 88% of organizations already use AI in at least one function. The problem moved from access to reliability — agents that work once but break on the second session or the weird input. Anthropic's guide to building effective agents puts it plainly: give the model the right context and tools, then let it work in a tight loop. Prompt tricks don't fix a missing briefing.

Prompts also don't survive handoffs. You polish one in chat, paste it into Cursor, and the next agent never saw the thread. Context files do.

What does context engineering actually mean?

Context is everything the agent sees before it writes a word: system instructions, attached files, design tokens, tool outputs, history, and constraints.

Think of it like onboarding. A prompt is a task ticket: "build this screen." Context is the packet: who we build for, what good looks like, what we never do, and where truth lives. Without the packet, even a talented hire guesses. With it, they make fewer trips back to you.

For a solo founder, context lives in three places: a repo file like AGENTS.md for code, project memory that travels across tools, and scoped memory like Anthropic's Topics in Claude that sync between chat and Cowork for preferences. Over 60,000 repos now ship an AGENTS.md — not because founders love docs, but because re-explaining is slower than writing it once.

How do you build context agents can actually use?

Keep it short, specific, and tied to action.

1. Write what good looks like as a check. "We use 8px spacing, Inter 14/20 for body, no thin icons." That's a check, not a vibe. I wrote that AI has no taste and that is your advantage — taste only helps if you wrote it where an agent can read it.

2. List sources of truth, don't paste them. Link the Figma file, the token file, the auth helper. Paste creates stale copies; links keep one canonical place.

3. State constraints as negatives. "Never invent a new button. Use Button from /components/ui." Agents invent when you leave the gap open. Close it.

4. Scope by project. One global memory that drags a freelance client's voice into the next product is a trust bug. Keep one small file per repo. OpenAI's guide to prompt engineering still matters for single-turn tasks, but durable rules belong in context, not in the prompt you rewrite each time.

5. Version it like code. When a rule changes, commit it. If you updated it in chat but not in the file, you didn't update it.

Test it: open a fresh session, attach only context files, give a one-sentence task. If the output lands inside your taste bar, the context is sharp. If not, it's vague, not the model.

When does prompt craft still matter?

When the job is one-off and the context is already set.

Prompts still decide single turns: "Summarize these three interviews into Jobs to be Done, 80 words max." "Audit this screen for hierarchy and empty states." There, wording shapes the answer.

But those prompts work because context did the heavy lifting. The agent already knows who the user is and what you consider slop. The prompt just points.

Most founders still do the opposite — they rewrite prompts weekly and leave context empty. Flip it. Keep prompts short. Make context precise. You need an agent that shows up briefed and asks once, not five times.

Frequently asked questions

  • Prompt engineering rewrites a single instruction to get a better answer. Context engineering designs everything the agent sees before it acts — system instructions, relevant files, tool outputs, conversation history, and constraints — so it behaves reliably across tasks. One optimizes words, the other builds the environment.

About the author

mosh

mosh is a product designer for growth, working with design thinking and ever-improving design systems. What matters: fixing conversion, whether in B2B dashboards or direct-consumer apps.

Keep reading