Context Engineering

What Is Context Engineering? The Post-Prompt-Engineering Discipline Explained

Context engineering is the practice of building what your AI knows — not just how you ask. Here's what it is, why it matters, and how to do it.


Every AI conversation starts from zero. It does not matter how long you spent in Claude Code yesterday — what you built, who you discussed, what you decided. Today, the model knows nothing. The discipline that has emerged in response to this problem is called context engineering.

The Stateless AI Problem

Every AI conversation starts from zero.

It does not matter how long you spent in Claude Code yesterday — what you built, who you discussed, what you decided. Today, the model knows nothing. You are a stranger. You paste the same background in again. You re-explain the same context. You rebuild what you already built.

This is not a complaint about the model. Claude is genuinely formidable. The problem is architectural: every LLM session is stateless. It begins with an empty working memory and ends the same way. Nothing accumulates. Nothing compounds. The AI you close on Friday is not the AI you open on Monday.

The discipline that has emerged in response to this problem is called context engineering.

This article explains what context engineering is, why it matters more now than it did two years ago, and how to practice it — starting with techniques you can implement today using tools you already have.

What Is Context Engineering?

Context engineering is the practice of building what your AI knows — not just optimizing how you ask.

A precise definition: context engineering is the structured, deliberate work of constructing and maintaining a persistent, cross-referenced representation of your professional world that can be loaded into an AI session before the conversation begins.

Context Engineering vs. Prompt Engineering

Prompt engineering is about the question. How do you phrase the request? What role do you assign? What examples do you include? The assumption is that the model's knowledge is fixed — your job is to extract better answers from what it already has.

Context engineering is about what the model knows before you ask. It treats the AI's working knowledge as something you build, maintain, and compound over time.

The distinction matters because it changes where you invest your effort.

A prompt engineer refines their inputs. A context engineer builds knowledge structures that make every input better — without rethinking anything. The prompt engineer is working harder on each session. The context engineer is building a system.

The Architectural Argument

LLMs operate on a context window — a finite block of text they can attend to during a session. Everything the model "knows" in that session either comes from its training data (static, general, not about you) or from what appears in that context window (dynamic, specific, entirely under your control).

This is the architectural argument for context engineering. The training data will not change. The context window is yours.

What you load into that window before asking your question is the single largest variable in output quality. Not the model size. Not the prompt phrasing. What the model knows when you start.

The Four Layers of Professional Context

Professional context is not monolithic. It separates into four distinct layers — each one a different engineering problem with a different capture strategy.

Layer 1: Identity Context

Who you are. What you do. How you work.

This is the foundation. Without it, Claude gives advice calibrated to a generic professional. With it, Claude works from your actual situation: your role, your constraints, your decision-making style, what you are optimizing for right now.

Most users have never made this explicit. They paste in a brief description when it feels relevant, which means the description varies by session and mood. Identity context should be permanent, consistent, and specific. It is the layer that makes everything else coherent.

Layer 2: Relationship Context

Who you know. The actual texture of those relationships.

This is the layer most users have never attempted. It is also the one that changes output quality most dramatically.

Relationship context is not just a name and company. It includes how you know someone, what you have built together, the current state of the relationship, commitments on both sides, what they care about, and the history of meaningful interactions.

Without this layer: "draft a follow-up to Marcus" produces a generic follow-up. With it: Claude drafts from full context — knowing who Marcus is, what you discussed last week, what you owe him, and what would actually move things forward.

The difference is not marginal.

Layer 3: Project Context

What you are building. What has been decided. What comes next.

This layer makes Claude a thinking partner on active work rather than a general advisor. It includes: active projects with status and blockers, key decisions already made and why, commitments made to clients and collaborators, and what is waiting on whom.

Without project context, every session starts with a briefing. With it, you ask "what should I prioritize this week?" and Claude answers from actual knowledge of your projects — not from generic prioritization frameworks.

Layer 4: Temporal Context

What happened. When. What changed.

Time is the layer that makes everything else coherent. Without it, relationship context is a snapshot without history. Project context has no trajectory. Decisions float without the conditions that produced them.

Temporal context means: meeting history, how relationships have evolved, how projects have progressed or stalled, what decisions were made when, and what patterns emerge across time.

This is the most expensive layer to maintain manually. It is also where the compounding value of context engineering is most visible.

Software of You
The automatic version of everything in this article. $149, once.

CRM, Gmail sync, Calendar, Projects, Conversations, Decisions, Journal, Notes. Local SQLite. No subscription. No cloud. The context system that builds itself.

See Software of You
Free · open source · your data stays on your machine

Why Context Engineering Matters Now

Two years ago, this was a niche concern for developers building on top of LLMs. Today it is a practical problem for anyone who uses AI tools to do serious work.

Three reasons this became urgent.

The Proliferation Problem

The average knowledge worker now uses four or five AI tools. ChatGPT. Claude. Gemini. Copilot. Perplexity. Each one starts every session from zero. Each one has its own memory system — incompatible with the others, siloed inside a subscription, not portable.

Your professional context is shattered across a dozen SaaS tools that do not talk to each other, and none of them talk to your AI. The context you build in one tool does not follow you anywhere.

Context engineering is the response: build context that lives outside any single tool, in structures you control, portable across every session.

The Compounding Value Argument

Each piece of context you build does not just improve one session. It improves every future session that touches the same person, project, or decision.

A contact file built for a key client relationship compounds. Every meeting debrief you add makes the next conversation smarter. Every decision you log adds to a body of knowledge that informs future decisions. The work you do today is not sunk cost — it is an investment that pays out across every future session.

The Ownership Argument

The Limitless/Meta acquisition is a useful data point here — not as alarm, but as illustration. Limitless built a wearable that remembered everything. Meta acquired it and shut down the consumer product. Every memory its users had built, every relationship context they had accumulated, went with it.

When your context lives in a cloud tool, it exists at the pleasure of that company's business model. Cloud memory is subject to acquisition, shutdown, pricing changes, and terms-of-service updates you did not write.

Context that lives on your machine — in local files, a local database — is yours. Permanently.

How to Practice Context Engineering Today

The four layers are real. You can implement all of them in Claude Code today, without any additional tools.

The CLAUDE.md Architecture

Claude Code reads a CLAUDE.md file from your project root before every session. Most users treat it as project documentation. It should be your identity context layer — a structured description of who you are, how you work, what you are optimizing for, and what constraints shape your work.

Specific, not comprehensive. Updated when your focus shifts. The most common mistake is writing a CLAUDE.md once and never touching it again — a three-month-old identity profile is describing someone who no longer exists.

One useful forcing function: revisit your CLAUDE.md every Monday morning. Five minutes. Does it still reflect reality? Change what does not.

Contact Files

For anyone you work with regularly, create a dedicated markdown file. One file per person. The file name is the person's name.

The structure that works: role and organization, how you know them, the current state of the relationship, the last significant interaction, what they care about, the history of meaningful interactions in bullet form, and any active commitments on either side.

Store these somewhere Claude Code can reference — ~/.claude/contacts/ is clean and persistent. When you need help with anything involving that person, reference the file. "Read Sarah.md and help me draft a follow-up" produces fundamentally different output than "draft a follow-up to Sarah."

The discipline is to update the file immediately after any significant interaction. Not later. Immediately — while the details are intact.

The Decision Log

Create a decisions.md file. Log every significant decision: what was decided, what the alternatives were, why this option was chosen, and — critically — what actually happened as a result.

That last field is the one nobody fills in. It is also the most valuable. A decision log with retroactive outcomes is a record of how your judgment works and where it went wrong. Claude working from a complete decision log gives better judgment, not just better recall.

Reference the log when facing current decisions. "Given my decision log, what patterns do I notice in how I evaluate these tradeoffs?" is a real question that produces real value.

Meeting Debriefs

Every significant conversation is a context-generating event. Most of that context is lost within 24 hours if not captured.

The debrief habit: immediately after any significant meeting, spend ten minutes on a structured note. What was discussed (substance, not transcript). Commitments made on both sides. Relationship signal — one sentence on how the relationship felt. What changed as a result of this meeting. The single most important next step.

Write it in the same directory as the relevant contact file or project notes. Reference it when Claude is helping you follow up or plan next steps.

The Ceiling of Manual Context Engineering

These techniques work. A Claude Code user who implements all four will have materially better AI interactions within a week. The improvement is real and immediate.

But manual context engineering has a ceiling — and the ceiling appears exactly where the value is highest.

The maintenance problem: Every file requires maintenance. Contact files go stale. CLAUDE.md falls behind reality. The decision log entry that needed a retroactive outcome never got one. Context engineering's value depends on currency. Stale context can be worse than no context.

The coverage problem: You interact with dozens of people and run multiple projects simultaneously. Manual capture gets the contacts you explicitly prioritize. The email thread where you made an offhand commitment, the calendar event that should be cross-referenced to the client project, the decision buried in a Slack thread — these exist outside the system.

The cross-referencing problem: The four layers are most powerful when they connect to each other. A contact file is more useful when it references the active project. The decision log is more useful when it connects to the relationship that produced it. Building those cross-references manually is a second-order maintenance problem on top of the first.

The update latency problem: Between the event and the capture, context degrades. The meeting debrief written three days later is missing the nuance that was present in the room.

What Automated Context Engineering Looks Like

The manual system above is real. The ceiling is also real.

The step beyond manual context engineering is automated context engineering: a system where the four layers update themselves, in the background, from the data streams that already exist.

Your Gmail syncs automatically. Not as a searchable archive — as structured context, cross-referenced to the relevant contact file, the project, the timeline of your relationship.

Your calendar syncs the same way. Every meeting is linked to the attendees. When a meeting ends and a transcript arrives, the system analyzes it: extracts commitments made on both sides, relationship signal, decisions reached.

Relationship scoring emerges from actual interaction patterns — frequency, response time, commitment follow-through.

Every piece of data connects to every other piece. When you ask "what commitments do I have outstanding this week?" — the system knows. Not because you logged them. Because the system captured them when they were made.

Software of You is a Claude Code plugin built for this. $149 one-time. softwareof.you


Frequently Asked Questions

Is context engineering different from prompt engineering?

Yes. Prompt engineering is about how you phrase questions to AI — crafting better inputs. Context engineering is about what the AI knows before you ask — building a persistent, structured representation of your professional world. Prompt engineering optimizes the question. Context engineering builds the knowledge base that makes every question smarter.

Do I need to be technical to practice context engineering?

No. The manual techniques — CLAUDE.md, contact files, decision logs, meeting debriefs — require nothing more than a text editor and consistent habits.

What tools support context engineering?

Claude Code supports context engineering natively through CLAUDE.md and the ability to reference local files. For automated context engineering — where your email, calendar, and meeting transcripts are analyzed and cross-referenced automatically — Software of You is a Claude Code plugin built specifically for this.

Is context engineering a real discipline or new terminology?

The practice is real. Engineers building on top of large language models have managed context windows and knowledge injection since 2023. The term is catching up to the practice.

What happens to my context when I switch between AI tools?

It disappears. Context engineering, done properly, lives outside any single tool — in local files, structured databases, or a dedicated platform. That makes it portable across every session and tool.

Software of You
Everything in this article, done for you.

$149 one-time. CRM, Gmail sync, Calendar, Projects, Conversations, Decisions, Journal, Notes. Local SQLite. No subscription. No cloud.

Get Software of You
Free · open source · softwareof.you
Pricing shown in this article reflects the planned one-time purchase price. SoY is free during early access.