Concept

Context engineering for teams

Last updated

Context engineering is the work of deciding what an AI model sees before it acts: the instructions, files, tool results and conversation history that fill its context window. For a team, it means every person's coding agent starts from the same agreed context, instead of whatever each person typed into their own session.

Anthropic's engineering team describes the goal as finding “the smallest possible set of high-signal tokens that maximize the likelihood of some desired outcome.” One developer can manage that by hand. A team needs a shared, versioned place for the context, a split between rules that rarely change and intent that changes with every feature, and a way for each agent to read the current version.

Prompt engineering and context engineering

Prompt engineering is writing and organizing the instructions you give a model. Context engineering covers everything that reaches the model during a run: system instructions, tool definitions, files and documents it retrieves, memory files, and the message history so far.

The distinction matters because context is finite. Anthropic's guidance describes a limited “attention budget” and cites Chroma's research on context rot, where recall falls as the window fills up. Adding more context does not reliably help. Choosing better context does.

The layers a coding agent reads

It helps to think of a coding agent's context as five layers. Each one needs a different owner and update rhythm.

  • Standing instructionsCLAUDE.md, AGENTS.md, Cursor project rules, and .github/copilot-instructions.md. Loaded at the start of every session. Best for build commands, conventions and rules that hold for months.
  • Scoped rules and skillsInstructions that load only for matching files or tasks: path-scoped rules in .claude/rules/, Cursor rules that apply to specific files, Copilot instruction files with applyTo, and skills that load when relevant.
  • Task intentWhat to build now, why, what is out of scope, and how the result will be checked. Changes with every piece of work.
  • Retrieved contextFiles, docs, issues and records the agent fetches with tools when it needs them. Anthropic calls this just-in-time retrieval: keep lightweight references and load the content at run time.
  • Session historyThe conversation so far. It disappears when the session ends, along with any decision that only lived there.

What changes when a team does it

On your own, context engineering is a habit. With several people and several agents, the same five layers drift apart in predictable ways. Two engineers start sessions from different versions of the plan. A decision made in a meeting never reaches any context window. The instruction file grows a rule per incident until it contradicts itself, and the Claude Code docs note that when two instructions conflict, Claude may pick one arbitrarily. The people who make product decisions rarely edit the files the agents read.

Practices that hold up across a team:

  • Separate rules from intent. Keep standing instruction files for facts that hold across features. Put each change's intent in its own reviewed document.
  • Agree before anyone generates code. Intent that the team has reviewed is the version every agent should start from.
  • Give every task acceptance criteria. An agent can check its own work against a criterion it can run or observe.
  • Retrieve instead of pasting. Point agents at the source through a tool, such as an MCP server, so they read the current version rather than a copy from last week.
  • Keep standing files small. The Claude Code docs suggest under 200 lines per CLAUDE.md, and Codex stops adding AGENTS.md content once the combined instructions reach 32 KiB by default.
  • Audit on a schedule. Remove outdated and conflicting instructions the way you would remove dead code.

The page on keeping CLAUDE.md and AGENTS.md consistent goes deeper on the first layer, and the PRD template for AI coding agents covers the task intent layer.

Where Hamster fits

Hamster holds the layers that change and the layers a whole team owns. Hamster drafts a Brief from a chat, the team aligns on it, and the Plan breaks it into Tasks with acceptance criteria and dependencies. Blueprints carry company and product context, and Skills and Methods carry the team's conventions: Skills for focused practices such as code review, Methods for the processes around them.

Agents read that context in two ways. hamster sync writes Briefs, Tasks, Blueprints and Methods as markdown into .hamster/ in the repository, and generates a project-context skill that tells the agent where each file lives. hamster skills sync puts the team's Skills in .agents/skills/, where coding agents load them like any other skill. The Hamster MCP server gives Claude Code, Cursor, Codex and other MCP clients live read and write access, with every call running under the signed-in person's permissions. The repository's own instruction file can then stay short and stable.

Free for 10 Briefs a month. Unlimited free viewer seats, pay only for creators.

Questions people ask

What is context engineering?
Context engineering is deciding what an AI model sees before it acts: instructions, tool definitions, retrieved files and documents, memory files and message history. The aim is the smallest set of high-signal information that makes the desired result likely.
How is context engineering different from prompt engineering?
Prompt engineering is writing the instructions. Context engineering manages everything that enters the context window during a run, including tool results, retrieved files and history, and decides what to leave out.
Does a bigger context window remove the need for context engineering?
A bigger window holds more, but Anthropic’s guidance cites research showing recall falls as the window fills, a pattern known as context rot. What goes into the window still decides the quality of the result.
Where should a team keep shared context for coding agents?
Keep stable rules in a short instruction file in the repository, such as CLAUDE.md or AGENTS.md. Keep per-change intent, decisions and acceptance criteria in a reviewed document that every agent reads, either synced into the repository or fetched through a tool such as an MCP server.
How do you keep every teammate’s agent on the same context?
Give the agents one source to read instead of copies. Version the instruction file in git, review intent before generating code, and have each session fetch the current Brief or plan rather than a pasted summary.

Sources

Checked October 1, 2026.