#10466: docs(compaction): clarify valid modes and fix self-referential link
docs
stale
Cluster:
Compaction Enhancements and Features
## Summary
Clarifies the `compaction.mode` configuration by:
1. **Adding a "Compaction modes" section** documenting the valid values (`default`, `safeguard`) with descriptions
2. **Fixing a self-referential link** in the Configuration section that pointed to `/concepts/compaction` (itself) instead of the gateway configuration page
## Changes
- New table documenting valid modes and their behavior
- Updated link to point to `/gateway/configuration` with anchor to the compaction section
## Addresses
Closes #10395 (compaction.mode documentation unclear)
## Testing
- [x] Verified link target exists in docs/gateway/configuration.md
- [x] Confirmed valid modes match zod schema (`z.literal("default"), z.literal("safeguard")`)
---
🤖 AI-assisted (Claude via OpenClaw). Lightly tested — docs change only.
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
- Updates `docs/concepts/compaction.md` to clarify what compaction is and that it persists in JSONL history.
- Adds a new “Compaction modes” section documenting valid `agents.defaults.compaction.mode` values (`default`, `safeguard`).
- Replaces a self-referential link with a link intended to jump to the relevant section in the Gateway configuration docs.
<h3>Confidence Score: 4/5</h3>
- Mostly safe to merge, but contains a broken intra-doc anchor link that should be fixed to avoid confusing users.
- Docs-only change with straightforward content updates; the only concrete issue found is the configuration link fragment not matching any anchor in the target page, which will break navigation.
- docs/concepts/compaction.md (link fragment)
<!-- greptile_other_comments_section -->
<sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#10894: Docs: fix legacy branding, add config reference, expand cron troubl...
by biv0711 · 2026-02-07
78.3%
#14887: feat(compaction): configurable auto-compaction notifications with o...
by seilk · 2026-02-12
76.8%
#12834: docs(gateway): clarify there is no standalone clawrouter binary
by JBrady · 2026-02-09
76.4%
#11089: feat(compaction): support customInstructions and model override for...
by p697 · 2026-02-07
75.9%
#19923: feat: track held messages during compaction gate and split verifica...
by PrivacySmurf · 2026-02-18
75.4%
#18997: fix: improve context overflow error messages and docs
by realhoratiobot · 2026-02-17
75.1%
#7252: docs: align config examples and tool docs with current runtime
by nice-and-precise · 2026-02-02
75.0%
#20038: (fix): Compaction: preserve recent context and sync session memory ...
by rodrigouroz · 2026-02-18
75.0%
#14021: feat(compaction): optional memory flush before manual /compact
by phenomenoner · 2026-02-11
74.8%
#19232: fix(compaction): preserve exact identifiers in summarization
by brandonwise · 2026-02-17
74.5%