Harness maintenance
- Store shared prompts canonically in
.agents/prompts/. - Keep tool-specific prompt directories as symlinks to the canonical directory:
~/.claude/commands→~/.agents/prompts~/.pi/prompts→~/.agents/prompts
- Unless a prompt is explicitly intended for the agent to invoke autonomously, set
disable-model-invocation: truein its frontmatter. - Preserve the prompt's user-facing invocation with
user-invocable: trueunless the prompt is intentionally hidden from users. - Keep one canonical source; do not duplicate prompt files under tool-specific directories.
- End every prompt body with
$ARGUMENTSon its own trailing line so user-supplied command arguments are always received. Never omit it, even for prompts that currently take no arguments.