agent-prompt-design

name

agent-prompt-design

description

Apple's complete prompt stack for Xcode 27's coding agent, as shipped. Consult when designing or reviewing agent prompts, tool descriptions, planner/executor splits, edit-application strategies, or context-window assembly — this is a production system's actual wording, not advice about prompting. Covers: planner and executor system prompts (including a GPT-5-specific variant and a no-classify variant), reasoning vs non-reasoning variants, tool-assisted variants, an A/B test pair, three edit integrators (standard, new-code, fast-apply), retrieval query expansion, and the fourteen fragments used to frame current file, selection, snippets, issues and search results.

Everything Xcode 27 sends to a model, extracted from the shipping app. Useful as evidence rather than opinion: when deciding how to word a tool description or split planning from execution, read what a team with real usage data actually shipped.

Nothing here should be installed as an agent's own system prompt. It is reference material for writing prompts, not a prompt to adopt.

References

Agent architecture

• references/PlannerExecutorStylePlannerSystemPrompt.md: the planner half of a planner/executor split — the largest and most instructive file here.
• references/PlannerExecutorStylePlannerSystemPrompt-gpt_5.md: the same planner retargeted at GPT-5. Diff the two to see what a team changes per model.
• references/PlannerExecutorStyleNoClassify.md: the variant that skips the classification step.
• references/AgentSystemPromptAddition.md: what is appended when running in agent mode rather than chat.
• references/AgentAdditionalContext.md: extra context supplied to the agent.
• references/AgentVersions.plist: the agent backends Xcode bundles — Claude Code and Codex, pinned by version, URL and checksum.

System prompt variants

• references/BasicSystemPrompt.md and : the baseline, with and without tools.