⌨️--append-subagent-system-prompt Flag
Also known as claude --append-subagent-system-prompt, --append-subagent-system-prompt-file
It adds your text to the prompt of each subagent.
Think of it like
It is like you give one rule to each helper on the team. The boss is not the only one.
Example
Emma's audit splits work across subagents. She wants every finding to name a file, so she adds that rule to all of them with this flag.
Why it matters
Rules you give the main chat do not reach subagents. This is how they get them.
Definition
Example code
bash
claude -p --append-subagent-system-prompt "Cite file paths in every answer" "Audit the repo"Common mistake
Key takeaways
- 1Every subagent. Nested too.
- 2Not forked ones. They reuse the main prompt.
- 3-p only. Non-interactive.