context-protect

context-protect — delegate a long dig, keep the summary

Your primary session's context is the scarcest resource it has. When a subtask would otherwise dump a long log, a codebase audit, or a full transcript analysis into it, push the work to a peer and keep only the summary. The peer stays free to grind through the full data; your session stays free to reason about the conclusion.

When to use

• The input is long (log file, directory listing, CI trace, transcript).
• You only need a conclusion, a bug location, a count, or a bullet list — not the raw material.
• The primary session does not need to answer follow-up questions about other details buried in the input. If it might, fetch the full output instead; summarization is lossy.

When NOT to use

• You cannot enumerate the question up front. Summarization works when you know what you want to learn; it fails when you are still orienting.
• The peer's summary is not trustworthy without spot-checks. Either verify the summary via a second pass (see skills/verify/) or pull the raw data.
• The task is cheap to run inline. Paying for a second agent's context just to avoid a 200-token paste is not worth it.

Protocol

Set Message.metadata.return_format to "summary" on the message/stream request:

{
  "message": {
    "parts": [{ "kind": "text", "text": "<digest prompt>" }],
    "metadata": { "return_format": "summary" }
  }
}

The peer adapter surfaces return_format: "summary" to the peer (the bridge does not summarize on its own — adapters relay the hint to the model). The peer is expected to compress its own output before returning; the shape that comes back is ordinary text, not a structured artifact.

Prompt scaffold

You are assisting a larger session that is TIGHT ON CONTEXT. Answer
the QUESTION below using the INPUT, then return ONLY the summary
requested — no raw excerpts longer than a single line of evidence
per bullet, no preambles, no "here is the summary" framing.

QUESTION:
<one specific question, e.g. "Which request ids failed with a
timeout between 14:00 and 15:00, and which upstream did they point
at?">

INPUT:
<paste or attach the log / audit / transcript>

OUTPUT FORMAT:
- Bullet list, at most N bullets.
- Each bullet: one fact, one citation (timestamp / line / file:line).
- End with a single-sentence "bottom line" summarizing the pattern.