From a017e4fad0f1a50406dbe2090b6a22deeddf15f2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 10 Apr 2026 22:22:51 +0000 Subject: [PATCH 1/2] Clarify annotations as implementation notes for AI agent handoff Generated-By: mintlify-agent --- packages/docs/learn/prototype-mode/annotations.mdx | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/packages/docs/learn/prototype-mode/annotations.mdx b/packages/docs/learn/prototype-mode/annotations.mdx index fc4eae2b..8abab139 100644 --- a/packages/docs/learn/prototype-mode/annotations.mdx +++ b/packages/docs/learn/prototype-mode/annotations.mdx @@ -1,6 +1,6 @@ --- title: Annotations -description: Add implementation notes to guide AI prototype generation. +description: Add implementation notes to guide AI prototype generation and code handoff. --- @@ -20,8 +20,14 @@ You should see blue dots on elements for each annotation. ## Exporting to code -Annotations are also useful for documenting your design for handoff. Any annotation will be exported as comments in code: +Annotations double as implementation notes for design-to-code handoff. When you export a page, annotations are included as code comments — so any context you leave during design time carries over automatically. Annotation persisted as code comment + +### Using annotations with AI agents + +When an AI coding assistant like Claude Code, Cursor, or Codex fetches your design via the [MCP server](/guides/mcp-server), it reads your annotations as part of the exported code. This means you can leave implementation notes while designing — describing desired behaviors, edge cases, or business logic — and your AI agent will pick them up and act on them during implementation. + +Use annotations to capture implementation details as you design, so nothing gets lost during handoff. For example, annotate a button with "Submit form and redirect to /dashboard on success" or a list with "Fetch from /api/items, show skeleton loader while loading." From a3b01cb639961b35ac0951e5b3aab6af0ebf4b73 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 13 Apr 2026 01:53:56 +0000 Subject: [PATCH 2/2] Replace Tip with Note to match docs conventions Generated-By: mintlify-agent --- packages/docs/learn/prototype-mode/annotations.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/docs/learn/prototype-mode/annotations.mdx b/packages/docs/learn/prototype-mode/annotations.mdx index 8abab139..913d4de2 100644 --- a/packages/docs/learn/prototype-mode/annotations.mdx +++ b/packages/docs/learn/prototype-mode/annotations.mdx @@ -30,4 +30,4 @@ Annotations double as implementation notes for design-to-code handoff. When you When an AI coding assistant like Claude Code, Cursor, or Codex fetches your design via the [MCP server](/guides/mcp-server), it reads your annotations as part of the exported code. This means you can leave implementation notes while designing — describing desired behaviors, edge cases, or business logic — and your AI agent will pick them up and act on them during implementation. -Use annotations to capture implementation details as you design, so nothing gets lost during handoff. For example, annotate a button with "Submit form and redirect to /dashboard on success" or a list with "Fetch from /api/items, show skeleton loader while loading." +Use annotations to capture implementation details as you design, so nothing gets lost during handoff. For example, annotate a button with "Submit form and redirect to /dashboard on success" or a list with "Fetch from /api/items, show skeleton loader while loading."