0Pricing
Claude Architect · Lesson

Progressive Summarization Risks

Numbers, percentages and dates go vague when summarized.

Progressive Summarization Risks is a free Claude Architect lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Claude Architect learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Why Summaries Drift

Long-running agents can't keep every turn in the context window. A common fix is progressive summarization: periodically compress earlier messages into a shorter recap so the conversation keeps fitting.

It works for narrative flow. But it has a sharp failure mode for the Context Management & Reliability domain: when prose gets compressed, numbers, percentages and dates go vague. "$1,284.50 refunded on 2026-03-14" quietly becomes "a refund was issued recently."

What Actually Gets Lost

Summarization optimizes for gist, not precision. The model keeps the storyline and drops the exact tokens that carry transactional meaning.

  • Amounts: "$4,999.00" → "a large charge"
  • Percentages: "a 17.5% discount" → "a discount"
  • Dates: "order placed 2026-01-09" → "earlier this year"
  • IDs: "order #A-88231" → "the order"

These are exactly the facts downstream tools and policy checks depend on.

/compact Carries the Same Risk

In Claude Code, /compact compresses the running context to free up room — the same mechanism, the same risk. After a compaction, a stack trace's line numbers, a failing test's exact assertion, or a config value can come back fuzzy.

The fix isn't to avoid compaction; it's to make sure the precise facts you'll need later don't live only inside the part that gets compressed.

# Claude Code session: compaction is convenient but lossy
/compact   # compresses earlier turns -> numbers/dates can become vague

# Safer: persist exact facts that must survive
/memory    # write durable facts into CLAUDE.md before compacting

The Core Pattern: A Case Facts Block

The exam-grade fix is simple: pull transactional facts into a separate "case facts" block kept verbatim, outside the summary.

Summarize the conversational narrative freely — but maintain a structured, append-only block of exact values that is never passed through the summarizer. The summary keeps context cheap; the case-facts block keeps the numbers exact.

Structuring Case Facts

Keep the block machine-readable and verbatim. Each entry preserves the original value exactly as stated, with enough labeling to reuse it later.

This block is re-injected into the system prompt on every turn — remember the API keeps no server-side state, so you resend it as part of the full message history each request.

case_facts = {
    "customer_id": "CUS-44190",
    "order_id": "A-88231",
    "order_date": "2026-01-09",
    "order_total": "4999.00",     # exact, never rounded
    "discount_pct": "17.5",
    "refund_amount": "1284.50",
    "refund_date": "2026-03-14",
}

system = (
    "You are a support agent.\n"
    "## CASE FACTS (verbatim, authoritative)\n"
    f"{json.dumps(case_facts, indent=2)}\n"
    "## CONVERSATION SUMMARY (may be lossy)\n"
    f"{rolling_summary}"
)

Summarize Narrative, Preserve Facts

Split your context-management routine in two. When you compress, run the summarizer only over the dialogue, and leave the case-facts block untouched.

Order matters too: facts go near the top, the lossy summary lower down. The model attends to the start and end of context more than the middle (lost-in-the-middle), so authoritative numbers belong where attention is strongest.

def build_context(history, case_facts, max_dialogue_turns=8):
    recent = history[-max_dialogue_turns:]
    older = history[:-max_dialogue_turns]
    # Compress ONLY the narrative; facts are excluded from summarization
    summary = summarize(older) if older else ""
    return {
        "facts_block": case_facts,   # verbatim, top of context
        "summary": summary,          # lossy, fine for narrative
        "recent": recent,
    }

Extract Facts at Capture Time

Don't try to recover exact numbers after they've been summarized away — by then the source is gone. Capture them the moment they appear, straight from tool results.

Trim verbose tool output to the relevant fields before it enters history, but route the precise values you'll need into the case-facts block first. Use structured output (a tool call with a JSON Schema) so extraction is reliable, not a regex guess.

# After lookup_order returns, capture facts verbatim before trimming
order = tool_result["order"]
case_facts.update({
    "order_id": order["id"],
    "order_total": order["total"],     # keep raw string/decimal
    "order_date": order["created_at"],
})
# Now the full verbose payload can be trimmed/summarized safely

Why Retry Won't Save You

A tempting reflex: if a later answer cites the wrong amount, just retry with feedback. But retry-with-feedback only fixes format, structural or arithmetic errors — you resend the original doc, the wrong output, and the exact validation error.

Once a number has been summarized out of the context entirely, the information is simply absent from the source. Retry does not help when info is absent. Prevention (the facts block) is the only reliable fix.

Guard Hard Rules with Hooks, Not Memory

When a number gates a consequential action — say a refund threshold — never let a summarized, fuzzy amount drive the decision. Enforce it deterministically.

A PostToolUse or outgoing-call hook reads the verbatim case-facts value and blocks policy violations 100% of the time. Prompts are ~90% probabilistic; hooks are deterministic. Use hooks when failure has financial, legal or safety consequences.

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "process_refund",
      "command": "check_refund_limit.py"
    }]
  }
}
# check_refund_limit.py reads case_facts.refund_amount (verbatim),
# not the lossy summary, and exits non-zero if > $500.

Keep Provenance Alongside Facts

For research and extraction work, a verbatim fact is more trustworthy with its provenance: the source URL or doc name, the exact quote, and the publication date.

Dates frequently resolve apparent contradictions between conflicting stats — "revenue was $2.1M" vs "$2.4M" often just reflects different quarters. Annotate conflicting numbers with their sources rather than letting a summary silently pick one and blur the rest.

fact = {
    "claim": "Q4 revenue was 2.4M USD",
    "value": "2400000",
    "source_doc": "FY26-Q4-earnings.pdf",
    "quote": "Total revenue for Q4 reached $2.4M.",
    "published": "2026-02-02",
}

Fresh Session vs --resume

When a long session has been compacted many times, a resumed thread may carry a degraded summary — and resumed tool results can be stale if the codebase changed. Sometimes a fresh session seeded with a structured summary (your clean case-facts block) beats --resume.

The structured block is the carrier: it lets you start clean without losing the exact numbers and dates the work depends on.

# Long thread got fuzzy after repeated /compact?
# Start fresh and hand over the verbatim facts block:
claude -p "Resume task. ## CASE FACTS (authoritative):
$(cat case_facts.json)"

# vs. claude --resume my-session  (may carry a degraded summary
# and stale tool results)

Quick Check: Protecting the Numbers

A customer-support agent runs for many turns and periodically summarizes earlier messages to stay within the context window. QA finds it now quotes refund amounts and order dates that are slightly off or vague. Which fix is exam-correct?

Recap: Keep the Facts Verbatim

Key takeaways for the Context Management & Reliability domain:

  • Progressive summarization (and /compact) makes numbers, percentages and dates vague — the gist survives, the precision doesn't.
  • Fix: maintain a separate case-facts block, verbatim, outside the summary; summarize only the narrative.
  • Capture facts at the source from tool results; never try to recover them after they're gone — retry can't restore absent info.
  • Place facts near the start of context (beat lost-in-the-middle); keep provenance + dates for research.
  • Gate consequential thresholds with deterministic hooks reading verbatim values, and prefer a fresh session with a structured summary over a degraded resume.

Frequently asked questions

Is the “Progressive Summarization Risks” lesson free?

Yes — the full text of “Progressive Summarization Risks” is free to read here on the web, and the Claude Architect course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Claude Architect course, upgrade to CoddyKit PRO.

What will I learn in “Progressive Summarization Risks”?

Numbers, percentages and dates go vague when summarized. You practise Claude Architect with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Claude Architect?

No prior experience is required. Claude Architect on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Progressive Summarization Risks” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Claude Architect lesson?

Yes. Every Claude Architect lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. Full History Is Required
  2. Progressive Summarization Risks
  3. Lost-in-the-Middle Effect
  4. Case-Facts Blocks & Trimming Output
← Back to Claude Architect