OneMindBETA
OneMind

A Standard to Guide AI: Lessons from Apple’s iPhone Duo

Apple has introduced iPhone Duo, its first foldable iPhone. What interests us most is the care behind the experience: how an app uses the extra space, where its buttons go, and how your work carries on when you open or close the phone.

Apple has long published design guidelines to help people build apps for its devices. For iPhone Duo, there is also something you can hand straight to your AI agent: a Markdown version of the design guide. It puts Apple’s layout and interaction advice into a text file the agent can read and use while adapting your app. You and the agent can work from the same rules.

For us, this is also a good example of how to work with AI. Give it clear rules before it starts, then check the result against those rules. Fewer rounds of corrections can save time and reduce the tokens spent on rework.

Next, we’ll use Apple’s design guide to explore how to write good design rules for AI.

1. Tell AI what it’s reading

At the top of Apple’s Markdown file

Apple puts these labels at the start of its Markdown file, inside an HTML comment. A normal Markdown preview hides that comment. Our preview shows the values so you can read them more easily.

These details are called metadata. Think of them as the label on a folder: they tell you what you are about to read and where it belongs.

This gives an AI agent useful clues before it reads the advice. If you give it several files, clear titles and paths can help it find the reference for the job. The design rules themselves come after this block.

We can borrow that idea for our own notes. Give each guide a clear name, say when to use it, and record when you last checked it.

2. The main guide

2.1 State the result before the steps

Apple opens with the experience the app should provide: continuity as the phone opens and closes. That gives the later rules a shared purpose. For an AI guide, an opening like this provides a way to judge choices that the detailed instructions may not cover.

Start with a result people can notice. For example: “People should be able to finish this form without losing anything they entered when the layout changes.” AI then has a reason to preserve entered text while adjusting the page. You also have a clear outcome to check.

2.2 Define the terms before using them in rules

Apple explains the displays, hinge and cameras before giving detailed layout instructions. Later rules can use those names without explaining them again. This creates a shared vocabulary and gives each instruction a clear target, which helps AI connect a requirement to the right part of the work.

In your guide, define names that could mean different things: “A card is one item in the results list. The detail page opens after selecting a card.” Then “change the card title” is a much clearer request. Include background that affects the work, so the definitions stay easy to find.

2.3 Group changing situations under a shared rule

Apple names several ways to use the device, then brings them back to a small set of layout categories. This connects many visible cases to a reusable way of deciding what to do. For AI, that can be more useful than a growing list of one-off answers that leaves the next case unexplained.

Before writing a rule, list the changes it must handle: a longer title, another language or a narrower window. Then write what they have in common, such as keeping the full title readable and actions available. Use the cases to check the rule, and add an exception when one really needs different treatment.

2.4 Put the instruction first, then explain it

Apple’s main recommendations start with short, bold instructions. Reasons, examples and links follow them. The structure makes the action easy to find while keeping the explanation close by. An AI agent consulting one part of a long guide can get both the instruction and the context for using it.

Write one clear requirement first: “Keep entered information when the layout changes.” Then explain why it matters and give a case to check, such as resizing a partly completed form. Keep extra detail below the rule so readers can find the instruction again without rereading the whole explanation.

2.5 Write rules that work when conditions change

Apple describes spacing in relation to the available area. That makes the rule useful as the screen changes. This is a useful way to write instructions for AI: explain what must stay true across different situations, so one example does not become a fixed answer for every case.

For a card layout, you could write: “Let the card fit its container. Keep the button fully visible when the text wraps.” AI can work out the layout for each width, and you can check both narrow and wide versions against the same rule.

2.6 Write the condition beside the action

The phrase “only present when the camera is active” gives the following instruction a clear condition. Apple also separates adjustments the system handles from work needed for custom components. Together, these details help a reader decide whether an action is needed before making a change.

Use the same pattern in your guide: “When the list is empty, show an explanation and an Add button.” State the condition, then the action. Check both an empty list and a populated one to see whether AI applied the rule in the right place.

2.7 Name the tools AI can use

Apple puts the expected behavior and links to the standard components together. The reader gets a route from the design rule to its implementation. For an AI agent, a named component and an exact reference can reduce the choices it has to make and the details it might otherwise guess.

Your guide might say: “Use buttons from our component library, with its existing sizes and colors. If none fits, explain what is missing before proposing a new one.” This gives AI a starting point and a clear next step when that starting point is not enough.

2.8 Define how far each instruction reaches

Apple defines the job of an arrangement view, then says where navigation belongs. That boundary matters: a reader can see which part should handle each responsibility. In instructions for AI, this helps keep a request to change one part from spreading into nearby behavior.

For example: “Adjust the card layout. Keep its link destinations and button actions unchanged.” The first sentence names the work; the second sets its limits. The result is easier to review because everyone knows what the change was meant to cover.

2.9 Make the default and its exceptions easy to find

Apple introduces the usual position of the controls and gives an exception alongside it. It then explains cases such as two apps sharing the screen. This order gives readers a starting rule and a way to decide when it changes. It also makes exceptions easier to find when AI consults just this part of the guide.

For a form, write: “Place the label above the field by default. Put checkbox labels beside the checkbox.” Keep both sentences together, then ask AI to check one example of each. That makes a broad instruction less likely to be applied to the wrong case.

2.10 Say which requirement wins when they compete

Keeping every control visible becomes impossible when space runs out. Apple gives an order of importance and lets that order be refined for groups and individual items. The useful writing choice is to explain how to make a trade-off before the reader has to make one.

A short summary needs the same kind of rule: “Keep decisions, owners and deadlines. Shorten background discussion first.” Now AI has a basis for cutting the text, and you can judge the result against an agreed order instead of deciding after each rewrite.

2.11 Turn a broad goal into something you can check

Apple follows its advice about control placement with a reason and a Mail example. The example shows how a control’s position tells people what it affects. This connects the rule to a visible result, so readers have more to work with than a general request for a clear interface.

Use that structure in your own design guide: “Put each error message beside the field that needs fixing, so people know where to act.” You have named the action, its purpose and a visible check. AI can use those details while making the page and reviewing its work.

2.12 Give a fallback and a reason to choose it

Apple explains what to preserve when space runs short by asking whether the screen is mainly for browsing or completing a task. It also points to one shared place for the remaining actions. The instruction covers both the choice and what happens to anything that no longer fits.

A report guide could say: “If the summary exceeds one page, keep the decisions in the main text and move supporting detail to an appendix.” AI has a clear fallback, and the detail still has a home. Add what to flag for you if the limit cannot be met without losing something essential.

2.13 Use examples and references to resolve uncertainty

A diagram can make a spatial relationship clearer than another paragraph. A precise reference lets readers check an implementation detail without making the main rule longer. Apple uses both. For an AI guide, the useful lesson is to give each supporting item a job: show the intended result or answer a specific question.

Attach a sample screen with a note about what to notice, or link to the exact component the task should use. Keep the key requirement in text too, and check whether the AI tool can open the image or link. An attachment only helps if the tool can actually use it.

View Apple’s illustrations

The references Apple includes

These are the supporting links in the Markdown file. The developer names are kept as written so an AI coding tool can find the right reference.

Developer references (15)

2.14 Make the rules easy to review later

Apple’s change log and source footer give the guidance a date and an owner. These details serve a different purpose from the design rules: they help readers trace where the advice came from and whether it may need another look. Reusable AI instructions need that history as the product changes.

Record what changed, when it changed and where the decision came from. “14 September: error messages now appear beside fields; see the approved form example” is more useful than a date alone. It helps you and AI identify the rule to update when the design changes again.

Checked against the Markdown file supplied for this draft on 14 September 2026.

3. Three ways to put this into practice

Here are three everyday tasks where the same approach can help. Each starts with a short passage from Apple’s guide.

3.1 Explain what a good result looks like

An app may move between the phone’s outer and inner displays. Apple wants its layout to fit the space available.

This gives the designer something clear to work on: make the app fit when the space changes. We can be just as specific with AI.

“Write a good summary” leaves a lot for AI to guess. Perhaps you want a quick overview. Perhaps you need to know what was decided and what happens next. Say which one you need.

You might askSummarize this meeting.

Try asking thisSummarize what we decided, then list the next steps. For each task, say who will do it and when it is due. If we didn’t agree on a person or a date, write “not decided” instead of guessing.

Now you have something useful to check. Read the summary beside the meeting notes: did AI leave out a task, or add a deadline nobody agreed to?

3.2 Say what needs to stay the same

Apple says an app’s features and the work in progress should stay the same when someone switches displays, even if the layout changes.

The same idea helps when AI rewrites or translates something. The words may change, but the meaning should stay the same.

Imagine a product announcement that says a feature is coming soon. If the translation says people can use it today, it has changed what you promised. Smooth writing can make that mistake easy to miss.

You might askTranslate this announcement.

Try asking thisGive me English, Simplified Chinese for Singapore, Traditional Chinese for Hong Kong, Japanese, and Korean versions of this announcement. Write naturally in each language. Keep the names, numbers, dates, and links the same. Make sure “coming soon” still means coming soon. Point out anything you are unsure how to translate.

Check the details in each version, especially what is available now and what is still planned. For wording you cannot judge yourself, ask someone who knows the language.

3.3 Be clear about how much to change

When folding affects space near the hinge, Apple recommends small layout adjustments to make room for buttons and other controls.

This is a useful habit when editing with AI, too. Tell it which part needs work.

Suppose your email promises a reply within three working days. You want it to sound friendlier. If AI changes that to “tomorrow,” the email may sound more helpful, but you have promised something different.

You might askMake this email better.

Try asking thisMake this email friendlier and easier to read. Keep the facts, prices, and promises the same. If you think one of those details should change, leave a note for me instead of changing it in the email.

Read the two versions side by side. Does the new one sound better while still saying what you meant?

4. How does this relate to a Skill or a Mind?

Once an instruction works well, save it. A note called “How we translate announcements” could hold the languages you need, a few good examples, and reminders about mistakes you have already fixed.

A Skill is a way to give an AI tool instructions for a particular job. It can also include examples or files the tool needs. In a tool that supports Skills, your translation note could become part of a translation Skill.

OneMind uses the word Mind for the knowledge, rules, skills, and experience you want AI to work with. That can include how your team likes to write and why certain details matter. For example: “Keep our delivery dates as written, because customers plan around them.”

Apple’s guide is a source you could use when creating a Skill for app design. You would still need to explain when the AI should use it and what to check.

Reading a longer guide also uses tokens. Keep the full reference available, then ask AI to find the parts needed for the task and check for relevant exceptions. Judge savings by the whole job, including reading, corrections and retries.

5. One more thing

Now you can use OneMind to bring Apple’s iPhone Duo design guidelines into your team’s daily work, giving teammates and AI agents a shared set of rules.

For your iPhone Duo project, put a link to Apple’s original guide in a shared Mind.

For example, your designer, developer and AI reviewer could all work from one rule: “Keep entered text and the selected item when the layout changes.” The designer plans for it, the developer implements it, and the reviewer checks it. Each has a different job, with the same expectation for the result.

When you find a useful correction, add it to the Mind for review. Once approved, include it in the guidance for future work and check whether the next task gets it right. That’s how one lesson can help the whole team spend less time repeating corrections.

This is independent commentary by OneMind. It is not sponsored or endorsed by Apple. Quoted material © Apple Inc. Apple and iPhone are trademarks of Apple Inc.