docs(coding-agent): add note about iterating on manual summary

This commit is contained in:
Mario Zechner 2025-12-04 03:01:07 +01:00
parent 3d66d2561d
commit be2d90819a

View file

@ -781,7 +781,7 @@ pi --session /path/to/my-session.jsonl
## Context Compaction
> **Note:** Compaction should generally be avoided as it is lossy. The agent loses access to the full session history after compaction. Try to size your tasks such that compaction will not be necessary. Alternatively, watch the context usage in the footer. When it approaches 85-90%, ask the agent to write a summary of what's been done to a markdown file, then start a new session and load that file into the context.
> **Note:** Compaction should generally be avoided as it is lossy. The agent loses access to the full session history after compaction. Try to size your tasks such that compaction will not be necessary. Alternatively, watch the context usage in the footer. When it approaches 85-90%, ask the agent to write a summary of what's been done to a markdown file. You can iterate on the summary with the agent until all relevant information is captured. Then start a new session and load that file into the context.
Long sessions can exhaust the model's context window. Context compaction summarizes older conversation history while preserving recent messages, allowing sessions to continue indefinitely.