Technical
Prompt Engineering Is Context Engineering in Disguise
I spent my first two months with AI coding tools fiddling with prompt wording. Chain-of-thought this, role-play that. The results were inconsistent. Then I changed my mental model and everything got easier.
The Reframe
The word 'prompt' suggests the text you type in the chat. Context is everything the model sees: the prompt, the files, the conversation history, the tool outputs, the system message. Prompt engineering optimizes 1 percent. Context engineering optimizes the other 99.
This is not a semantic game. It changed how I set up every project. Instead of asking 'what should I type,' I ask 'what should the model see?'
What Context Engineering Looks Like
For a typical coding task, the context I assemble before typing a single word includes:
- The file being edited, plus two or three neighboring files
- Type definitions and interfaces from the codebase
- One or two example files showing the pattern to follow
- A CLAUDE.md or similar file with project conventions
- The relevant test file, if it exists
With that context assembled, my actual prompt is often one sentence: 'Add a delete endpoint following the pattern in update.py.' The model does great work because it has everything it needs to do great work.
The Measurable Difference
I ran an informal test on myself. Same task, two setups. Setup A: one-line prompt with minimal context. Setup B: same prompt with curated context files. Setup A needed three iterations to get right. Setup B was correct on the first pass.
# Setup A (prompt engineering)
> 'Write a delete endpoint for posts with proper error handling
and authorization and follow REST best practices and...'
# Setup B (context engineering)
> [loads update.py, auth.py, test_posts.py]
> 'Add delete following the same pattern.'Setup B wins because the model sees your actual patterns, not generic best practices.
The practical takeaway: stop tweaking prompt wording. Start curating context. The models are smart enough to follow examples. Your job is to show them the right examples. See Anthropic's prompt engineering guide for the mechanics, but the mindset shift is where the real gains live.
RELATED READING
The Consulting Shift I Am Making In Year Two
After a year of writing and building, my consulting practice is changing shape. Shorter engagements. Sharper outcomes.
ReadThe Frontend Shift: Shipping Less JavaScript In Year Two
A year ago I reached for Next.js for everything. This year I often reach for nothing.
ReadThe Serverless Lesson I Would Write On A Sticky Note
After a year of shipping serverless projects, one rule explains most of the wins and all of the losses.
Read