Claude Code team removed over 80% of the system prompt for Opus 5 and Fable 5, with no measurable loss on coding evaluations. This guide is based directly on those 6 shifts.. Ai Fire 101, Ai Researches, π₯ Ai Fire Academy.Β
TL;DR
Context engineering is now the better way to improve Claude Code. Your prompt matters, but the real performance comes from the context around it: tools, routines, memory, skills, and reference files.
Newer Claude models need less hand-holding. Instead of adding more rules, examples, and repeated instructions, your setup should become cleaner and easier to navigate.
This guide shows how to update your Claude Code workspace with six shifts: use principles, build design interfaces, turn
CLAUDE.mdinto a router, simplify tool descriptions, improve Claude Code memory, and use richer references like HTML when they help.Key points
Important fact: Anthropic removed over 80% of Claude Codeβs system prompt with no measurable loss on coding tests.
Common mistake: stuffing every rule and workflow into one giant
CLAUDE.md.Practical takeaway: run
/doctormonthly and clean dead weight before it slows Claude down.
Table of Contents
Introduction
Before you read the six shifts and immediately start cutting your CLAUDE.md, there’s one important thing to understand.
What Anthropic deleted was public-knowledge guardrails, the kind of thing the model already knows from training.
What they kept was private-knowledge rules: “we don’t ship on Fridays,” “that library is banned here,” “every type in this repo lives in one file.” None of that is in any training corpus, and no amount of additional model capability will fill it in.
Twitter tweet
So the lesson is: delete the filler, keep the private stuff. Your team’s conventions, deploy rules, banned patterns, and codebase-specific decisions are still worth keeping.
That’s the spirit behind all six shifts below.
I. Summary of All Six Shifts
Shift 1: From Many Rules to Better Judgment
The first shift in context engineering is simple: give Claude principles, not a long rulebook.
Before, Claude Code needed strict rules because the models were easier to confuse. People wrote things like:
-
“Do not write comments.”
-
“Never write long docstrings.”
That helped weaker models avoid bad habits. But overlapping rules like “leave documentation as appropriate” and “DO NOT add comments” forced Claude to spend tokens resolving contradictions before doing the actual work
Newer Claude models can read the surrounding code, understand the style, and make better calls on their own. So the better instruction now looks like this:
|
Old way |
Better way |
|---|---|
|
βNever write comments.β |
βMatch the comment style of the surrounding code.β |
|
βFollow this exact format.β |
βFollow the naming, structure, and style already used in this repo.β |
This gives Claude room to use judgment while still keeping output consistent.
The same idea works for creative tasks too. A βsurprise meβ skill can give Claude a clear direction, then let it create stronger front-end ideas: kinetic dots, interactive layouts, animated typography, and cleaner visual styles.
Use this inside Claude Code:
Before editing, inspect the nearby files. Match the existing naming, formatting, comment density, and structure. Use judgment when a short explanation would help future readers.
That is enough for most tasks now. Good context engineering guides Claude toward the right outcome without trapping it in tiny rules
Shift 2: From Examples to Design Interfaces
The second shift is about creative and tool control and it’s more counterintuitive than it sounds.
The old thinking was: give Claude examples so it understands what you want. But the actual finding from Anthropic is different: examples constrain the model to a narrow exploration space.
Instead, design your tool interfaces to be self-describing. If a parameter takes one of three states, make it an enum. The type signature tells Claude more than an example does, and doesn’t box it in.
In other words: design the interface so Claude doesn’t need examples at all.
|
Design interface part |
What Claude learns |
|---|---|
|
Colors and fonts |
How the brand should look |
|
Voice and style |
How the brand should feel |
|
Layout rules |
How pages, tools, and slides should be structured |
For visual and brand work, a practical version of this is a brandbook.html file, a design system showing your colors, typography, spacing, and visual style. You then wrap it inside a reusable Claude Code skill like /robo.


The workflow: Ask Claude for 3 design system options β pick the best one β refine it β turn it into brandbook.html β connect it to a reusable skill.
Read brandbook.html and use it as the design system for this task. Follow
the tokens, type scale, and spacing exactly. Do not copy the layout of the
brandbook itself β the layout should suit this specific page.
This makes outputs more consistent, but still gives Claude room to create because you’re setting boundaries, not copying a fixed example.
Shift 3: From All Context Up Front to Progressive Disclosure
The third shift in context engineering is a big one: Your CLAUDE.md should act more like a router.
The old advice was to put every rule, workflow, note, and best practice inside one giant CLAUDE.md. That sounds useful, but it gets expensive fast.
I mean every time you start a Claude Code session, the entire CLAUDE.md loads into context. If that file is huge, Claude burns tokens before doing any real work.
|
Old setup |
Better setup |
|---|---|
|
One giant |
A thin |
|
Loads all context at the start |
Loads only the context needed for the task |
|
Higher token cost |
Lower token cost and fewer usage-limit hits |
This is called progressive disclosure: you give Claude a simple map first, then let it open the right file only when needed.
Example CLAUDE.md structure:
# Workspace map
Read only the file relevant to the current task.
- Writing, newsletter, YouTube scripts β `content.md`
- Product specs, roadmap, feature decisions β `product.md`
- Pricing, offers, client notes β `business.md`
- Code conventions for this repo β `engineering.md`
## Always
- Ask before creating new top-level files.
- Match existing style in surrounding files.
A good CLAUDE.md should answer one question: Where should Claude look next?
That small change makes your setup faster, cheaper, and easier to scale.
Shift 4: From Repeated Instructions to Consolidated Tool Descriptions
The fourth shift in context engineering is about cutting duplicate instructions.
Older models had a problem called context rot. After a long session, they could pay more attention to recent messages and forget earlier rules.
So people repeated the same instructions in many places:
-
inside the main system prompt
-
inside tool descriptions
-
inside workflow files
That made the setup safer before, but now it mostly adds weight.
|
Old setup |
Better setup |
|---|---|
|
Repeat the same rule in many places |
Keep one clear version of the rule |
|
Long tool descriptions |
Short tool descriptions |
|
More tokens used every session |
Less token waste |
β Newer Claude models can follow simpler tool descriptions without needing the same rule repeated again and again.
So when you clean your Claude Code setup, look for duplicate lines.
If the same instruction appears in CLAUDE.md, a skill file, and a tool description, keep it in the place where Claude actually needs it most. For example:
Scan my CLAUDE.md, all skill files, and all tool descriptions. List every
instruction that appears in more than one place. For each duplicate, tell
me which single location it belongs in and why. Do not edit anything yet.
A good tool description should tell Claude what the tool does, when to use it, and what result to expect. That is enough.
Shift 5: From Manual Memory to Automatic Memory
The fifth shift in context engineering is about memory.
Before, you had to manually tell Claude what to save. In Claude Code, that often meant using the # hotkey to write something into CLAUDE.md.
That still works, but Claude Code memory is getting more automatic now.
|
Old memory setup |
Better memory setup |
|---|---|
|
Manually save every important lesson |
Let Claude save useful memories during work |
|
Keep adding notes into |
Store memory in the right files, routers, and skills |
|
Easy to forget what should be saved |
Review the session before closing it |
β The best move is to treat the end of each session as a cleanup step. A simple /calibrate skill can review what happened in the session and update the right places:
-
CLAUDE.mdrules -
memory files
-
skill files
-
routers
-
prompt packs
This keeps Claude Code memory useful instead of messy. I often use this prompt at the end of a strong session:
Review this session. Save any useful lessons, workflow changes, style preferences, reusable prompts, or project rules into the right memory files, routers, or skills. Keep only what will help future work.
That small habit makes your Claude Code setup improve over time.
Shift 6: From Simple Markdown Specs to Richer References
The sixth shift in context engineering is about the files you give Claude.
Markdown is still useful. Your CLAUDE.md, skill files, and many specs can stay in markdown. But newer Claude models can handle richer references now.
β For visual work, HTML can be much better than a wall of markdown.
|
Reference type |
Best for |
|---|---|
|
Markdown |
Rules, specs, checklists, workflows |
|
HTML |
Brand books, visual systems, UI mockups |
|
Test suites |
Use as the spec itself, let Claude infer what “correct” means from the tests |
|
Code from another codebase |
Port functions directly rather than describing what you want |
|
Rubrics |
Define what “good” looks like in a domain (e.g., API design), Claude can run verifier agents against these |
β HTML works well because Claude can read the code, and you can open the file in a browser to review it visually.
A brandbook.html file, for example, can show colors, fonts, spacing, layout rules, and visual style in a way markdown cannot show clearly.
You can also ask Claude to turn a hard concept into an HTML infographic. Instead of reading 2,000 words of notes, you get one visual file that both you and Claude can understand.
Use this prompt:
Turn this concept into a clean HTML infographic. Make it easy to scan, visual, and useful as a reference file Claude can reuse later.

This makes your context engineering setup easier to review, easier to share, and easier for Claude to use in future work.
II. Clean Your Setup With /doctorΒ
After you understand the six shifts, the next step is to audit your setup. Claude Code’s /doctor command is the right tool, but it does more than the original article suggests.
Claude Code now has a built-in /doctor command. It checks the parts of your setup that can quietly slow everything down. Since v2.1.205 (July 8, 2026), it now checks for:
-
Unused skills, MCP servers, and plugins loading into every session
-
Duplicate CLAUDE.md content
-
A root CLAUDE.md that’s grown too large and should be split
-
Slow hooks
-
Stale Claude Code version
-
Commands you keep re-approving that could be pre-approved
-
Skills that have been silently truncated because your skill list exceeded the context budget

β Run this before making big changes, because it reports problems first instead of fixing everything blindly. A good audit should catch things like:
![]() |
![]() |
One example: a 2,000+ line research skill is probably too thick. A better setup would turn it into a router that points Claude to the right research files only when needed.
β My recommendation: run /doctor once a month. Two versions to know:
-
/doctor(inside a Claude Code session): the full context audit, proposes changes, asks for confirmation. Alias:/checkup -
claude doctor(in your terminal): the installation health check for when Claude Code won’t even start
Context engineering gets messy over time. A monthly cleanup keeps Claude Code memory cleaner, reduces token waste, and helps Claude find the right context faster.
Conclusion
The old Claude Code setup was built around more rules, more examples, more repeated instructions, and more context up front. That made sense for older models, it doesn’t anymore.
The better setup is lighter:
-
Give Claude clear principles instead of a rulebook
-
Design self-describing interfaces instead of giving examples
-
Turn CLAUDE.md into a router instead of a storage room
-
Consolidate duplicate instructions into one place each
-
Let Claude Code auto-save useful memory instead of maintaining it manually
-
Use richer references, not just markdown walls
Start small. Clean your CLAUDE.md, archive old skills, simplify tool descriptions, and run /doctor once a month.
If you are interested in other topics and how AI is transforming different aspects of our lives or even in making money using AI with more detailed, step-by-step guidance, you can find our other articles here:
-
5 Best AI Productivity Apps Worth Keeping on Your Phone in 2026
-
Best AI Agent Tools in 2026: n8n vs. Claude Code vs. Base44 (Tested & Ranked for Real Work)*
-
How to Use Gemini Omni: 5 Practical Use Cases Most People Miss
-
Claude Fable 5: Unlock the Model Anthropic was Afraid to Release*
-
10 Fastest AI Productivity Hacks You Can Do in Under 1 Minute: Quick Wins for Any Creator*
*indicates a premium content, if any
Β




Leave a Reply