claude-praetorian

name	claude-praetorian
description	Context preservation with cross-session memory — hooks prompt compaction at high-impact moments, siblings enrich what gets saved
triggers	["PreToolUse","PreCompact","PostToolUse","SubagentStop"]

Praetorian Plugin

Context guard. Saves and restores valuable context at the right moments — before planning, after research, when subagents complete.

Hooks

Hook	When	Action
PreToolUse(EnterPlanMode)	Before planning	Lists prior compactions, suggests restoring
PreCompact	Before context resets	Prompts to save decisions/insights/findings
PostToolUse(WebFetch/WebSearch)	After web research	Prompts to compact as web_research
SubagentStop	After subagent completes	Prompts to compact as task_result

Commands

Command	Description
/compact-praetorian [type] [title]	Save current context
/restore-praetorian [query]	Load previous context

Workflows

Compact (standalone)

1. Identify what's worth saving (research, decisions, patterns)
2. praetorian_compact(type, title, key_insights, refs)
3. Verify with praetorian_restore(title) to confirm it saved

Compact (with siblings)

1. If historian active: search_plans() to check if past context already covers this
2. If oracle active: include any tool discoveries in key_insights
3. praetorian_compact(type, title, key_insights, refs)
4. If vigil active: files are also checkpointed via quicksave

Restore (standalone)

1. praetorian_restore() — list recent compactions
2. praetorian_restore("query") — search for specific topic
3. Summarize findings for the current task

Restore (with siblings)

1. praetorian_restore("query") — load praetorian context
2. If historian active: search_conversations("query") for broader session history
3. If oracle active: search("query") for tools relevant to the restored context
4. Combine all sources into a unified briefing

Sibling Synergy

Sibling	Value	How
Historian	Past plans surface during planning compactions	search_plans() enriches pre-plan hook
Oracle	Tool discoveries included in compactions	Oracle results added to key_insights
Gladiator	Observations inform what to compact	Failure patterns highlight important context
Vigil	Files checkpointed alongside context	Quicksave protects files during compaction

Requires

claude mcp add praetorian -- npx claude-praetorian-mcp