Claude Architect · Урок

Устаревший контекст и начало с чистого листа

Если результаты инструментов после возобновления устарели, составьте новое резюме

Урок 4 из 413 шагов

«Устаревший контекст и начало с чистого листа» — бесплатный урок Claude Architect на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Claude Architect, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Claude Architect содержит 4 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

Resuming a Session

Claude Code lets you continue work across days. --resume <name> reopens a named session with its full message history intact: the prompts, the model's reasoning, and crucially the tool results that were captured the first time.

That replay is powerful. But it hides a sharp edge: those tool results are a snapshot of the past, not a live view of your system. This lesson is about recognizing when that snapshot has gone stale and what to do instead.

claude --resume refactor-auth

Why the History Is Frozen

Remember how the API works: the model keeps no state of its own. Every turn you send the full messages history — including prior tool_result blocks. The model reasons over whatever those blocks say.

A resumed session simply reloads that saved history. If a Read captured a file's contents last Tuesday, the model still believes Tuesday's version today — even if the file changed ten times since.

messages = [
    {"role": "user", "content": "Refactor the auth module"},
    {"role": "assistant", "content": [tool_use_read_authpy]},
    # tool_result below is a FROZEN snapshot from the prior session
    {"role": "user", "content": [tool_result_authpy_old]},
]
client.messages.create(model="claude-opus-4-1", max_tokens=2048, messages=messages, tools=tools)

What 'Stale Context' Looks Like

Stale context is when the resumed tool results no longer match reality. Common triggers:

  • A teammate edited the same files between sessions.
  • A migration changed the database schema the model had cached.
  • A dependency bump altered an API the model read earlier.
  • A build artifact or test output captured earlier is now obsolete.

The danger: the model proceeds confidently on outdated facts, producing edits that conflict with the current codebase.

Resume vs. Fresh Session

You have two recovery levers when a session ages:

  • --resume <name> continues the named session, replaying its full saved history.
  • fork_session branches from a shared point — useful for exploring an alternative without disturbing the original.

Both inherit the old tool results. When the codebase has drifted substantially, neither is ideal. Sometimes a fresh session seeded with a structured summary beats resuming, because it forces every fact to be re-fetched against current reality.

claude --resume refactor-auth     # replays old tool results
claude                            # fresh session, no stale snapshots

The Core Decision

Ask one question: has the ground truth changed since the session was captured?

  • Little or no drift (you paused for an hour, no one else touched the repo) → --resume is fine and cheap.
  • Significant drift (days passed, merges landed, schema migrated) → start fresh and re-summarize the goal, then let the model re-fetch live tool results.

This is a context-management reliability call — domain D5 on the exam.

Summarize Anew, Don't Replay

"Summarize anew" means: carry forward the intent and decisions, but drop the frozen tool outputs so they get re-acquired. You write a compact, structured summary of where the task stands, then open a clean session with that summary as the opening prompt.

The model then runs Read, Grep, and Bash against the current codebase — no stale snapshot to mislead it.

summary = """
GOAL: Finish refactoring auth to use the new TokenService.
DONE: Extracted TokenService; updated login() and logout().
TODO: Migrate refresh() and the 3 middleware call sites.
NOTE: schema migrated since last session — re-read current files before editing.
"""
messages = [{"role": "user", "content": summary + "\nRe-read the current files, then continue."}]

Keep Hard Facts Verbatim

Progressive summarization is lossy: it makes numbers, percentages, and dates vague. When your summary must preserve exact values — a version pin, a row count, a deadline, an order ID — don't fold them into prose.

Pull them into a separate "case facts" block kept verbatim, outside the narrative summary. The summary can compress the story; the facts block stays exact.

case_facts = {
    "target_version": "TokenService 2.4.0",
    "affected_call_sites": 3,
    "migration_applied": "2026-06-09",
}
prompt = SUMMARY_PROSE + "\n\nCASE FACTS (verbatim, do not paraphrase):\n" + str(case_facts)

Re-Fetch Before You Edit

In a fresh session the discipline is simple: investigate before mutating. Use the incremental pattern — Grep entry points, Read the files, Grep usages, Read consumers — so every edit is grounded in current contents.

This is also why Edit uses a unique-match contract: if the file drifted and your expected text no longer matches uniquely, the edit fails loudly rather than corrupting the file. Re-Read and retry.

# Fresh-session re-grounding before any change
# 1) Grep for the symbol
# 2) Read the current file
# 3) Edit with a unique match (fails loudly if the file drifted)

Don't Confuse This with /compact

/compact compresses the current conversation to free context space. It is useful, but it carries the same lossiness risk: numbers and dates can become vague. It does not solve staleness — the compacted facts are still from the original captures.

Starting fresh is different: you discard the old tool results entirely and re-derive them live. Use /compact for a long but still-accurate session; start fresh when the underlying system has moved on.

Subagents Never Inherit History

This staleness lesson rhymes with multi-agent design. Subagents do not inherit the coordinator's conversation history — all context must be passed explicitly in each subagent prompt.

The same hygiene helps you: when you hand a fresh session (or a subagent) a structured summary plus a verbatim facts block, you are doing deliberately what resume does accidentally — except you control exactly which facts survive and you force live re-fetching of the rest.

# Coordinator passes explicit, current context to each subagent
subagent_prompt = (
    "You are refactoring auth. Context summary:\n" + summary +
    "\nCASE FACTS:\n" + str(case_facts) +
    "\nRe-read the current files yourself; do not assume prior state."
)

A Practical Checklist

Before resuming a stale session, run this gate:

  • Drift? Did the repo/schema/deps change since capture? If yes → lean fresh.
  • Summarize goal, decisions made, and remaining TODOs.
  • Preserve exact numbers/dates/IDs in a verbatim facts block.
  • Re-fetch live: Grep → Read before any Edit.
  • Verify against current state, not the remembered one.

Cheap to resume when nothing moved; cheap insurance to start fresh when it did.

Quick Check

Test your judgment on the resume-vs-fresh decision.

Recap

Key takeaways:

  • Resumed sessions replay frozen tool results because the model holds no state and reasons over the full saved history.
  • When the system has drifted (merges, migrations, dependency bumps), those results are stale and can drive confident-but-wrong edits.
  • When drift is significant, start fresh and summarize anew rather than --resume or fork_session, which both inherit the old snapshots.
  • Keep exact numbers, dates, and IDs in a verbatim case-facts block; summarization makes those vague.
  • Re-fetch live (Grep → Read) before any Edit; /compact saves space but does not cure staleness.
Можно начать бесплатно

Изучай Python с ИИ-репетитором — бесплатно

Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.

Курсы
26
Уроки
104

Часто задаваемые вопросы

Урок «Устаревший контекст и начало с чистого листа» бесплатный?

Да — полный текст урока «Устаревший контекст и начало с чистого листа» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Claude Architect, подпишись на CoddyKit PRO. Курс Claude Architect содержит 4 уроков всего.

Чему я научусь в уроке «Устаревший контекст и начало с чистого листа»?

Если результаты инструментов после возобновления устарели, составьте новое резюме Ты практикуешь Claude Architect с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Claude Architect?

Предыдущий опыт не требуется. Claude Architect на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Устаревший контекст и начало с чистого листа»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Claude Architect?

Да. Каждый урок Claude Architect включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Фиксированные конвейеры и адаптивная декомпозиция
  2. Многоэтапная декомпозиция
  3. Управление сеансами
  4. Устаревший контекст и начало с чистого листа
← Назад к Claude Architect