diff options
| author | Addy Osmani <addyosmani@gmail.com> | 2026-04-19 20:35:41 -0700 |
|---|---|---|
| committer | Addy Osmani <addyosmani@gmail.com> | 2026-04-19 20:35:41 -0700 |
| commit | 2bee9b3842d054f8df81e220c21b207a5d204e33 (patch) | |
| tree | b000a14d5c3ef35814ba54c2b269161746698922 | |
| parent | de62bb9e32f62ce4892fe93493f088a5308f1388 (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.md | 2 |
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: |
