plan-mode-orchestrator-write-deadlock

Detect write deadlocks caused by plan mode and orchestrator hooks.

Updated Nov 18, 2025
One-click install
npx skills add https://github.com/cajias/claude-skills --skill plan-mode-orchestrator-write-deadlock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-mode-orchestrator-write-deadlock
Source: https://github.com/cajias/claude-skills/tree/main/plugins/cc-authoring/skills/plan-mode-orchestrator-write-deadlock
Command: npx skills add https://github.com/cajias/claude-skills --skill plan-mode-orchestrator-write-deadlock

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps when a write task is completely blocked because an orchestrator hook forbids direct edits while plan mode also prevents subagents from writing, leaving no agent-side path forward.

Core Features & Use Cases

  • Deadlock Detection: Recognizes the pattern where both the main thread and subagents are prevented from writing.
  • Recovery Guidance: Explains that the only real escape is for the user to exit plan mode, then re-run the write through the correct path.
  • Safe Workflow Coordination: Encourages completing read-only verification first so the write can succeed immediately once restrictions are lifted.
  • Use Case: You are trying to publish a document or edit a file, but every attempt returns a plan instead of performing the write.

Quick Start

Use this skill when a write request is blocked by both plan mode and an orchestrator hook, then tell me the exact restriction messages so I can confirm the deadlock and guide the next step.

Frequently Asked Questions about plan-mode-orchestrator-write-deadlock

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do my file editing attempts return a plan instead of executing the write?

Your file editing attempts return a plan because plan mode prevents subagents from writing while an orchestrator hook forbids direct edits, creating a write deadlock. Both agent-side paths are blocked, so the system defaults to planning instead of executing.

How do I break a write deadlock between plan mode and an orchestrator hook?

To break a write deadlock between plan mode and an orchestrator hook, you must exit plan mode manually, then reissue the write command through the correct path. No agent-side retry can bypass this restriction.

Can a subagent write to local files when plan mode is active?

A subagent cannot write to local files when plan mode is active because plan mode restricts subagent write permissions. If an orchestrator hook also blocks direct edits, both write paths are deadlocked and require user intervention.

What should I do while waiting to exit plan mode before reissuing a blocked write?

While waiting to exit plan mode, you should complete read-only verification tasks so the write can succeed immediately once restrictions are lifted. Stop redundant write retries to avoid generating repeated planning responses.

Does an orchestrator hook prevent direct edits when using subagents for workflow updates?

An orchestrator hook prevents direct edits by the main thread, forcing writes through subagents. However, if plan mode is simultaneously active, subagents are also blocked, leaving no agent-side path for workflow updates.