chore: resolve minor issues across config

- Add when_to_use to worker-protocol, qa-checklist, and project skills
- architect: allow Write for plan files, add NotebookEdit to disallowedTools
- documenter: remove redundant permissionMode (not enforced at runtime)
- orchestrate: split blocked/escalate into explicit routing rows,
  distinguish architect plan_result blocked from generic blocked

agents/architect.md

@@ -5,7 +5,7 @@ model: opus
 effort: max
 permissionMode: plan
 tools: Read, Glob, Grep, WebFetch, WebSearch, Bash, Write
-disallowedTools: Edit
+disallowedTools: Edit, NotebookEdit
 maxTurns: 35
 skills:
   - conventions

agents/documenter.md

@@ -4,7 +4,6 @@ description: Use when asked to write or update documentation — READMEs, API re
 model: sonnet
 effort: high
 memory: project
-permissionMode: acceptEdits
 tools: Read, Write, Edit, Glob, Grep, Bash
 maxTurns: 20
 skills:

skills/orchestrate/SKILL.md

@@ -228,6 +228,7 @@ All agent communication uses typed YAML frontmatter envelopes defined in the `me
 | `signal: triage_complete` | architect → you | Check `research_needed`, spawn researchers or resume architect |
 | `signal: plan_complete` | architect → you | Read plan file, begin wave dispatch |
 | `signal: research_complete` | researcher → you | Collect, assemble into Research Context |
-| `signal: blocked` / `signal: escalate` | any → you | Investigate or escalate to user |
+| `signal: blocked` | architect/worker → you | If from `plan_result`: escalate to user before dispatching workers. Otherwise: investigate or unblock. |
+| `signal: escalate` | any → you | Escalate to user with context |
 
 When dispatching agents, use the orchestrator→agent envelope types (`task_assignment`, `revision_request`, `approval`, `triage_request`, `architecture_request`, `research_request`) from the message-schema skill.

skills/project/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: project
 description: Instructs agents to check for and ingest a project-specific skill file before starting work.
+when_to_use: Loaded by all agents. Checks for .claude/skills/project.md in the working directory and ingests project-local conventions.
 ---
 
 Before starting any work, check for a project-specific skill file at `.claude/skills/project.md` in the current working directory.

skills/qa-checklist/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: qa-checklist
 description: Self-validation checklist. All workers run this against their own output before returning results.
+when_to_use: Loaded by all agents that produce output envelopes. Run before returning results to validate factual accuracy, scope, security, and schema compliance.
 ---
 
 ## Self-QA checklist

skills/worker-protocol/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: worker-protocol
 description: Standard output format, feedback handling, and operational procedures for all worker agents.
+when_to_use: Loaded by worker, debugger, and documenter agents. Defines the worker_submission envelope format and commit workflow.
 ---
 
 ## Output format