50% contextregel voor Claude Code en Cursor: wanneer een sessie moet worden gewist en hoe een taak moet worden gedelegeerd
Wat er gebeurt tijdens een lange sessie
Je werkt een uur lang samen met een agent aan een feature. In het begin waren we het erover eens: raak de publieke API niet aan, schrijf tests in Vitest, gebruik de bestaande apiClient. Aan het einde van de sessie maakt de agent een nieuwe fetch-wrapper, verbreekt de handtekening van de geëxporteerde functie en schrijft een test in Jest. Het is in menselijke zin niet "vergeten": de vroege instructies zijn nog steeds in hun context, maar ze zijn nu omgeven door tienduizenden logtokens, diffs en leesbestanden.
Dit heeft een onderzoeksbasis. Lost in the Middle (Liu et al., 2023) laat zien dat modellen slechter gebruik maken van informatie uit het midden van een lange context dan vanaf het begin en het einde. Bovendien hoopt zich afval op in de context: verouderde versies van bestanden, geannuleerde benaderingen, foutmeldingen die al zijn opgelost. Het model ziet ze op één lijn met de huidige staat.
De “50%-regel” is een heuristische, geen gemeten drempel. Het gaat erom de context vooraf te beheren, in plaats van te wachten tot de agent fouten maakt of tot automatische compressie in werking treedt.
Hoe de bezetting te bekijken
In Claude Code laat het commando /context zien hoeveel er bezet is en wat: systeeminstructies, geheugenbestanden zoals CLAUDE.md, beschrijvingen van MCP-tools, berichtgeschiedenis. Het laatste punt blijkt vaak onverwacht: verbonden MCP-servers met tientallen tools bezetten al vóór het eerste bericht een merkbaar deel van het venster.
Focus in Cursor op de contextindicator in de chat en uw eigen tekens: de agent herleest bestanden die hij al heeft geopend, herhaalt een afgewezen optie, haalt namen door elkaar.
Procedure voor een half venster
- 1.Vraag de agent om de status op te schrijven. Geen hervertelling van het gesprek, maar een werkdocument:
Запиши в docs/handoff/feature-export.md: - цель задачи в одном абзаце; - принятые решения и почему (с путями к файлам); - что сделано и проверено (какие тесты проходят); - что осталось, в порядке выполнения; - ограничения: что нельзя трогать; - открытые вопросы. Не включай историю попыток, которые мы отбросили.
- 2.Controleer het document zelf. Dit is de enige plaats waar u bepaalt wat er in de nieuwe sessie gaat. Verwijder wat onjuist is, voeg vergeten beperkingen toe.
- 3.Wis de sessie. In Claude Code -
/clear, in Cursor - nieuwe chat.
- 4.Begin met het bestand. “Lees docs/handoff/feature-export.md en ga verder vanaf het volgende punt.”
Een alternatief voor de eerste drie stappen in Claude Code is /compact met een indicatie van wat er moet worden opgeslagen: /compact сохрани решения по API экспорта и список оставшихся шагов, логи тестов не нужны. Het is sneller, maar je ziet de uiteindelijke uitvoer niet zo duidelijk als het bestand.
Wat je buiten de dialoog moet houden
Permanente projectregels mogen niet in de berichtgeschiedenis voorkomen. Ze horen thuis in CLAUDE.md (Claude Code) of in .cursor/rules (Cursor): ze worden bij elke nieuwe sessie geladen. Leuk CLAUDE.md kort:
# Проект Next.js 15, App Router, PostgreSQL через Drizzle. # Команды - pnpm test — Vitest - pnpm lint — ESLint + tsc --noEmit # Правила - HTTP-запросы только через lib/api-client.ts. - Публичные функции в lib/public/* не меняют сигнатуру без явной просьбы. - Перед завершением задачи запускай pnpm lint и pnpm test.
Het is beter om lange naslagwerken (databasediagram, API-beschrijving) in afzonderlijke bestanden te bewaren en deze indien nodig te koppelen, in plaats van ze altijd te downloaden.
Hoe je de context niet opblaast
- Vraag niet om de hele map te lezen. Specificeer specifieke bestanden of vraag om eerst te vinden wat u nodig heeft door te zoeken.
- Trim commando-uitvoer.
pnpm test 2>&1 | tail -50in plaats van de volledige log in duizenden regels. - Plaats het onderzoek in een subagent. In Claude Code opereren subagenten in een aparte context en retourneren ze alleen output. De taak om “alle plaatsen te vinden waar de oude client wordt gebeld” is goed gedelegeerd: de hoofdsessie ontvangt een lijst, niet de inhoud van twintig bestanden.
- Eén sessie - één taak. Door over te schakelen naar “tegelijkertijd de stijlen in de koptekst corrigeren” worden niet-gerelateerde bestanden in de context gesleept.
Tekent dat het tijd is om eerder schoon te maken
- De agent biedt een oplossing die u enkele stappen geleden heeft afgewezen.
- Hij leest het bestand dat hij zojuist heeft bewerkt opnieuw en is verrast door de inhoud ervan.
- Door de ene fout te corrigeren, ontstaat er een andere op een plek die hij al heeft gecorrigeerd.
- De antwoorden worden langer en het verschil wordt kleiner.
Als dit gebeurt, is het doorgaans duurder om dezelfde sessie voort te zetten dan een paar minuten aan het overdrachtsbestand te besteden.
Wanneer een regel niet nodig is
Korte taken die in een tiental berichten passen, vereisen geen enkele procedure. Bij modellen met een zeer groot raam kan de drempel worden verplaatst, maar het puin van geannuleerde pogingen zal niet verdwijnen. Concentreer u op het gedrag van de agent, niet op het percentage: het getal 50 is het punt waarop u er op zijn minst over moet nadenken.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.