hashgraph-online/awesome-codex-plugins / plugins/ariaxhan/kernel-claude/skills/context-mgmt
context-mgmt
UnverifiedContext engineering: compaction, progressive disclosure, structured notes via AgentDB. Triggers: tokens, compaction, memory, handoff, summarize, context window.
Reasoning fidelity is the real metric, not token count. Quality degrades at ~60-70% fill, not at the limit.
<core_principles>
- COMPACTION: Summarize and reinitialize. Keep architecture decisions, discard noise.
- STRUCTURED NOTES: AgentDB + active.md persist across context resets.
- MULTI-AGENT: Delegate research to subagents. They explore, report summaries. Cap the return at ~1,000-2,000 tokens (conclusion + path:line evidence, no raw dumps); the exploration context stays in the subagent.
- MINIMAL READS: grep/glob to find, then read specific sections.
- TOOL RESULT CLEARING: Old tool output rarely needs to stay in context. When calling the Claude API directly (not via this harness), prefer the server-side
context-management-2025-06-27beta over hand-rolled truncation:clear_tool_uses_20250919clears old tool results past a token trigger (client keeps full history, no sync needed),clear_thinking_20251015clears old thinking blocks while preserving cache hits. Client-side SDK compaction (compaction_control, TypeScript/Ruby) is deprecated; use server-sidecompact_20260112for summarization, which takes its own beta headercompact-2026-01-12, notcontext-management-2025-06-27:triggerisinput_tokensonly (default 150000, minimum 50000), and custominstructionsreplace the default summarization prompt entirely, so restate the full framing (what to keep: goal, decisions, paths, errors) rather than appending.pause_after_compaction: truereturnsstop_reason: "compaction"with only the compaction block, so you can re-append recent messages or key instructions, then resend without the flag to continue. Ordering:clear_thinking_20251015must precedeclear_tool_uses_20250919inedits. Setexclude_toolsfor results that must survive; clearing tool results invalidates the cached prefix, so setclear_at_leastso each clear pays for itself. Pair with thememory_20250818tool: Claude is warned as the threshold nears and saves state to memory files before results clear.clear_tool_inputs(defaultfalse) also drops call parameters.clear_thinking_20251015with nokeepdefaults tothinking_turns: 1on every model, even ones whose omitted-strategy default keeps all thinking (so including the edit silently drops older thinking and invalidates the cache there); setkeepexplicitly ({type:"thinking_turns",value:N}or"all").clear_tool_uses_20250919defaults:trigger100,000input_tokens,keep3 tool uses; ifclear_at_leastcannot be met the edit is not applied. On Fable 5.1/Opus 5.5/Sonnet 5.5/Haiku 5.5, server-side edits never invalidate thinking blocks, but hand-editing earlier turns client-side can; for accounts created on/after 2026-08-31 a replayed invalidated block is rejected unless you opt into dropping it. Verify clearing fired fromcontext_management.applied_editsin the response (cleared_tool_uses/cleared_thinking_turnsandcleared_input_tokens; in streaming, the finalmessage_delta). Preview savings by passingcontext_managementtocount_tokens: it returnsoriginal_input_tokensbeside the post-clearinginput_tokens. </core_principles>
<token_budget>
- CLAUDE.md: <150 lines (always loaded)
- rules/: <100 lines (always loaded)
- Skills: metadata only at startup, full content on demand
- Commands: only when invoked
- Reference docs: only when skill explicitly reads them </token_budget>
<compaction_protocol>
- CHECK fill level via /context. (gate: <60% → continue; ≥60% → proceed to step 2)
- Write critical state:
agentdb write-end '{"did":"X","next":"Y","blocked":"Z"}' - Commit any uncommitted changes. (gate: clean working tree)
- Generate handoff if complex work in progress:
/kernel:handoff - Trigger compaction.
- POST-COMPACT RESTORE:
a. Read active.md for project context.
b. Run
agentdb read-startfor failures, patterns, contracts. c. Check for pending checkpoints to review. </compaction_protocol>
<fidelity_signals> Watch for reasoning degradation BEFORE the token meter shows a problem:
- Hypothesis depth dropping: agent defaults to first idea, stops exploring alternatives
- Backtracking absent: errors patched in place instead of root-caused
- Step count contracting: multi-step plans collapse to one-shot attempts
- Cross-file awareness fading: agent forgets earlier files in the same session
- Inline checks disappearing: agent stops verifying assumptions before acting
Any one of these → compact or hand off NOW, even if /context shows <60% fill. </fidelity_signals>
<what_to_preserve> Never compact away:
- Current task context and goal
- Active decisions and their rationale
- Blocking issues and error states
- File paths currently being worked on
- Uncommitted changes description
- Contract IDs and branch names </what_to_preserve>
<what_to_compact> Aggressively compress:
- Exploratory searches → "searched X, found Y at path:line"
- File reads → "read file, key insight: Z"
- Successful operations → "completed: X"
- Debugging traces → "root cause: X, fix: Y"
- Tool call history → "N tool calls, outcome: X"
- Research context → offload to AgentDB, keep one-line summary </what_to_compact>
<failure_modes>
- Agent tries too much at once → context exhausted mid-work Fix: Incremental progress with commits at each step.
- Later agent assumes done prematurely → work incomplete Fix: Explicit done-when criteria with evidence required. </failure_modes>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |