summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAddy Osmani <addyosmani@gmail.com>2026-04-19 20:35:41 -0700
committerAddy Osmani <addyosmani@gmail.com>2026-04-19 20:35:41 -0700
commit2bee9b3842d054f8df81e220c21b207a5d204e33 (patch)
treeb000a14d5c3ef35814ba54c2b269161746698922
parentde62bb9e32f62ce4892fe93493f088a5308f1388 (diff)
docs(ship): note user-defined personas override plugin versionsorchestration
Plugin subagents sit at the bottom of Claude Code's scope priority table, so a code-reviewer (or security-auditor / test-engineer) defined in .claude/agents/ or ~/.claude/agents/ silently wins over the plugin's version when /ship spawns personas. This is intentional — user customization should take precedence — but the override is silent, so without documenting it people will waste time wondering why /ship isn't using the persona they expected. Adds a one-liner to Phase A framing this as a feature. Suggested in review.
-rw-r--r--.claude/commands/ship.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/.claude/commands/ship.md b/.claude/commands/ship.md
index 289473b..1dfaf01 100644
--- a/.claude/commands/ship.md
+++ b/.claude/commands/ship.md
@@ -23,6 +23,8 @@ Constraints (from Claude Code's subagent model):
- Each subagent gets its own context window and returns only its report to this main session.
- If you need teammates that talk to each other instead of just reporting back, use Claude Code Agent Teams and reference these personas as teammate types (see `references/orchestration-patterns.md`).
+**Persona resolution.** If you've defined your own `code-reviewer`, `security-auditor`, or `test-engineer` in `.claude/agents/` or `~/.claude/agents/`, those take precedence over this plugin's versions — `/ship` picks up your customizations automatically. This is intentional: plugin subagents sit at the bottom of Claude Code's scope priority table, so user-level definitions win by design.
+
## Phase B — Merge in main context
Once all three reports are back, the main agent (not a sub-persona) synthesizes them: