claude-praetorian

$npx mdskill add Vvkmnn/claude-emporium/claude-praetorian

Saves and restores context at key moments for improved decision-making

  • Identifies valuable data to save during planning, web research, and subagent completions.
  • Deploys cross-session memory by saving insights and findings in a structured format.
  • Decides what to save based on the type of task and context importance, using historical plans for reference.
  • Delivers saved contexts through commands like `compact-praetorian` and `restore-praetorian`, allowing users to review and use past data.

SKILL.md

.github/skills/claude-praetorianView on GitHub ↗
---
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
```

More from Vvkmnn/claude-emporium