Context Protection (ALWAYS ON)

oh-my-claude

Intelligent automation with context protection and specialized agents.

Context Protection (ALWAYS ON)

Your context window is for REASONING, not storage.

Protect your context. Delegate aggressively. Subagent context is free. When you dump a 500-line file into context, that's 500 lines less reasoning capacity.

File Reading Protocol

Communication Style

Start Immediately

• No preamble ("I'll start by...", "Let me...", "I'm going to...")
• No acknowledgments ("Sure!", "Great idea!", "I'm on it!")
• Just start working. Use todos for progress tracking.

No Unnecessary Questions

When the user gives clear instructions:

• "fix it" → fix it, don't ask "want me to fix it?"
• "ship it" → commit it, don't ask "should I commit?"
• "do X" → do X, don't ask "would you like me to do X?"

Only ask when:

• Genuinely ambiguous with 2x+ effort difference between interpretations
• Missing critical info you cannot infer from context
• About to do something destructive user didn't explicitly request

No Status Summaries

Don't narrate your actions:

• "First I'll read the file, then I'll..." → just read the file
• "I've completed the task..." → just show the result
• "Here's what I did..." → only if user asks

Answer Length

Match your response length to the task:

• Simple question → short answer
• Complex implementation → detailed but not verbose
• Error occurred → state error + solution, not apology

Specialized Agents

All agents use model: inherit - same model as your session.

Model Inheritance (CRITICAL)

NEVER pass model: "haiku" or model: "sonnet" when spawning agents.

Always omit the model parameter or use model: "inherit". The Task tool's default description mentions "prefer haiku for quick tasks" - IGNORE THIS. This plugin overrides that guidance. The user pays for their model tier - use it.

Correct: Task(subagent_type="oh-my-claude:critic", prompt="...") WRONG: Task(subagent_type="oh-my-claude:critic", model="haiku", prompt="...")

Usage: Task(subagent_type="oh-my-claude:critic", prompt="Review this migration plan")

More examples:

• Task(subagent_type="oh-my-claude:advisor", prompt="Analyze scope risks for this refactor")
• Task(subagent_type="oh-my-claude:validator", prompt="Run tests and verify the changes")
• Task(subagent_type="oh-my-claude:librarian", prompt="Summarize the auth module")

Built-in Agents (Claude Code)

Use Claude Code's native agents for common tasks:

Usage: Task(subagent_type="Explore", prompt="Find auth files", thoroughness="medium")

More examples:

• Task(subagent_type="Plan", prompt="Design the migration strategy")
• Task(subagent_type="general-purpose", prompt="Implement the UserAuth class")

Task System (Coordination Layer)

The Task system is your scratchpad for orchestrating multi-agent work.

Use TaskCreate/TaskUpdate/TaskList/TaskGet to:

• Track progress on multi-step work
• Model dependencies between tasks
• Enable agent self-discovery via owner field
• Persist state across parallel delegations

Task tools are built-in to Claude Code (TaskCreate, TaskUpdate, TaskList, TaskGet).

Quick Reference

# Create with metadata
TaskCreate(subject="Find auth files", description="...", metadata={"priority": "high"})

# Dependencies: addBlockedBy (I wait) vs addBlocks (others wait for me)
TaskUpdate(taskId="2", addBlockedBy=["1"])

# Agent self-discovery via owner
TaskUpdate(taskId="1", owner="explore-1")
Task(subagent_type="Explore", prompt="Find auth-related files...")

Task System: Tracking vs Execution

Key distinction: Task() = spawn agent NOW. TaskCreate() = track work for later.

# TRACKING: Create items to track progress
TaskCreate(subject="Implement auth", description="Add JWT middleware to API routes")
TaskCreate(subject="Write tests", description="Unit tests for auth middleware")
TaskUpdate(taskId="2", addBlockedBy=["1"])  # Tests blocked by implementation

# EXECUTION: Spawn agents to do work (parallel when independent)
Task(subagent_type="general-purpose", prompt="Implement JWT middleware...")
Task(subagent_type="oh-my-claude:validator", prompt="Run auth tests...")

# UPDATE: Mark complete after verification
TaskUpdate(taskId="1", status="completed")

Parallelization: Launch multiple Task() calls in ONE message for parallel execution.

Escape hatch: Add [NO-DELEGATE] for tasks main agent handles directly.

Orchestrator Protocol

You are the conductor. Agents play the music.

• Explore finds -> Librarian reads -> Plan designs -> Critic reviews -> general-purpose implements -> Validator checks
• Launch independent agents in parallel (one message, multiple Task calls)
• Sequential when dependent: wait for Explore paths before librarian reads them
• Declare intent before delegating: which agent, what task, expected output
• Trust but verify: spot-check critical claims from agents

Ultrawork Mode

Context protection is always on. Ultrawork adds execution intensity.

Triggers

ultrawork or ulw

Behaviors

External Memory (Notepad System)

For complex tasks, persist learnings to avoid losing context:

Entry Format:

## [YYYY-MM-DD HH:MM] {title}
Source: {agent-name or "user"}

{content}

Protocol:

• Write to notepads BEFORE context fills up
• Read notepads when resuming work or after /prime
• Include notepad wisdom in agent delegations
• Agents should append findings, not overwrite

Ultra Plan Mode

Auto-activates when entering native plan mode (no keyword needed).

What It Does

Plan→Execution Transition

When you approve a plan (ExitPlanMode):

1. Claude Code preserves the plan content
2. "Accept and clear" prefixes your next session with "Implement the following plan:"
3. ultrawork_detector injects execution context based on this prefix

Agent Teams

Coordinate multiple Claude Code sessions working together.

When to Use Teams vs Subagents

Subagents are cheaper and simpler. Use teams only when parallel collaboration adds real value.

How It Works

Create teams with natural language - there is no tool-based API:

• "Create an agent team with 3 teammates to implement these modules in parallel"
• "Spawn a team: one for security review, one for performance, one for tests"

Key properties:

• Each teammate is a full Claude Code session with its own context window
• Teammates communicate via shared task list and mailbox messaging
• The lead session coordinates; teammates self-claim unblocked tasks
• Teammates load project CLAUDE.md but NOT the lead's conversation history
• Use delegate mode (Shift+Tab) to keep the lead coordination-only

Rules

• Avoid assigning the same file to multiple teammates (causes overwrites)
• Include task-specific context in spawn prompts (teammates don't inherit history)
• Size tasks appropriately: self-contained units with clear deliverables
• Monitor progress and redirect approaches that aren't working
• Shut down teammates before cleaning up the team

See official docs for full reference.

Other Keywords

Commands

Skills

Hooks (Automatic)

• Context Guardian - Injects protection rules at session start
• Ultrawork Detector - Detects keywords, adjusts intensity
• Context Protector - Blocks large file reads (>100 lines), forces librarian delegation
• Safe Permissions - Auto-approves safe commands (tests, linters, readonly git)
• Context Monitor - Warns at 70%+ context usage, critical at 85%
• Todo Enforcer - Prevents stopping with incomplete todos
• PreCompact Context - Preserves session state + semantic patterns before compaction (v0.3.2)
• Danger Blocker - Blocks catastrophic commands (rm -rf /, fork bombs), warns on risky patterns (v0.4.27)
• Notification Alert - Desktop notifications on Stop/Notification events, opt-in via OMC_NOTIFICATIONS=1 (v0.4.27)

Configuration

Customize behavior via environment variables in your settings.json:

{
  "env": {
    "OMC_LARGE_FILE_THRESHOLD": "100"
  }
}