Context preservation & auto-compact.
Long sessions hit token limits. team.management intercepts both events — approaching the limit, and the compaction itself — to save a checkpoint and restore it, so the workflow continues exactly where it left off instead of forgetting the task.
Token monitoring
The PostToolUse hook monitors token usage for auto-compact after every tool call; as a fallback when auto-compact is off, the user-message hook warns once at 80% and again at 90%. With auto-compact on, compaction fires first — you rarely see the 90% warning.
Auto-compact
auto_compact.enabled (default true) and auto_compact.threshold (default 85%) live in team-management/config.json. At the threshold the context-compaction protocol triggers; the PreCompact hook fires first and writes a checkpoint — active task, branch, protocol step, and DAIC mode.
Restoration
After a session restart, session-start.py reads .claude/state/current_task.json and injects a session-state summary — the task file, the protocol position, and the DAIC mode are all restored. After an in-session compaction, the user-message hook injects the same restoration on your next message. The agent picks up mid-protocol, not from scratch.
Both .claude/state/current_task.json and .claude/state/daic-mode.json are protected — the protocol engine and hooks own them; never edit by hand.