A launch post for nv:context, a Claude Code skill that sets up context engineering for any repository in three minutes.
The wall I kept hitting
I build production Python services with AI coding agents. Claude Code, Cursor, Copilot, the whole rotation. And no matter how carefully I wrote my CLAUDE.md files, I kept hitting the same wall: the agent would forget rules mid-session, run the wrong test command, or touch files it shouldn't.
I did what most people do. I wrote longer CLAUDE.md files. Added more "don't do X" instructions. Tried /init. Nothing clicked.
Eventually I sat down to figure out why. Four weeks later, I had read 200+ sources on what the research calls context engineering. The picture was clearer than I expected, and uglier. Here's the punchline:
Bad context doesn't just not help. It actively hurts.
ETH Zurich found that auto-generated agent config files reduce success by 3% and increase costs 20%+
METR ran a controlled study on experienced developers and found they were 19% slower with AI tools when context was poorly managed, despite feeling 24% faster
FlowHunt / LongMemEval showed that a focused 300-token context outperforms an unfocused 113K-token context on the same task
Dex Horthy has shown that using 40% of the context window outperforms using 90%
Anthropic and Manus production data: below 60% context utilization is safe. At 70%, precision drops. At 85%, hallucinations begin.
The thing that shifted my thinking was Philipp Schmid's line:
"Most agent failures are not model failures. They are context failures."
The 8 laws that came out of it
Less is more. Every line in your context competes with the actual task for attention.
Landmines, not maps. Document what agents can't discover by reading the code.
Commands beat prose. One snippet showingnpm run test -- --coverage --maxWorkers=2beats three paragraphs.
Context is finite. Frontier LLMs follow roughly 150 to 200 instructions consistently.
Progressive disclosure. Layer it: root CLAUDE.md, subdirectory CLAUDE.md, skills, MCP tools.
Hooks for determinism. If a rule MUST be followed 100% of the time, use a hook.
Negative instructions backfire. "Don't use moment.js" makes models more likely to use moment.js. Say "MUST use date-fns" instead.
Compact proactively. Don't wait for Claude to compact at 95%. Update HANDOFF.md, run/clear, start fresh.
The hierarchy of leverage
Priority Layer Compliance Cost to set up
───────────────────────────────────────────────────
1 Verification 100% Medium
2 CLAUDE.md / AGENTS.md 90-95% Low
3 Hooks 100% Low
4 Skills ~79% Medium
5 Subagent patterns Variable Medium
6 Session management Manual Low
Most people optimize from the bottom up. The best engineers start at the top.
What nv:context does
Interviews you about your tools, pain points, landmines, and workflow preferences
Scans your codebase with parallel subagents to find non-obvious patterns
Scores your setup on all six leverage layers (0-10 per layer, 0-60 overall)
Generates tailored configs for only the tools you actually use
Sets up hooks for deterministic enforcement- Creates session management infrastructure
Installs compounding engineering (optional GitHub Action)
Production proof
selectools (Python SDK, 4,612 tests)
Starting state: L3 maturity, 49/60 leverage score, 440-line CLAUDE.md.
After: L5-L6, 58/60. CLAUDE.md went from 440 lines to 67 (-85%). Token budget dropped 53%.
nichevlabs (multi-product SaaS)
Starting state: L4 maturity, 17/60 leverage score.
The smoking gun: a 805-line SESSION.md that got loaded on every session start. 17,000 tokens. On every conversation. nv:context's token budget report made it impossible to ignore.
After: L6, 49/60 (up 32 points). SESSION.md went from 805 lines to 59 (-93%). Saved 15,800 tokens per session. A parallel bug-hunt subagent surfaced 81 real bugs while it was analyzing the codebase.
sheriff (Python + TypeScript)
Already-strong setup. L4 maturity, 36/60 leverage score going in.
After: L5, 42/60 (+6 points). Smaller delta than the others. Incremental polish, not a rewrite.
The through-line across all three: the skill is not a template generator. Same methodology, radically different outputs.
What it works with
The generated AGENTS.md is read by 25+ AI coding tools including Claude Code, Cursor, GitHub Copilot, Aider, Codeium, Continue, Windsurf, Zed, Gemini CLI, Cline. Tool-specific files only get generated for the tools you actually use.
Install
npx skills add johnnichev/nv-context -g -y
Then open any project and run /nv-context. Three-minute interview, thirty seconds of parallel analysis, done.
The research library
Full research library: https://skills.nichevlabs.com/research
Full synthesis (10 laws, 4 operations, 7-component context stack): https://skills.nichevlabs.com/synthesis
Primary sources include Anthropic engineering blog, Google DeepMind research, OpenAI Agents docs, ETH Zurich agent config paper, METR controlled developer study, JetBrains NeurIPS 2025 paper, Manus production data, GitHub's analysis of 2,500 public AGENTS.md files, Boris Cherny, and Dex Horthy.
Honest caveats
- Three production repos is a small sample.
60% token overhead on first run. First-run benchmark: 100% pass rate vs 45.8% baseline.
Research coverage is Python and JavaScript heavy. Rust, Go, Kotlin, and Elixir are thinner.- The skill is opinionated.
If you build AI coding agents for a living
Context engineering is the discipline that separates AI tools that work in demos from AI tools that work in production. If you have been writing longer CLAUDE.md files and things keep not quite working, try nv:context on your repo.
- Repo: https://github.com/johnnichev/nv-context
- Landing: https://skills.nichevlabs.com
- Install:
npx skills add johnnichev/nv-context -g -y
Two things launch alongside nv:context today. First, selectools, the Python agent framework I built that taught me I needed a methodology. Second, the landing page you just read about this methodology was built entirely with nv:design.
SOCIAL SHARE CARD GENERATOR