0Pricing
Claude Architect · Lección

Riesgos de la creación progresiva de resúmenes

Los números, porcentajes y fechas se vuelven imprecisos al resumirlos.

Riesgos de la creación progresiva de resúmenes es una lección gratuita de Claude Architect en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Claude Architect, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Claude Architect incluye 4 lecciones en total.

Partes de esta lección aún no han sido traducidas y se muestran en inglés.

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.

Preguntas frecuentes

¿La lección «Riesgos de la creación progresiva de resúmenes» es gratis?

Sí — el texto completo de «Riesgos de la creación progresiva de resúmenes» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Claude Architect, actualiza a CoddyKit PRO. El curso de Claude Architect incluye 4 lecciones en total.

¿Qué aprenderé en «Riesgos de la creación progresiva de resúmenes»?

Los números, porcentajes y fechas se vuelven imprecisos al resumirlos. Practicas Claude Architect con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Claude Architect?

No se requiere experiencia previa. Claude Architect en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «Riesgos de la creación progresiva de resúmenes»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Claude Architect?

Sí. Cada lección de Claude Architect incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Se requiere todo el historial
  2. Riesgos de la creación progresiva de resúmenes
  3. Efecto de la información perdida en el centro
  4. Bloques de datos del caso y recorte de la salida
← Volver a Claude Architect