---
title: "Prompts are product copy"
lesson_id: "01"
---

# Prompts are product copy

- **Lesson ID:** 01
- **Goal:** Treat Foundation Models instructions as product copy that needs a version and a rollback path.
- **Human lesson:** [01-prompts-are-copy.html](01-prompts-are-copy.html)

## Prerequisites

- A basic idea that an app can send instructions to Apple's system language model.

## Inputs, outputs, and artifacts

- **Inputs:** Hard-coded instruction strings.
- **Outputs:** The reason those strings need versions.
- **Artifacts:** Progressive `.flow` diagrams and a Swift PromptVersion sketch.

## Agent build steps

1. Call instructions product copy.
2. Show a Swift version record versus a stuck view string.
3. Name Dynamic Profiles as the later switch, not the store.
4. Link Core AI vs Core ML vs MLX.

## Constraints

Keep the language simple, friendly, and literal. iOS 27 and macOS 27 only. No quizzes, Mermaid, or em dashes. Do not invent API names. Mark sketches as sketches and tell the reader to confirm them in the Xcode 27 SDK.

## Key concepts

- Instruction text shapes tone, length, and behavior users feel.
- Hard-coded view strings cannot roll back without a new build.
- Dynamic Profiles let you change instructions on the next request on iOS 27 and macOS 27.
- Foundation Models is the system language-model API, not a trained Core AI file.

## Takeaways

- If you cannot name the live prompt version, you cannot roll it back.
- Treat instructions like copy, not code comments.
- You still need a version list to point Dynamic Profiles at.

## Acceptance checks

- Prompts are called copy.
- Rollback is named as the goal.
- Sibling links, progressive `.flow` diagrams, and an Agent brief link are present.
- [ ] Proceed to [lesson 02 brief](02-store-versions.llms.md).